为 Wi-Fi 快连配网（EZ 配网）功能申请应用权限

更新时间：2024-06-20 04:27:29下载pdf

本文介绍如何在苹果开发者官网申请 多播网络（Multicast）应用权限，从而正常使用 Wi-Fi 快连配网功能。本文适用于 iOS 版本的 OEM App 或者其他有相同需求的 App。

背景信息

Wi-Fi 快连配网又称 快连模式（Easy-Connect）、SmartConfig 或 EZ 配网。用户将手机连接到路由器后，利用路由器广播报文与设备进行通信配对。该配网方式操作简单，但对手机、路由器、App 有兼容性或者权限要求。

苹果（Apple.com）为提升安全性引入 Multicast 权限。若 App 无此权限，会导致快连配网无法成功。您可以参考本文描述，通过苹果开发者后台，向苹果额外申请 Multicast 权限。审批通过后，即可正常使用快连配网功能。

根据页面提醒，填写申请信息。

您可通过 App Store Connect 查看 App 的基本信息。以下以 智能生活 App 为例，介绍申请信息的填写。

填写项	填写示例	注意事项
App Name		-
Apple Store URL	例如，智能生活的 Apple ID of App 为 1115101477，所以链接为 `https://apps.apple.com/app/id1115101477`。	该 URL 需要您拼接，格式为 https://apps.apple.com/app/id[Apple ID of App]。
Apple ID of App（非必填）		-
App Category		-
Describe the main purpose of your app	用于家居场景，提供设备配网、设备控制、固件升级、自动化等。	请勿直接使用右侧文案，根据您 App 的应用场景做一定调整。
Explain why your app needs to send multicast or broadcast traffic, or browse for all Bonjour service types.	我们的 App 需要和我们的硬件设备进行通信，由于 IP 地址和端口不固定，使用自定义的广播组播协议进行通信，使用 UDP 6666、6667，TCP 6668 端口。例如，需要将设备信息注册到云端的场景。App 发送包含经过加密的 UDP 广播包或者组播包。设备 Wi-Fi 芯片在接收到该 UDP 包后，通过特定的 UDP 组织形式就可以解密出信息，接着设备进行 Wi-Fi 配置后即可上网连接云端。	请勿直接使用右侧文案，建议在描述上做一些调整，但必须包含 UDP 6666、6667，TCP 6668 端口这些内容。

当收到苹果回复申请成功（3-5个工作日）的电子邮件后，您可以访问您的苹果开发者账号，确认是否申请成功，并为 App 添加 Multicast 网络设置。

进入 Certificates, IDs & Profiles。
点击 App 对应的 Identifiers。

此处，您仅需要处理 App 对应的 Identifiers，Watch、Siri 对应的 Identifiers 都不需要处理。例如，对于涂鸦智能生活 App，只需要处理 com.tuya.smart，不需要处理 com.tuya.smart.watchkitapp。
勾选 Multicast Networking，然后点击保存。

完成以上步骤后，进入涂鸦开发者平台更新 iOS 证书。

进入涂鸦开发者平台 > App > App 开发，选择您的 App，找到 开发步骤 3：App 配置 > iOS 证书，点击设置。
重新生成证书并构建 App。
- 参考《创建应用配置文件》（.mobileprovison 格式）更新您的证书。
- 上传证书到涂鸦开发者平台，重新构建 App。