building-tuya-android-device-foundation
Installation
SKILL.md
概述 {#description}
为已接入 Tuya Smart App SDK 的 Android Kotlin 工程落地设备管理基础能力。涵盖设备信息与监听、设备操作(重命名/移除/恢复出厂)、设备共享三大模块。默认采用 XML/View + Activity/Fragment + ViewModel 结构。
核心类:
- IThingDevice:单设备操作入口,通过
ThingHomeSdk.newDeviceInstance(devId)获取。 - DeviceBean:设备数据模型,包含 devId、name、dps、isOnline、productId、iconUrl、schema 等。
- IDevListener:设备监听接口,提供
onDpUpdate、onRemoved、onStatusChanged、onNetworkStatusChanged、onDevInfoUpdate五个回调。 - IThingHomeDeviceShare:设备共享管理入口,通过
ThingHomeSdk.getDeviceShareInstance()获取,最多 20 个用户。
适用场景 {#scene}
需要在已完成 SDK 集成、账号登录、至少有一个家庭的工程中操作单个设备时使用。
Phase 1 — 设备信息获取:调用 getHomeDetail 后,从 HomeBean.getDeviceList() 获取设备列表;ThingHomeSdk.newDeviceInstance(devId) 创建操作实例;按需调用 mDevice.getDp(dpId, callback) 查询功能点。
Phase 2 — 设备监听:在 ViewModel 初始化时调用 mDevice.registerDevListener(listener);在 ViewModel.onCleared() 中调用 mDevice.unRegisterDevListener() 和 mDevice.onDestroy()。
Phase 3 — 设备操作(按需选择):