通知
本站点除 Legacy 产品与方案外,已迁移至 声网新文档中心 ,当前页面不再维护
文档中心
全部产品
Console 官网 社区 技术支持

为什么在运行集成声网 RTM SDK 的 iOS app 时会看到查找本地网络设备的弹窗提示?

分类: 集成类    平台: iOS   最后更新时间: 2020/12/17 19:24:10

问题现象

iOS 系统版本升级至 14.0 版本后,用户使用集成了声网 RTM SDK 的 app 时会看到查找本地网络设备的弹窗提示。默认弹窗界面如下图所示:

问题原因

iOS 14.0 版本新增了关于本地网络设备的隐私权限,app 需要向用户获取 Privacy - Local Network Usage Description 权限,才能访问用户的本地网络设备。RTM SDK 会通过域名访问 Agora 服务器,当终端设备使用的域名解析服务器处于同一网段时,会触发弹窗。

解决方案

方案 1. 使用 1.4.1 及以上版本 RTM SDK

1.4.1 修复了 RTM SDK 在 iOS 14.0 版本的弹窗提示问题。修复之后,弹窗不会出现,RTM 服务可用性也不会受到影响。

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

用户在 iOS 14.0 设备上运行 app 时看到的弹窗提示默认为:此 App 将可发现和连接到您所用网络上的设备。声网建议你结合你的业务需求修改弹窗提示内容,修改步骤如下:

  1. 打开 Xcode 项目,在 info.plist 文件中,点击 + 图标添加 Privacy - Local Network Usage Description

    在 Xcode 11 中,你需要添加 NSLocalNetworkUsageDescription
  2. 结合你的业务需求,在 Privacy - Local Network Usage DescriptionValue 栏中填写获取本地网络设备权限的目的。例如:此 app 不会连接到您所用网络上的设备,只会检测与您本地网关的连通性。

修改后,用户使用 app 时收到的弹窗界面如下图所示:

  • 如果用户点击, app 可以通过本地路由器的域名查询结果获得更多 RTM 服务节点。
  • 如果用户点击不允许, app 不会通过本地路由器进行域名查询来获得额外的 RTM 服务节点,但也不会对 RTM 服务可用性造成明显影响。

相关链接