IOS SDK API 接口

/**
    加密方式
**/
typedef enum {
    HttpDnsEncryptTypeDES = 0, // DES 加密
    HttpDnsEncryptTypeAES = 1, // AES 加密
    HttpDnsEncryptTypeHTTPS = 2 // HTTPS 加密
} HttpDnsEncryptType;

/**
     IP地址类型
**/
typedef enum {
    HttpDnsAddressTypeAuto = 0, // sdk自动检测
    HttpDnsAddressTypeIPv4 = 1, // 只支持ipv4
    HttpDnsAddressTypeIPv6 = 2, // 只支持ipv6
    HttpDnsAddressTypeDual = 3, // 支持双协议栈
} HttpDnsAddressType;

/**
    配置结构体
    以下鉴权信息可在腾讯云控制台（https://console.cloud.tencent.com/httpdns/configure）开通服务后获取
**/
typedef struct DnsConfigStruct {
    NSString* appId; // 可选，应用ID，腾讯云控制台申请获得，用于数据上报
    int dnsId; // 授权ID，腾讯云控制台申请后可直接在控制台查看
    NSString* dnsKey; // 加密密钥，加密方式为 AES、DES 时必传。腾讯云控制台申请后可直接在控制台查看，用于域名解析鉴权
    NSString* token; // 加密 token，加密方式为 HTTPS 时必传
    NSString* dnsIp; //【v1.8.0及以上SDK内部调度，无需设置】HTTPDNS 服务器 IP。HTTP 协议服务地址为 `119.29.29.98`，HTTPS 协议服务地址为 `119.29.29.99`
    BOOL debug; // 是否开启Debug日志，YES：开启，NO：关闭。建议联调阶段开启，正式上线前关闭
    int timeout; // 可选，超时时间，单位ms，如设置0，则使用默认值2000ms
    HttpDnsEncryptType encryptType; // 控制加密方式
    HttpDnsAddressType addressType; // 指定返回的ip地址类型，默认为 HttpDnsAddressTypeAuto sdk自动检测
    NSString* routeIp; // 可选，DNS 请求的 ECS（EDNS-Client-Subnet）值，默认情况下 HTTPDNS 服务器会查询客户端出口 IP 为 DNS 线路查询 IP，可以指定线路 IP 地址。支持 IPv4/IPv6 地址传入
    BOOL httpOnly;// 可选，是否仅返回 httpDns 解析结果。默认 false，即当 httpDns 解析失败时会返回 LocalDNS 解析结果，设置为 true 时，仅返回 httpDns 的解析结果
    NSUInteger retryTimesBeforeSwitchServer; // 可选，切换ip之前重试次数, 默认3次
    NSUInteger minutesBeforeSwitchToMain; // 可选，设置切回主ip间隔时长，默认10分钟
    BOOL enableReport; //【V1.7.0 废弃】sdk日志上报能力现在由控制台控制
} DnsConfig;

/**
 设置业务基本信息（腾讯云业务使用）

 @param config 业务配置结构体
 @return YES:设置成功 NO:设置失败
 */
- (BOOL) initConfig:(DnsConfig *)config;

/**
 * 通过 Dictionary 配置，字段参考 DnsConfig 结构，用于兼容 swift 项目，解决 swift 项目中无法识别 DnsConfig 类型的问题
 *
 * @param config  配置
 * @return YES：设置成功 NO：设置失败
 */
- (BOOL) initConfigWithDictionary:(NSDictionary *)config;

/**
 * 预解析域名。建议不要设置太多预解析域名，当前限制为最多 8 个域名。仅在初始化时触发。
 * 示例代码：[[MSDKDns sharedInstance] WGSetPreResolvedDomains:@[@"dnspod.com", @"dnspod.cn"]];
 * @param domains  域名数组
 */
- (void) WGSetPreResolvedDomains:(NSArray *)domains;

