语音技能快绑 UI 业务包

涂鸦语音技能快速绑定 UI 业务包（简称技能快绑业务包） 提供一键快速绑定 Amazon Alexa 和 Google Assistant 的自定义语音技能服务。

准备工作

集成业务包

在工程 Module 的 build.gradle 添加如下配置：

dependencies {
	implementation 'com.thingclips.smart:thingsmart-bizbundle-amazon_google_bind:2.0.0-cube.2'
        implementation 'org.jetbrains.kotlin:kotlin-reflect:1.3.72'
}

配置 app_scheme

1. 在根目录 local.properties 配置 app_scheme 值，用于标识。此值取自于您基于 SDK 创建 App 时自定义的渠道标识符。

   app_scheme=testdemo
   

2. 在工程 Module 的 build.gradle 里设置 AndroidManifest.xml 需要的参数：

   defaultConfig {
   	……
   		Properties properties = new Properties()
   		properties.load(project.rootProject.file('local.properties').newDataInputStream())
   	manifestPlaceholders = [
   				   INTERNAL_HOST: "${properties.getProperty("app_scheme")}".concat('.app.tuya.com'),
                   ALEXA_AUTH_INTERNAL_HOST: "${properties.getProperty("app_scheme")}".concat('.applink.smart321.com'),
                   ALEXA_AUTH_INTERNAL_HOST_NEW: "${properties.getProperty("app_scheme")}".toLowerCase(Locale.ENGLISH).concat('.applink.smart321.com'),
   
   	]
   }
   

配置 Amazon Alexa

在 res 资源文件中，添加如下配置：

// true 代表 Alexa 授权页面显示支持跳转客户自己 App 账号。false 代表 Alexa 授权页面显示不支持跳转客户自己 App 账号。
<bool name="is_show_alexa_oem_account"></bool>
// true 代表支持 Alexa 拉起 App 授权。false 代表不支持 Alexa 拉起 App 授权。
<bool name="is_alexa_to_thingpp_support">是否支持 Alexa 拉起 App 授权</bool>

配置 Google Assistant

在 res 资源文件中，添加如下配置：

<string name="google_flip_client_id">替换为涂鸦提供的 Client-ID</string>

绑定 Amazon Alexa 技能

接口说明

fun alexaBind(mActivity: Activity, homeId: String, callback: IThingResultCallback<Boolean>)

参数说明

参数	类型	说明
homeId	String	家庭 ID
callback	IThingResultCallback	回调结果

示例代码

ThingSocialLoginBindManager.Companion.getInstance().alexaBind(mActivity, homeId, new IThingResultCallback<Boolean>() {
	@Override
	public void onSuccess(Boolean result) {}

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

绑定 Google Assistant 技能

接口说明

fun googleBind(mActivity: Activity, homeId: String, callback: IThingResultCallback<Boolean>)

参数说明

参数	类型	说明
homeId	String	家庭 ID
callback	IThingResultCallback	回调结果

示例代码

ThingSocialLoginBindManager.Companion.getInstance().googleBind(mActivity, homeId, new IThingResultCallback<Boolean>() {
	@Override
	public void onSuccess(Boolean result) {}

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

解绑语音技能

实现 Amazon Alexa 和 Google Assistant 技能解绑功能，您只需获取解绑列表，处理列表点击事件。

获取技能绑定列表

接口说明

fun getAuthorityPlatforms(cb: ResultCallback<ArrayList<AuthorityBean?>>?)

AuthorityBean 数据模型

字段	类型	描述
time	Number	授权时间
icon	String	图标 URL
clientType	String	平台
status	Int	1：授权 0：没有授权
platformName	String	平台名称，如： Alexa Google

示例代码

SocialAuthManagerClient.INSTANCE.getInstance(MicroContext.getApplication())
			.getAuthorityPlatforms(new ResultCallback<ArrayList<AuthorityBean>>() {
				@Override
				public void onSuccess(ArrayList<AuthorityBean> authorityBeans) {
					//get bound list success
				}

				@Override
				public void onFailure(@Nullable String s, @Nullable String s1) {
					//get bound list onFailure
				}
			});

解绑技能

接口说明

//request code
private static final int REQUEST_REFRESH_MANAGER_AUTHORIZATION = 151;

private void gotoDeAuthorize(Context context, AuthorityBean authorityBean) {
        UrlBuilder mBuilder = UrlRouter.makeBuilder(context, "SocialAuthManagerAppAction");
        Bundle newBundle = new Bundle();
        newBundle.putString("action", "gotoDeAuthorize");
        newBundle.putParcelable("authority_bean", authorityBean);
        mBuilder.setRequestCode(REQUEST_REFRESH_MANAGER_AUTHORIZATION);
        mBuilder.putExtras(newBundle);
        UrlRouter.execute(mBuilder);
    }

参数说明

参数	类型	说明
context	Context	Context
authorityBean	AuthorityBean	AuthorityBean 数据模型

更新技能绑定列表

回到调用页面更新解绑列表。

接口说明

   @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data){
        super.onActivityResult(requestCode, resultCode, data);
        switch (requestCode) {
            case REQUEST_REFRESH_MANAGER_AUTHORIZATION:
                if (RESULT_OK == resultCode) {
                  // 调用 getAuthorityPlatforms 方法，刷新技能列表。
                   
                }
                break;
            default:
                break;
        }
    }