帮你快速理解、总结文档立即下载

Android

最近更新时间:2026-09-17 18:11:33
我的收藏
本文将为您介绍如何快速跑通 Android Demo。跟随本文档,您可以快速跑通 Demo,并最终体验一个包含完备 UI 界面的物联网 App。


前提条件

环境准备

安装 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 设置。
Windows:File > Settings
Mac:Android Studio > Preferences
2. 修改 Java 编译器设置。
路径:Build, Execution, Deployment > Build Tools > Gradle
将 Gradle JDK 改为17(如果已安装)或 Use project JDK

跑通 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 操作智能吸顶灯了。
设备列表
智能吸顶灯操作页面



常见问题

绑定设备时提示 “APP 对操作该产品无权限”

创建应用后,还需在控制台的应用详情页将应用与产品关联,授权该应用管理该产品下的设备。如下图: