物联网开发平台 Android

一、环境准备

·安装 Android Studio 2025 以后的版本。

·一台 Android 10 以上的设备。

二、开通服务

·请参见开通服务，创建应用并获取 App Key 和 App Secret，在后续登录步骤中会用到。

·并参见开通服务，创建设备获取设备的 ProductId、DeviceName，在后续绑定设备步骤中会用到。

三、下载 Demo 隐私与安全性

1. 从 GitHub 下载 IoT App Demo 源码，或者直接在命令行运行以下命令：

git clone https://github.com/Tencent-RTC/Tencent_IoT_App.git

2. 通过 Android Studio 打开 Tencent_IoT_App/android 目录：

注意：提示：

注意：Android Studio 的推荐方案：将 Android Studio 的 Java 版本改为17。

注意：1. 打开 Android Studio 设置。

注意：2. 修改 Java 编译器设置。

四、跑通 Demo

按照开通服务，创建设备和应用，并通过 Android Studio 运行 App，将设备绑定到 App。

五、步骤1：运行 Demo

1. 开启手机开发者选项与 USB 调试（设置 > 关于手机 > 连续单击版本号7次），连接后允许调试授权。

2. 等待 Gradle 首次同步完成再运行。

3. 选择设备并编译和运行 Demo。

注意：说明：

注意：本 Demo 默认集成了音视频通话功能，由于该功能依赖的音视频 SDK 暂不支持模拟器，因此建议使用真机调试、运行 Demo。

六、步骤2：登录和注册

Demo 启动后，在 UserId 输入框中输入自定义 ID，并在 AppKey、AppSecret 输入框中输入从开通服务获取的对应信息。

登录用户：tony	默认无设备

注意：提示：

注意：建议你尽量避免将你的 UserId 设置成 “1”、“123”、“111” 等简单字符串，在多人协作开发时，此类 UserId 容易被同事占用导致登录失败，建议在调试时设置辨识度高的 UserId。

七、步骤3：绑定设备

绑定设备时需要设备绑定签名（DeviceSignature），通过 API Explorer 在线调试获取。

1. 打开 GenSingleDeviceSignatureOfPublic 接口，填入从开通服务文档获取的 ProductId、DeviceName（Expire 为签名过期时间，按需填写即可，例如设置为当前时间 24 小时后），单击发送请求，从返回结果的 Response.DeviceSignature 中获取签名值。

2. 将获取到的签名值，填写到 “添加设备” 页面的签名输入框，然后单击添加设备。

八、步骤4：通过物模型操作设备属性

在 DeviceHardwareType.kt 添加你的产品 ID，Demo 会将该列表中的产品类型当做 “智能吸顶灯”，其他的产品当做安防摄像头。

object DeviceHardwareRegistry { // Demo 会将该列表中的产品类型当做 “智能吸顶灯”，其他的产品当做安防摄像头 private val ceilingLampProductIds = setOf( "XXXXXXXXXX" )}

注意：若未将 ProductId 加入列表，设备将被识别为安防摄像头。设备详情页与预期不符时，请检查该配置。

在绑定设备后，设备列表中就能看到对应智能吸顶灯设备，单击进去，就能看到智能吸顶灯的操作界面。

接下来还需要参考设备端的跑通 Demo 文档将设备端的 Demo 跑通，就可以通过 App Demo 操作智能吸顶灯了。

设备列表	智能吸顶灯操作页面