该版本于 2022 年 2 月 7 日发布。
代理状态回调 API 重构
自该版本起,代理状态回调 API 进行了重构。
v0.1.14.0 使用 OnProxyEvent
回调获取代理的状态及错误码。
自 v1.0.0 起,删除 OnProxyEvent
回调并改用以下回调:
OnConnected
:连接代理成功。OnAccelerationSuccess
:代理加速数据成功。OnConnectionFailed
:连接代理失败且未回退。OnDisconnectedAndFallback
:连接代理失败且回退至本地连接。新增连接限制
自该版本起,每秒并发连接数最多为 100 条,当前存在的活跃连接最多 1000 条。
如果超出限制,根据你是否设置了 fallback 机制,SDK 会在 OnConnectionFailed
或 OnDisconnectedAndFallback
回调的 reason
参数中返回 -108 或 -109 错误码。
错误码重构
自该版本起,SDK 返回的错误码进行了重构。
v0.1.14.0 中,同步和异步均可返回错误码。
v1.0.0 中,错误码分为 FPA_ERROR_CODE
和 FPA_FAILED_REASON_CODE
:同步返回 FPA_ERROR_CODE
;异步返回 FPA_FAILED_REASON_CODE
。且所有错误码的数值均发生变更。
不开启 Token 鉴权时的 token 参数值设置
在 FpaProxyServiceConfig
中,如果不开启 Token 鉴权,你不仅可以将 token
参数赋值为 App ID 的值,自该版本起也可以赋值为 null
、""
或不填该参数。
新增
OnConnected
回调OnAccelerationSuccess
回调OnConnectionFailed
回调OnDisconnectedAndFallback
回调FPA_FAILED_REASON_CODE
枚举错误码变更
v0.1.14.0 的错误码如下:
值 | 说明 |
---|---|
0 |
没有错误。 |
-10001 |
通用错误。 |
-10002 |
FPA 服务未启动完成。 |
-10003 |
SDK 不支持该方法。 |
-10004 |
请求被拒绝。 |
-10005 |
缓冲区太小,无法存储返回的数据。 |
-10006 |
状态无效 |
-10007 |
超时错误。 |
-10008 |
请求频率超出限制。 |
-10009 |
参数无效。 |
-10010 |
SDK 未初始化。你需要先初始化 SDK 再进行其他操作。 |
-10011 |
没有权限。 |
-10012 |
FPA 服务启动失败。 |
-10013 |
代理端口绑定失败。 |
-10014 |
端口无效。 |
-10015 |
文件句柄无效。 |
-10016 |
连接失败。 |
-10017 |
发送失败。 |
-10018 |
读取失败。 |
-10019 |
找不到 chain ID。请检查是否设置了正确的 chain ID。 |
v1.0.0 的错误码如下:
值(FPA_ERROR_CODE ) |
说明 |
---|---|
0 |
没有错误。 |
-1 |
参数无效。请检查你是否使用了正确的参数。 |
-2 |
无法为对象分配内存。 |
-3 |
FPA 服务没有初始化。请确保你成功进行了初始化。 |
-4 |
FPA 服务初始化失败。 |
-5 |
无法绑定 SDK内部的 socket 端口。 |
值(FPA_FAILED_REASON_CODE ) |
说明 |
---|---|
0 |
未知。 |
-101 |
DNS 解析错误。 |
-102 |
SDK 内部创建 socket 失败。 |
-103 |
SDK 内部连接 socket 失败。 |
-104 |
连接远端服务器超时。 |
-105 |
找不到 chain ID。请检查是否设置了正确的 chain ID。 |
-106 |
读取数据失败。 |
-107 |
写入数据失败。 |
-108 |
每秒并发连接数超出 100 条的限制。 |
-109 |
当前存在的活跃连接数超出 1000 条的限制。 |
删除
OnProxyEvent
回调FPA_PROXY_EVENT
枚举该版本于 2021 年 12 月 31 日发布。
该版本为 FPA Unity SDK 的首个版本。支持以下功能:
具体集成及使用方法参考以下文档: