You need to enable JavaScript to run this app.
导航

实现网络加速(Unity)

最近更新时间2024.02.20 10:53:40

首次发布时间2023.04.28 09:58:14

本文档介绍如何通过 GNA Unity SDK 实现网络加速。
游戏网络加速 GNA 可以在游戏客户端和游戏服务端之间加速网络数据传输。
您可以参见 工作原理 了解火山引擎游戏网络加速(GNA)如何对玩家的网络进行加速。

前提条件

您已经导入和初始化了 GNA Unity SDK

实现步骤

参见以下步骤实现网络加速。您可以参见 SDK 参考 了解 SDK 的详细信息。

  1. 实现以下回调并通过 MpaInitEventMpaSetAccAddressEventMpaStopEvent 注册以下回调:

    • HandlerMpaInitEvent:报告初始化结果
    • HandlerMpaSetAccAddressEvent:报告加速目标地址设置结果
    • HandlerMpaStopEvent:报告加速是否成功
    // 报告初始化结果
    void HandlerMpaInitEvent(bool isSuccess, string extraMsg) {
         if (isSuccess) {
           // 初始化成功
         } else {
           // 初始化失败
         }
    } 
            
    // 报告加速目标地址设置结果
    void HandlerMpaSetAccAddressEvent(bool isSuccess, string extraMsg, string context) {
       if (isSuccess) {
       // 设置加速目标地址成功。游戏客户端开始与游戏服务端建连并发送数据
       } else {
       // 设置加速目标地址失败。游戏客户端开始与游戏服务端建连并发送数据。数据不经过加速链路
       }
    }
    
     // 报告加速是否成功 
    void HandlerMpaStopEvent(bool isSuccess, string extraMsg) {
       if (isSuccess) {
       // 此次加速成功
       } else {
       // 因为某些内部错误导致加速中止
       }
    }
    
    // 通过 Event 注册上述回调函数
    NetMpa.Service.MpaInitEvent += HandlerMpaInitEvent;
    NetMpa.Service.MpaSetAccAddressEvent += HandlerMpaSetAccAddressEvent;
    NetMpa.Service.MpaStopEvent += HandlerMpaStopEvent;
    
  2. 调用 Init 方法初始化网络加速功能。

    NetMpa.Service.Init();
    
  3. 调用 Start 方法开始网络加速。

    NetMpa.Service.Start("your_start_log");
    
  4. 调用 setAccAddress 方法设置网络加速的目标地址。

    注意

    • 您必须在创建的回调函数触发后再与游戏服务端建立连接。否则可能出现数据丢失。同时,您还要增加超时机制。否则,如果回调在较长时间内没有返回,会阻塞与游戏服务端建立连接。
    • 如果您分别使用两个线程发送和接收数据,需要先执行发送线程,再执行接收线程,否则会出现接收线程卡死。
    • 如果 App 在加速时发生重连并且目标地址的 IP 或端口发生变化,您需要在 App 再次重连之前先调用 SetAccAddress 方法更新加速目标地址。
    • 如果您在调用 Start 方法之前调用 SetAccAddress 方法,GNA SDK 会在 Start 方法完成后触发一次回调。上下文为最后一次调用 SetAccAddress 时传入的 context
    • 如果您在调用 Start 方法之后调用 SetAccAddress 方法,每次调用 SetAccAddress 方法都会触发一次回调。上下文为每次调用时传入的 context 参数。
    • 如果您需要全量更新加速地址,则您需要把 append 参数设为 false;如果您需增量更新加速地址,则您需要把 append 参数设为 true。
    AcceleratedPointsParams pointsParams = new AcceleratedPointsParams();
    var list = new List<string>();
    list.Add("1.1.1.1:8080");
    list.Add("2.2.2.2:8888");
    pointsParams.AddressList = list;
    pointsParams.Context = "your_context_id";
    pointsParams.Append = false;
    NetMpa.Service.SetAccAddress(pointsParams);
    
  5. 加速完成后,调用 Stop 方法关闭加速。

    NetMpa.Service.Stop("your_end_log");
    

接下来您可以

查看统计数据