1. 场景业务包

1.1. 功能介绍

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

智能场景分为「一键执行场景」和「自动化场景」，下文分别简称为「场景」和「自动化」。

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

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

1.2. 接入组件

1.2.1. 创建工程

在 Android Studio 中建立你的工程,接入公版 SDK 并完成业务包框架接入

1.2.2. module 的 build.gradle 配置

dependencies {
  implementation 'com.tuya.smart:tuyasmart-bizbundle-scene:3.22.0-6'
}

1.3. 服务协议

1.3.1. 提供服务

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

示例代码

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

1.3.2. 新增场景

通过获取家庭 Id 进入场景添加页

接口说明

进入创建场景页

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

参数说明

示例代码

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

1.3.3. 编辑场景

通过获取场景数据和家庭 Id进入场景编辑页面

接口说明

进入编辑场景页

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

参数说明

示例代码

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) {

  }
});

1.3.4. 设置地理位置

场景的条件和生效时间段需要设置app的地理位置，如果不设置，将不会在选择条件时自动获取城市信息，但是还是可以在城市列表自行选择

接口说明

设置场景条件地理位置

ITuyaSceneBusinessService.setAppLocation(double longitude, double latitude);

参数说明

示例代码

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

1.3.5. 设置App地图类

场景条件中的地理位置，如果不需要国外账号就无需调用，在国外账号需要设置地图类，不设置默认走获取国内城市接口

接口说明

设置地图类对象

ITuyaSceneBusinessService.setMapActivity(Class activity);

参数说明

示例代码

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

1.3.6. 保存地图选点数据

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

接口说明

设置地图选点经纬度信息

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

参数说明

示例代码

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