/**
 * 解析缓存自动刷新, 以数组形式进行配置。当前限制为最多 8 个域名。
 * 示例代码：[[MSDKDns sharedInstance] WGSetKeepAliveDomains:@[@"dnspod.com", @"dnspod.cn"]];
 * @param domains  域名数组
 */
- (void) WGSetKeepAliveDomains:(NSArray *)domains;


/**
 * 启用IP优选，设置域名对应的端口号，对域名解析返回的IP列表进行IP探测，对返回的列表进行动态排序，以保证第一个IP是可用性最好的IP
 */
- (void) WGSetIPRankData:(NSDictionary *)IPRankData;

/**
 * 设置是否允许返回TTL过期域名的IP，默认关闭
 * 设置为true时，会直接返回缓存的解析结果，没有缓存则返回0。且在无缓存结果或缓存已过期时，会异步发起解析请求更新缓存。因异步接口逻辑在回调中始终返回未过期的解析结果，设置为true时，异步API不可使用。建议使用同步接口。
 */
- (void) WGSetExpiredIPEnabled:(BOOL)enable;

/**
 * 设置是否启用本地持久化缓存功能，默认关闭
 */
- (void) WGSetPersistCacheIPEnabled:(BOOL)enable;


/**
 * 需要清除的host域名数组（如@[@"www.qq.com"）。如果需要清空全部数据，传nil或者空数组即可
 */
- (void)clearHostCache:(NSArray *)hostArray;


/**
 域名同步解析（通用接口）
 @param domain 域名 
 @return 查询到的 IP 数组，超时（1s）或者未查询到返回[0,0]数组
*/
- (NSArray *) WGGetHostByName:(NSString *) domain;

/**
 域名批量同步解析（通用接口）
 @param domains 域名数组
 @return 查询到的 IP 字典
 */
- (NSDictionary *) WGGetHostsByNames:(NSArray *) domains;

// 单个域名查询
NSArray *ipsArray = [[MSDKDns sharedInstance] WGGetHostByName: @"qq.com"];
if (ipsArray && ipsArray.count > 1) {
    NSString *ipv4 = ipsArray[0];
    NSString *ipv6 = ipsArray[1];
    if (![ipv6 isEqualToString:@"0"]) {
        //TODO 使用 IPv6 地址进行 URL 连接时，注意格式，IPv6 需加方框号[]进行处理，例如：http://[64:ff9b::b6fe:7475]/
    } else if (![ipv4 isEqualToString:@"0"]){
        //使用 IPv4 地址进行连接
    } else {
        //异常情况返回为0,0，建议重试一次
    }
}

// 批量域名查询
NSDictionary *ipsDict = [[MSDKDns sharedInstance] WGGetHostsByNames: @[@"qq.com", @"dnspod.cn"]];
NSArray *ips = [ipsDict objectForKey: @"qq.com"];
if (ips && ips.count > 1) {
    NSString *ipv4 = ips[0];
    NSString *ipv6 = ips[1];
    if (![ipv6 isEqualToString:@"0"]) {
        //TODO 使用 IPv6 地址进行 URL 连接时，注意格式，IPv6 需加方框号[]进行处理，例如：http://[64:ff9b::b6fe:7475]/
    } else if (![ipv4 isEqualToString:@"0"]){
        //使用 IPv4 地址进行连接
    } else {
        //异常情况返回为0,0，建议重试一次
    }
}

/**
 域名异步解析（通用接口）
 @param domain  域名
 @param handler 返回查询到的 IP 数组，超时（1s）或者未查询到返回[0,0]数组
 */
 - (void) WGGetHostByNameAsync:(NSString *) domain returnIps:(void (^)(NSArray *ipsArray))handler;

 /**
 域名批量异步解析（通用接口）

 @param domains  域名数组
 @param handler 返回查询到的IP字典，超时（1s）或者未查询到返回 {"queryDomain" : [0, 0] ...}
 */
- (void) WGGetHostsByNamesAsync:(NSArray *) domains returnIps:(void (^)(NSDictionary * ipsDictionary))handler;