智能场景 UI 业务包

更新时间:2023-06-28 03:35:52下载pdf

涂鸦 智能场景 UI 业务包 安卓版的业务功能包括 智能场景 模块的 添加智能编辑智能 的业务逻辑和 UI 界面。

背景信息

智能场景分为 一键执行场景自动化场景,分别简称为 场景自动化

  • 场景:用户添加动作,手动触发。
  • 自动化:由用户设定条件,当条件触发后自动执行设定的动作。

涂鸦支持用户根据实际生活场景,通过设置气象或设备条件,当条件满足时,让一个或多个设备执行相应的任务。

接入组件

创建工程

在 Android Studio 中建立您的工程,接入智能生活 SDK 并完成业务包 框架接入

您的工程需要添加 Hilt 相关依赖才能使用场景业务包。请参考 Hilt接入示例

build.gradle 配置

dependencies {
  implementation 'com.tuya.smart:tuyasmart-bizbundle-scene:4.2.0-33'
}

服务接口

提供服务

场景业务包实现 ITuyaSceneBusinessService 以提供服务。

示例代码

// 查询场景业务包服务
ITuyaSceneBusinessService iTuyaSceneBusinessService = MicroContext.findServiceByInterface(ITuyaSceneBusinessService.class.getName());

新增场景

通过查询家庭 ID 进入场景添加页。

接口说明

ITuyaSceneBusinessService.addScene(Activity activity, long homeId, int requestCode);;

参数说明

参数 说明
activity Activity 对象
homeId 家庭 ID,您可以通过 家庭信息管理 相关接口查询
requestCode 请求 code,在 onActivityResult 处返回

示例代码

if(null != iTuyaSceneBusinessService && homeId != 0) {
  iTuyaSceneBusinessService.addScene(activity, homeId, requestCode);
}

编辑场景

通过查询场景数据和家庭 ID 进入场景编辑页面。

接口说明

进入编辑场景页。

ITuyaSceneBusinessService.editScene(Activity activity, long homeId,SceneBean sceneBean, int requestCode);;

参数说明

参数 说明
activity Activity 对象
homeId 家庭 ID,您可以通过 家庭信息管理 相关接口查询
SceneBean 场景数据对象,您可以通过 智能场景 相关接口查询
requestCode 请求 code,在 onActivityResult 处返回

示例代码

TuyaHomeSdk.getSceneManagerInstance().getSceneList(homeId, new ITuyaResultCallback<List<SceneBean>>() {
@Override
public void onSuccess(List<SceneBean> result) {
	if(!result.isEmpty()){
	SceneBean sceneBean = result.get(0);
	if(null != iTuyaSceneBusinessService){
		iTuyaSceneBusinessService.editScene(SceneActivity.this, homeId, sceneBean, requestCode);
	}
	}
}

@Override
public void onError(String errorCode, String errorMessage) {

}
});

设置地理位置

使用场景条件和生效时间段前,需要用户设置 App 的地理位置。如果没有设置,则无法在选择条件时自动查询城市信息。但是,用户还是可以在城市列表自行选择。

接口说明

ITuyaSceneBusinessService.setAppLocation(double longitude, double latitude);

参数说明

参数 说明
longitude 经度,由您的 App 自行接入的相关三方地图提供
latitude 纬度,由您的 App 自行接入的相关三方地图提供

示例代码

if(null != iTuyaSceneBusinessService){
	iTuyaSceneBusinessService.setAppLocation(lng, lat);
}

设置 App 地图类

场景条件中的地理位置,如果不需要非中国大陆地区账号,就无需调用。其他国家或地区的账号需要设置地图类,不设置默认则调用查询中国大陆城市接口。

接口说明

ITuyaSceneBusinessService.setMapActivity(Class activity);

参数说明

参数 说明
Class 地图 Activity 类对象

示例代码

if(null != iTuyaSceneBusinessService){
	//TODO 业务方地图Activity
	iTuyaSceneBusinessService.setMapActivity(MapActivity.class);
}

设置地图选点数据

接入地图类之后,您需要将地图选点数据发给 UI 业务包,用来更新条件地理位置信息。

接口说明

ITuyaSceneBusinessService.saveMapData(double longitude, double latitude,String city, String address);

参数说明

参数 说明
longitude 经度
latitude 纬度
city 城市信息
address 地址信息

示例代码

if(null != iTuyaSceneBusinessService){
	iTuyaSceneBusinessService.saveMapData(lng, lat, city, address);
}