Unity 网络探测插件使用说明

Assets/
└── Plugins/
    └── Unity_CLS/
        ├── Unity_CLS.cs              # C# 统一接口层
        ├── Android/
        │   └── libs/
        │       ├── all-dependencies-1.0.0-shaded.jar #安卓所需java依赖
        │       ├── network-diagnosis-release.aar  #网络探测依赖
        │       ├── producer-release.aar #日志上报依赖
        │       └── unity-release.aar #unity交互依赖
        ├── Windows/
        │   └── cls_network_detect.dll #windows网络探测+日志上报动态库
        └── iOS/
            ├── UnityApi.h #与ios交互的桥接代码
            ├── UnityApi.m
            ├── TencentCloudLogProducer.framework #cls ios sdk包
            ├── FMDB.framework #cls ios sdk所需的依赖
            ├── Protobuf.framework
            └── Reachability.framework

using System.Collections.Generic;
using UnityEngine;
using TencentCloudCLS;

public class NetworkDiagnosisDemo : MonoBehaviour
{
    void Start()
    {
        // 1. 初始化 SDK
        Credential credential = new Credential();
        credential.endpoint = "ap-guangzhou.cls.tencentcs.com";
        credential.secretId = "您的 SecretId";
        credential.secretKey = "您的 SecretKey";
        credential.geoToken = "您的 GeoToken";
        
        Unity_CLS.Initialize(credential);
        
        // 2. 设置用户自定义扩展字段（可选）
        Dictionary<string, string> userCustomField = new Dictionary<string, string>();
        userCustomField.Add("app_version", "1.0.0");
        userCustomField.Add("user_id", "12345");
        Unity_CLS.SetUserCustom(userCustomField);
        
        // 3. 执行 TCP Ping 探测
        TcpPingRequest tcpRequest = new TcpPingRequest();
        tcpRequest.target = "www.baidu.com";
        tcpRequest.port = 80;
        tcpRequest.callback = (response) =>
        {
            Debug.Log("TCP Ping 结果: " + response);
        };
        Unity_CLS.TcpPing(tcpRequest);
    }
}

Unity_CLS.Initialize(Credential credential)

Credential credential = new Credential();
credential.endpoint = "ap-guangzhou.cls.tencentcs.com";
credential.secretId = "您的 SecretId";
credential.secretKey = "您的 SecretKey";
credential.geoToken = "您的 GeoToken";

Unity_CLS.Initialize(credential);

Unity_CLS.SetUserCustom(Dictionary<string, string> userCustomField)

Dictionary<string, string> userCustomField = new Dictionary<string, string>();
userCustomField.Add("app_version", "1.0.0");
userCustomField.Add("user_id", "12345");
userCustomField.Add("channel", "official");

Unity_CLS.SetUserCustom(userCustomField);

Unity_CLS.TcpPing(TcpPingRequest request)

TcpPingRequest request = new TcpPingRequest();
request.target = "www.baidu.com";
request.port = 80;
request.count = 3;
request.timeout = 2000;
request.detectCustomField = new Dictionary<string, string>()
{
    { "scene", "login_page" }
};
request.callback = (response) =>
{
    Debug.Log("TCP Ping 结果: " + response);
};

Unity_CLS.TcpPing(request);

Unity_CLS.Ping(PingRequest request)

PingRequest request = new PingRequest();
request.target = "www.baidu.com";
request.count = 5;
request.timeout = 3000;
request.callback = (response) =>
{
    Debug.Log("Ping 结果: " + response);
};

Unity_CLS.Ping(request);

Unity_CLS.Http(HttpRequest request)

HttpRequest request = new HttpRequest();
request.url = "https://www.baidu.com";
request.timeout = 5000;
request.callback = (response) =>
{
    Debug.Log("HTTP 探测结果: " + response);
};

Unity_CLS.Http(request);

Unity_CLS.Dns(DnsRequest request)

DnsRequest request = new DnsRequest();
request.domain = "www.baidu.com";
request.servers = "8.8.8.8";
request.callback = (response) =>
{
    Debug.Log("DNS 解析结果: " + response);
};

Unity_CLS.Dns(request);

Unity_CLS.Mtr(MtrRequest request)

