用途:在 Unity 游戏中添加并配置 Vivox 语音与文字聊天,适用于语音聊天、麦克风权限、静音控制、位置语音(proximity)等需求。命名空间 Unity.Services.Vivox,包 com.unity.services.vivox,配套 Unity.Services.Core 与 Unity.Services.Authentication。Vivox v16+ 以静态入口 VivoxService.Instance 统一处理初始化、登录、加入频道、消息与静音,不再使用 v4 的 Client.Instance、AccountId、ChannelId、ILoginSession 等模式。
主要能力:初始化与登录;加入非位置频道(JoinGroupChannelAsync)、回声测试频道(JoinEchoChannelAsync)、3D 位置频道(JoinPositionalChannelAsync);频道文字消息(SendChannelTextMessageAsync / ChannelMessageReceived)与点对点定向消息(SendDirectTextMessageAsync / DirectedMessageReceived);参与者事件、静音、语音检测等;消息编辑删除与历史记录(默认保留 7 天)。
使用方式:初始化顺序为 UGS Core → Authentication 登录 → Vivox 初始化 → Vivox 登录,例如 await UnityServices.InitializeAsync(); await AuthenticationService.Instance.SignInAnonymouslyAsync(); await VivoxService.Instance.InitializeAsync(); await VivoxService.Instance.LoginAsync(new LoginOptions { DisplayName = "Bob" });。加入频道需先订阅 ChannelJoined 事件再调用加入方法,加入完成由事件通知而非 await 返回。所有事件应在 OnDestroy/OnDisable 中取消订阅。
限制:重复调用 InitializeAsync 会抛 5041 VxErrorAlreadyInitialized;每用户最多 10 个非位置频道,每频道最多 200 人,超出报 20502;超过 200 人的位置频道需企业版 Large 3D 设置。Android 需运行时申请 RECORD_AUDIO,iOS 需在 plist 配置 NSMicrophoneUsageDescription。默认使用 UGS Authentication 自动签发访问令牌,非 UGS 身份或需频道级特权令牌时须由服务端签发 VAT,禁止在客户端嵌入 HMAC 签名密钥。具体 API 签名、事件细节与平台注意事项见随附 references 文档;官方文档不可达时以本技能参考与工作区已安装包为准。