iOS 网络探测插件使用说明

// 1. 配置日志上报
ClsLogSenderConfig *config = [ClsLogSenderConfig configWithEndpoint:@"ap-guangzhou-open.cls.tencentcs.com"
                                                     accessKeyId:@"YOUR_ACCESS_KEY_ID"
                                                       accessKey:@"YOUR_ACCESS_KEY"];

// 2. 初始化网络诊断（使用 netToken）
NSString *netToken = @"YOUR_NET_TOKEN";  // Base64 编码的 JSON，包含 networkAppId/appKey/topic_id
[[ClsNetworkDiagnosis sharedInstance] setupLogSenderWithConfig:config 
                                                      netToken:netToken];

// 3. 设置全局扩展字段（可选）
[[ClsNetworkDiagnosis sharedInstance] setUserEx:@{
    @"scene": @"homepage"
}];

// 创建请求
CLSHttpRequest *request = [[CLSHttpRequest alloc] init];
request.domain = @"https://cloud.tencent.com";  // 完整 URL
request.appKey = @"YOUR_APP_KEY";
request.maxTimes = 3;  // 探测 3 次
request.timeout = 10000;  // 超时 10 秒

// 执行探测
[[ClsNetworkDiagnosis sharedInstance] httpingv2:request complate:^(CLSResponse *response) {
    if (response.success) {
        NSLog(@"HTTP Ping 成功");
        NSLog(@"结果: %@", response.content);  // JSON 格式
        
        // 解析结果
        NSDictionary *data = response.data;
        NSDictionary *netOrigin = data[@"netOrigin"];
        
        NSNumber *dnsTime = netOrigin[@"dns_time"];  // DNS 耗时（毫秒）
        NSNumber *tcpConnectTime = netOrigin[@"tcp_connect_time"];  // TCP 连接耗时
        NSNumber *sslHandshakeTime = netOrigin[@"ssl_handshake_time"];  // SSL 握手耗时
        NSNumber *totalTime = netOrigin[@"total_time"];  // 总耗时
        
        NSLog(@"DNS: %@ms, TCP: %@ms, SSL: %@ms, 总计: %@ms", 
              dnsTime, tcpConnectTime, sslHandshakeTime, totalTime);
    } else {
        NSLog(@"HTTP Ping 失败: %@", response.errorMessage);
    }
}];

CLSHttpRequest *request = [[CLSHttpRequest alloc] init];
request.domain = @"https://api.example.com/health";
request.appKey = @"YOUR_APP_KEY";
request.maxTimes = 5;
request.timeout = 15000;

// 多网卡探测（WiFi + 蜂窝网络并发）
request.enableMultiplePortsDetect = YES;

// 扩展字段（自定义业务标识）
request.detectEx = @{
    @"api_name": @"/health",
    @"request_id": @"req_12345"
};

// 页面名称（用于分组统计）
request.pageName = @"HomePage";

// 追踪 ID（关联多个探测）
request.traceId = [[NSUUID UUID] UUIDString];

// SSL 证书验证（默认开启）
request.enableSSLVerification = YES;

[[ClsNetworkDiagnosis sharedInstance] httpingv2:request complate:^(CLSResponse *response) {
    // 处理结果
}];

// 创建请求
CLSTcpRequest *request = [[CLSTcpRequest alloc] init];
request.domain = @"cloud.tencent.com";
request.appKey = @"YOUR_APP_KEY";
request.port = 443;  // HTTPS 端口
request.maxTimes = 10;  // 探测 10 次
request.timeout = 5000;  // 超时 5 秒

// 执行探测
[[ClsNetworkDiagnosis sharedInstance] tcpPingv2:request complate:^(CLSResponse *response) {
    if (response.success) {
        NSDictionary *data = response.data;
        NSDictionary *netOrigin = data[@"netOrigin"];
        
        NSNumber *latencyMin = netOrigin[@"latency_min"];  // 最小延迟（毫秒）
        NSNumber *latencyMax = netOrigin[@"latency_max"];  // 最大延迟
        NSNumber *latencyAvg = netOrigin[@"latency_avg"];  // 平均延迟
        NSNumber *successCount = netOrigin[@"success_count"];  // 成功次数
        NSNumber *failureCount = netOrigin[@"failure_count"];  // 失败次数
        
        NSLog(@"TCP Ping 统计: 最小=%@ms, 平均=%@ms, 最大=%@ms, 成功=%@, 失败=%@", 
              latencyMin, latencyAvg, latencyMax, successCount, failureCount);
    } else {
        NSLog(@"TCP Ping 失败: %@", response.errorMessage);
    }
}];

// 创建请求
CLSPingRequest *request = [[CLSPingRequest alloc] init];
request.domain = @"cloud.tencent.com";
request.appKey = @"YOUR_APP_KEY";
request.maxTimes = 10;  // Ping 10 次
request.size = 64;  // 包大小 64 字节
request.interval = 200;  // 间隔 200ms
request.timeout = 10000;  // 超时 10 秒

// 执行探测
[[ClsNetworkDiagnosis sharedInstance] pingv2:request complate:^(CLSResponse *response) {
    if (response.success) {
        NSDictionary *data = response.data;
        NSDictionary *netOrigin = data[@"netOrigin"];
        
        NSNumber *latencyMin = netOrigin[@"latency_min"];  // 最小延迟（毫秒）
        NSNumber *latencyMax = netOrigin[@"latency_max"];  // 最大延迟
        NSNumber *latencyAvg = netOrigin[@"latency_avg"];  // 平均延迟
        NSNumber *latencyStddev = netOrigin[@"latency_stddev"];  // 标准差
        NSNumber *lossRate = netOrigin[@"loss_rate"];  // 丢包率（百分比）
        
        NSLog(@"Ping 统计: 延迟=%@/%@/%@ms, 抖动=%@ms, 丢包率=%@%%", 
              latencyMin, latencyAvg, latencyMax, latencyStddev, lossRate);
    } else {
        NSLog(@"Ping 失败: %@", response.errorMessage);
    }
}];

