//
//  TTInstallIDManager.h
//  Article
//
//  Created by fengyadong on 17-3-14.
//
//

#import <Foundation/Foundation.h>

/** 设备注册完成回调 */
typedef void(^TTInstallDidRegisterBlock)(NSString *deviceID, NSString *installID, NSString *ssID);

/** 自定义Header中的扩展字段，在header中独立的custom结构中 */
typedef NSDictionary<NSString*, id> *(^TTCustomHeaderBlock)(void);

@interface TTInstallIDManager : NSObject

@property (nonatomic, copy, readonly) NSString *appID;/** app的唯一标示，由头条数据仓库团队统一分配 */
@property (nonatomic, copy, readonly) NSString *channel;/** 渠道名称 */
@property (nonatomic, copy, readonly) NSString *deviceID;/** 设备id */
@property (nonatomic, copy, readonly) NSString *installID;/** 安装id */
@property (nonatomic, copy, readonly) NSString *appName;
@property (nonatomic, copy, readonly) NSString *ssID;/** 用户id，串联匿名和登录用户 */
@property (nonatomic, copy, readonly) NSString *userUniqueID;/** 正在注册ssid的user_unique_id */

@property (nonatomic, copy) TTCustomHeaderBlock customHeaderBlock;/** 使用方自定义Header参数 */

+ (instancetype)sharedInstance;


/**
 是否开启激活设备开关

 @param enable YES:开启 NO:关闭 default:YES
 
 warning ⚠️：如果要关掉激活设备开关此方法必须在 -startWithAppID:channel:appName:finishBlock前调用
 */
+ (void)setActivateDeviceEnable:(BOOL)enable;

//=============================================初始化方法==================================================
/**
 开始调用服务端设备注册接口

 @param appID 当前app的唯一标示，由头条数据仓库团队统一分配
 @param channel 渠道名称，建议正式版App Store 内测版local_test 灰度版用发布的渠道名，如pp
 @param appName 由数据方指定的APP name
 @param didRegisterBlock 设备注册接口完成回调，最多回调一次，没有超时时间。如果已经注册则立马回调，如果还没有则等接口请求解析完成回调。对device_id有依赖的接口可以在这里发送
 */
- (void)startWithAppID:(NSString *)appID
               channel:(NSString *)channel
               appName:(NSString *)appName
           finishBlock:(TTInstallDidRegisterBlock)didRegisterBlock;

//===========================================注册完成回调方法================================================
/**
 设备注册完成的回调

 @param didRegisterBlock 设备注册接口完成回调，最多回调一次，没有超时时间。如果已经注册则立马回调，如果还没有则等接口请求解析完成回调。对device_id有依赖的接口可以在这里发送
 */
- (void)setDidRegisterBlock:(TTInstallDidRegisterBlock)didRegisterBlock;

//=========================================== Debug模式配置 ================================================
/**
 设置当前环境是否为内测版本
 
 @param isInHouseVersion 是否为内测版本
 */
- (void)setIsInHouseVersion:(BOOL)isInHouseVersion;

//=========================================== User-Profile ================================================

/**
 用户登录状态发生变更的时候需要调用此接口，传入当前的用户的user_unique_id

 @param uniqueID 用户当前的user_unique_id
 */
- (void)setCurrentUserUniqueID:(NSString *)uniqueID;

/**
 用户登录状态发生变更的时候需要调用此接口，传入当前的用户的user_unique_id,并且关心SSID重新获取的时机

 @param uniqueID 用户当前的user_unique_id
 @param didRetriveBlock 重新获取SSID的回调
 */
- (void)setCurrentUserUniqueID:(NSString *)uniqueID
           didRetriveSSIDBlock:(TTInstallDidRegisterBlock)didRetriveBlock;

@end