大数跨境
0
0

iOS 端遇到「查找本地网络设备」弹窗提示,如何解决?

iOS 端遇到「查找本地网络设备」弹窗提示,如何解决? RTE开发者社区
2020-09-15
2
导读:声网Agora iOS SDK 3.1.2 现已更新。
近日,iOS 系统版本升级至 14.0 版本了。不过升级后,用户使用集成了声网 iOS 语音或视频 SDK 或声网Agora RTM SDK 的 App 时,会看到「查找本地网络设备」的弹窗提示,如下图所示:
这让一些用户产生了疑问,而且,在一定程度上影响了用户体验。我们详细调查了弹窗问题,并于近日更新发布了声网Agora 语音或视频 SDK 3.1.2 版本,梳理了解决方案。我们也将于 9 月底针对 iOS 平台更新实时消息 RTM SDK 1.4.1 版。
弹窗原因
iOS 14.0 版本新增了关于本地网络设备的隐私权限,App 需要向用户获取 Privacy - Local Network Usage Description 权限,才能访问用户的本地网络设备。
3.1.2 之前版本的 iOS 语音或视频 SDK 会检测客户端与用户本地网关连通质量,并通过 reportRtcStats 的 gatewayRtt 参数,报告客户端到本地路由器的往返延时。iOS 系统将该连通性检测判断为查找本地网络设备。因此,虽然 App 不会连接用户本地网络上的任何设备,但用户使用 App 时会看到查找本地网络设备的弹窗提示。
另一方面,集成了1.4.1 之前版本的 RTM SDK 的 App 也可能会遇到弹窗。这是由于路由器具备 DNS 解析服务功能而触发的。
针对该弹窗的解决方案

方案 1:使用RTC 3.1.2 版本 SDK

声网在 3.1.2 版 iOS RTC SDK 中关闭了本地网络连通质量报告功能,如果你的业务不依赖该功能,声网建议你选择此方案。
在你的 App 中集成 3.1.2 及以上版本 SDK,用户运行 App 时就不会看到查找本地网络设备的弹窗提示。自 3.1.2 版本起,reportRtcStats 的 gatewayRtt 参数会失效(值恒为 -1),请不要使用该参数获取客户端到本地路由器的往返延时。

方案 2:修改项目权限描述

这个方案既适用于集成了3.1.2 之前版本声网 RTC SDK 的 App,也适用于集成了 1.4.1 之前版本 RTM SDK 的应用。
如果你的业务需要获取客户端到本地路由器的往返延时,我们建议你选择此方案。
在你的 App 中集成 3.1.2 以下版本 SDK,用户在 iOS 14.0 设备上运行 App 时看到的弹窗提示默认为:此 App 将可发现和连接到您所用网络上的设备。建议你结合你的业务需求修改弹窗提示内容,修改步骤如下:
  1. 打开 Xcode 项目,在 info.plist 文件中,点击 + 图标添加 Privacy - Local Network Usage Description
  2. 结合你的业务需求,在 Privacy - Local Network Usage Description 的 Value 栏中填写获取本地网络设备权限的目的。例如:此 App 不会连接到您所用网络上的设备,只会检测与您本地网关的连通性。
修改后,用户使用 App 时收到的弹窗界面如下图所示:
  • 如果用户点击,App 可以通过 reportRtcStats 的 gatewayRtt 参数获取客户端到本地路由器的往返延时。
  • 如果用户点击不允许reportRtcStats 的 gatewayRtt 参数会失效(值恒为 -1),请不要使用该参数获取客户端到本地路由器的往返延时。

注意,在集成了1.4.1 之前版本 RTM SDK 的 App中,用户点击不同的按钮意味着:

  • 如果用户点击 App 可以通过本地路由器的域名查询结果获得更多 RTM 服务节点。

  • 如果用户点击不允许, App 不会通过本地路由器进行域名查询来获得额外的 RTM 服务节点,RTM 服务可用性稍有下降。

如在集成 3.1.2 版声网语音通话/音频互动直播 iOS SDK 或视频通话/视频互动直播 iOS SDK过程中遇到问题,请访问RTC 开发者社区(rtcdeveloper.com)发帖提问,声网工程师会提供帮助与支持。同时,声网Agora RTM SDK 1.4.1 版将于 2020 年 9 月底上线官网。


【声明】内容源于网络
0
0
RTE开发者社区
RTE 开发者社区是聚焦实时互动领域的中立开发者社区。不止于纯粹的技术交流,我们相信开发者具备更加丰盈的个体价值。行业发展变革、开发者职涯发展、技术创业创新资源,我们将陪跑开发者,共享、共建、共成长。
内容 1122
粉丝 0
RTE开发者社区 RTE 开发者社区是聚焦实时互动领域的中立开发者社区。不止于纯粹的技术交流,我们相信开发者具备更加丰盈的个体价值。行业发展变革、开发者职涯发展、技术创业创新资源,我们将陪跑开发者,共享、共建、共成长。
总阅读197
粉丝0
内容1.1k