本文档介绍如何通过 GNA iOS SDK 实现网络分析。网络分析分为玩家自助网络分析和游戏对局网络分析。
您可以参见 工作原理 了解火山引擎游戏网络加速（GNA）如何对玩家的网络进行分析。
您已经导入和初始化了 GNA iOS SDK。
参见以下步骤实现玩家自助分析。您可以参见 SDK 参考 了解 SDK 的详细信息。
导入以下头文件。
#import <GameSdkNetworkManager/TTNetDiagnosisService.h>
调用 createRequestWithRequestParams 方法创建自助分析请求。
// 设置请求参数 // 把请求类型设置为网络分析 TTNetDiagnosisRequestParams *diagnosisRequestParams = [TTNetDiagnosisRequestParams new]; // 把请求类型设置为网络分析 diagnosisRequestParams.requestType = DIAGNOSE_TARGET; // 指定分析目标地址。可以是域名或 IPv4 地址。目前您只能传入一个目标地址。 diagnosisRequestParams.targets = @[@"www.volcengine.com"]; // 地址特征，用于网络分析的地址调度功能。您需要联系我们使用该功能。如果您不需要使用地址调度功能，可设置为 @""。 diagnosisRequestParams.dispatchFeature = @""; // 一般情况下，您可以设置为 0 diagnosisRequestParams.detectType = 0; // 超时时间。您可以设置为 15 秒 diagnosisRequestParams.timeoutMs = 15000; // 创建分析请求NSObject [[TTNetDiagnosisService shareInstance] createRequestWithRequestParams:diagnosisRequestParams callback:^(NSString *report) { NSLog(@"诊断接口回调: %@", report); }];
调用 start 方法开始自助分析。开始之后，SDK 会向您设置的目标地址发送网络分析请求。您还可以通过 setUserExtraInfo 方法为分析请求添加附加信息。自助分析结束后，您可以通过 createRequestWithRequestParams 方法中的 callback 参数中的回调函数获取分析结果。另外，您也可以在控制台 查看统计数据。
// 开始分析 [request start]; // 您还可以为分析请求添加附加信息，例如玩家的用户 ID。 // 这样您在查看分析结果时，就可以按玩家的用户 ID 对分析结果进行分类统计 [request setUserExtraInfo:@"player_id"];
自助分析会在完成后自动结束。如果，自助分析页面需要支持玩家取消自助分析。您可以调用 cancel 取消自助分析。
// 取消分析 [request cancel];
玩家开始游戏对局时，如果网络发生跳变，SDK 会自动进行网络分析并向玩家或游戏运维人员返回分析结果。
您可以参见以下步骤实现游戏对局网络分析。
导入以下头文件。
#import <GameSdkNetworkManager/TTGameDiagnosisService.h>
游戏对局开始时，调用 monitorBegin 方法开启游戏对局网络分析。当网络发生跳变时，SDK 会自动向您设置的目标地址发送网络分析请求。您可以在控制台 查看统计数据。
TTGameMonitorBeginParams *monitorBeginParams = [TTGameMonitorBeginParams new]; // 指定分析目标地址。可以是域名或 IPv4 地址 monitorBeginParams.target = @"www.volcengine.com"; // 地址特征，用于网络分析的地址调度功能。您需要联系我们使用该功能。如果您不需要使用地址调度功能，可设置为 @""。 monitorBeginParams.dispatchFeature = @""; // 您还可以为分析请求添加附加信息，例如玩家的用户 ID。 monitorBeginParams.extraInfo = @"monitor begin user info"; // 获取报告的回调 monitorBeginParams.reportCallback = ^(NSString *report) { NSLog(@"diagnosis v2 report: %@", report); }; [[TTGameDiagnosisService shareInstance] monitorBeginWithParams:monitorBeginParams];
在游戏对局过程中，您也可以主动调用 doDiagnosisDuringGaming 方法向您在 monitorBegin 方法中设置的目标地址发送网络分析请求。您可以在控制台 查看统计数据。
NSString* reason = @"movelag"; [[TTGameDiagnosisService shareInstance] doDiagnosisDuringGaming:reason];
对局游戏结束时，调用 monitorEnd 方法关闭对局分析。
[[TTGameDiagnosisService shareInstance] monitorEnd];