MtrRequest request = new MtrRequest();
request.target = "www.baidu.com";
request.maxTtl = 30;
request.times = 5;
request.protocol = "icmp";
request.callback = (response) =>
{
    Debug.Log("MTR 结果: " + response);
};

Unity_CLS.Mtr(request);

using System;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;
using TencentCloudCLS;

public class NetworkDiagnosisManager : MonoBehaviour
{
    void Start()
    {
        Debug.Log("[NetworkDiagnosis] 开始初始化...");
    }

    /// <summary>
    /// 初始化 SDK（需在所有探测操作前调用）
    /// </summary>
    public void Init()
    {
        Credential credential = new Credential();
        credential.endpoint = "ap-guangzhou.cls.tencentcs.com";
        credential.secretId = "您的 SecretId";
        credential.secretKey = "您的 SecretKey";
        credential.geoToken = "您的 GeoToken";

        Unity_CLS.Initialize(credential);

        // 设置用户自定义扩展字段
        Dictionary<string, string> userCustomField = new Dictionary<string, string>();
        userCustomField.Add("app_version", "1.0.0");
        userCustomField.Add("scene", "main_menu");
        Unity_CLS.SetUserCustom(userCustomField);

        Debug.Log("[NetworkDiagnosis] 初始化完成");
    }

    /// <summary>
    /// 执行 TCP Ping 探测
    /// </summary>
    public void DoTcpPing()
    {
        TcpPingRequest request = new TcpPingRequest();
        request.target = "www.baidu.com";
        request.port = 80;
        request.count = 3;
        request.detectCustomField = new Dictionary<string, string>()
        {
            { "test_type", "tcp_ping" }
        };
        request.callback = (response) =>
        {
            Debug.Log("[TCP Ping] 结果: " + response);
        };
        Unity_CLS.TcpPing(request);
    }

    /// <summary>
    /// 执行 ICMP Ping 探测
    /// </summary>
    public void DoPing()
    {
        PingRequest request = new PingRequest();
        request.target = "www.baidu.com";
        request.count = 5;
        request.detectCustomField = new Dictionary<string, string>()
        {
            { "test_type", "icmp_ping" }
        };
        request.callback = (response) =>
        {
            Debug.Log("[Ping] 结果: " + response);
        };
        Unity_CLS.Ping(request);
    }

    /// <summary>
    /// 执行 HTTP 探测
    /// </summary>
    public void DoHttp()
    {
        HttpRequest request = new HttpRequest();
        request.url = "http://www.baidu.com";
        request.timeout = 5000;
        request.detectCustomField = new Dictionary<string, string>()
        {
            { "test_type", "http" }
        };
        request.callback = (response) =>
        {
            Debug.Log("[HTTP] 结果: " + response);
        };
        Unity_CLS.Http(request);
    }

    /// <summary>
    /// 执行 DNS 解析探测
    /// </summary>
    public void DoDns()
    {
        DnsRequest request = new DnsRequest();
        request.domain = "www.baidu.com";
        request.detectCustomField = new Dictionary<string, string>()
        {
            { "test_type", "dns" }
        };
        request.callback = (response) =>
        {
            Debug.Log("[DNS] 结果: " + response);
        };
        Unity_CLS.Dns(request);
    }

    /// <summary>
    /// 执行 MTR 路由追踪
    /// </summary>
    public void DoMtr()
    {
        MtrRequest request = new MtrRequest();
        request.target = "www.baidu.com";
        request.maxTtl = 30;
        request.times = 3;
        request.detectCustomField = new Dictionary<string, string>()
        {
            { "test_type", "mtr" }
        };
        request.callback = (response) =>
        {
            Debug.Log("[MTR] 结果: " + response);
        };
        Unity_CLS.Mtr(request);
    }
}

public delegate void callback_response(string response);

Dictionary<string, string> userCustomField = new Dictionary<string, string>();
userCustomField.Add("user_id", "12345");
userCustomField.Add("app_version", "2.0.0");
Unity_CLS.SetUserCustom(userCustomField);

request.detectCustomField = new Dictionary<string, string>()
{
    { "scene", "game_loading" },
    { "server_region", "ap-shanghai" }
};