CLSPingRequest *request = [[CLSPingRequest alloc] init];
request.domain = @"www.qq.com";
request.appKey = @"YOUR_APP_KEY";
request.maxTimes = 5;

// 设置 IP 协议偏好
request.prefer = -1;  // -1: 自动检测（默认）
                      //  0: IPv4 优先
                      //  1: IPv6 优先
                      //  2: 仅 IPv4
                      //  3: 仅 IPv6

[[ClsNetworkDiagnosis sharedInstance] pingv2:request complate:^(CLSResponse *response) {
    if (response.success) {
        NSDictionary *netOrigin = response.data[@"netOrigin"];
        NSString *hostIp = netOrigin[@"host_ip"];  // 实际使用的 IP 地址
        NSLog(@"使用 IP: %@", hostIp);
    }
}];

// 创建请求
CLSDnsRequest *request = [[CLSDnsRequest alloc] init];
request.domain = @"cloud.tencent.com";
request.appKey = @"YOUR_APP_KEY";
request.timeout = 5000;  // 超时 5 秒

// 执行解析
[[ClsNetworkDiagnosis sharedInstance] dns:request complate:^(CLSResponse *response) {
    if (response.success) {
        NSDictionary *data = response.data;
        NSDictionary *netOrigin = data[@"netOrigin"];
        
        // 解析结果（JSON 数组）
        NSString *answerSection = netOrigin[@"answer_section"];
        NSLog(@"DNS 解析结果: %@", answerSection);
        
        /*
        示例输出：
        [
            {"name":"cloud.tencent.com","type":"A","ttl":300,"data":"203.205.158.53"},
            {"name":"cloud.tencent.com","type":"AAAA","ttl":300,"data":"2408:871a:2100:15::53"}
        ]
        */
    } else {
        NSLog(@"DNS 解析失败: %@", response.errorMessage);
    }
}];

CLSDnsRequest *request = [[CLSDnsRequest alloc] init];
request.domain = @"cloud.tencent.com";
request.appKey = @"YOUR_APP_KEY";

// 使用公共 DNS 服务器
request.nameServer = @"8.8.8.8";  // Google DNS
// request.nameServer = @"1.1.1.1";  // Cloudflare DNS
// request.nameServer = @"119.29.29.29";  // DNSPod DNS

// IP 协议偏好
request.prefer = 0;  // 0: A 记录优先, 1: AAAA 记录优先

[[ClsNetworkDiagnosis sharedInstance] dns:request complate:^(CLSResponse *response) {
    // 处理结果
}];

// 创建请求
CLSMtrRequest *request = [[CLSMtrRequest alloc] init];
request.domain = @"cloud.tencent.com";
request.appKey = @"YOUR_APP_KEY";
request.maxTTL = 30;  // 最大跳数 30
request.protocol = @"icmp";  // 协议：icmp / udp
request.timeout = 60000;  // 超时 60 秒（路由跟踪耗时长）

// 执行探测
[[ClsNetworkDiagnosis sharedInstance] mtr:request complate:^(CLSResponse *response) {
    if (response.success) {
        NSDictionary *data = response.data;
        NSDictionary *netOrigin = data[@"netOrigin"];
        
        // 路径信息（JSON 数组）
        NSString *pathDetail = netOrigin[@"path_detail"];
        NSLog(@"路由路径: %@", pathDetail);
        
        /*
        示例输出：
        [
            {"hop":1,"ip":"192.168.1.1","latency":2.5,"latency_min":2.0,"latency_max":3.0,"loss":0,"responseNum":3},
            {"hop":2,"ip":"10.0.0.1","latency":10.2,"latency_min":8.5,"latency_max":12.0,"loss":0,"responseNum":3},
            {"hop":3,"ip":"203.205.158.1","latency":25.8,"latency_min":24.0,"latency_max":28.0,"loss":10,"responseNum":2},
            ...
        ]
        */
    } else {
        NSLog(@"❌ MTR 失败: %@", response.errorMessage);
    }
}];

// 示例 1: 强制使用 IPv4（适用于纯 IPv4 环境）
CLSPingRequest *request = [[CLSPingRequest alloc] init];
request.domain = @"www.qq.com";
request.appKey = @"YOUR_APP_KEY";
request.prefer = 2;  // IPv4 only

[[ClsNetworkDiagnosis sharedInstance] pingv2:request complate:^(CLSResponse *response) {
    // 只会 Ping IPv4 地址：203.205.158.53
}];

// 示例 2: 仅查询 IPv6 DNS 记录
CLSDnsRequest *request = [[CLSDnsRequest alloc] init];
request.domain = @"www.qq.com";
request.appKey = @"YOUR_APP_KEY";
request.prefer = 3;  // IPv6 only - 仅返回 AAAA 记录

[[ClsNetworkDiagnosis sharedInstance] dns:request complate:^(CLSResponse *response) {
    // ANSWER-SECTION: [{"type": "AAAA", "data": "2408:871a:2100:15::53"}]
}];

// 示例 3: IPv6 优先（双栈环境）
CLSMtrRequest *request = [[CLSMtrRequest alloc] init];
request.domain = @"cloud.tencent.com";
request.appKey = @"YOUR_APP_KEY";
request.prefer = 1;  // IPv6 优先
request.protocol = @"icmp";

[[ClsNetworkDiagnosis sharedInstance] mtr:request complate:^(CLSResponse *response) {
    // 优先追踪 IPv6 路径，失败时自动降级到 IPv4
}];