简体中文
简体中文
English
联系我们
注册
登录

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

更新时间:2022-11-16 03:02:06下载pdf

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

背景信息

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

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

申请步骤

  1. 前往苹果开发者官网的 Multicast 权限 申请页面。

    为 Wi-Fi 快连配网(EZ 配网)功能申请应用权限
  2. 根据页面提醒,填写申请信息。

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

    填写项 填写示例 注意事项
    App Name 为 Wi-Fi 快连配网(EZ 配网)功能申请应用权限 -
    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(非必填) 为 Wi-Fi 快连配网(EZ 配网)功能申请应用权限 -
    App Category 为 Wi-Fi 快连配网(EZ 配网)功能申请应用权限 -
    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 网络设置。

  1. 进入 Certificates, IDs & Profiles

    为 Wi-Fi 快连配网(EZ 配网)功能申请应用权限
  2. 点击 App 对应的 Identifiers

    此处,您仅需要处理 App 对应的 Identifiers,Watch、Siri 对应的 Identifiers 都不需要处理。例如,对于涂鸦智能生活 App,只需要处理 com.tuya.smart,不需要处理 com.tuya.smart.watchkitapp

    为 Wi-Fi 快连配网(EZ 配网)功能申请应用权限
  3. 勾选 Multicast Networking,然后点击 保存

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

更新 iOS 证书

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

  1. 进入 涂鸦 IoT 开发平台 > App > App 开发,选择您的 App,找到 开发步骤 3:App 配置 > iOS 证书,点击 设置

    为 Wi-Fi 快连配网(EZ 配网)功能申请应用权限
  2. 重新生成证书并构建 App。