skills/developer.tuya.com/building-tuya-android-device-foundation

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:设备监听接口,提供 onDpUpdateonRemovedonStatusChangedonNetworkStatusChangedonDevInfoUpdate 五个回调。
  • 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 — 设备操作(按需选择):

Installs
7
First Seen
May 28, 2026
building-tuya-android-device-foundation from developer.tuya.com