Voice Skills Account Linking UI BizBundle

Voice Skills Account Linking UI BizBundle provides the custom skills of Amazon Alexa and Google Assistant. This allows users to quickly bind voice skills to your app and accelerates the process for you to get WWA certification.

Preparation

Integrate with the UI BizBundle

Add the following dependency to the file build.gradle of module:

dependencies {
    api enforcedPlatform("com.thingclips.smart:thingsmart-BizBundlesBom:${biz_bom_version}")
    implementation 'com.thingclips.smart:thingsmart-bizbundle-amazon_google_bind'
    implementation 'com.thingclips.smart:thingsmart-social_auth_manager'
    implementation 'com.thingclips.smart:thingsmart-social_auth_manager_ui'
    implementation 'com.thingclips.smart:thingsmart-aac-clean-kt'
    implementation 'com.thingclips.smart:speech-skill-auth-manager:5.9.0-cube300'
    implementation 'org.jetbrains.kotlin:kotlin-reflect:1.3.72'
}

Configure app_scheme

1. Customize app_scheme in the root directory local.properties to identify your app. This value is the App Schema field value specified by you to create the app based on the SDK on the Tuya IoT Development Platform.

   app_scheme=testdemo
   

2. Set the following parameters required by AndroidManifest.xml in build.gradle of module:

   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'),
                   ALEXA_AUTH_INTERNAL_HOST_NEWER: "${properties.getProperty("aleax_auth_applink_host")}",
   	]
   }
   

Configure Amazon Alexa

Add the following configurations to the resource file res:

// true means that navigation from the Amazon Alexa authorization page to your app is supported. false means that navigation from the Amazon Alexa authorization page to your app is not supported.
<bool name="is_show_alexa_oem_account"></bool>
// true means that Amazon Alexa is allowed to pull up the app authorization page. false means that Amazon Alexa is not allowed to pull up the app authorization page.
<bool name="is_alexa_to_thingpp_support">Whether Amazon Alexa is allowed to pull up the app authorization page</bool>

Configure Google Assistant

Add the following configurations to the resource file res:

<string name="google_flip_client_id">Replaced with Client-ID provided by Tuya</string>

Bind Amazon Alexa skills

API description

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

Parameters

Example

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

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

Bind Google Assistant skills

API description

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

Parameters

Example

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

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

Unbind voice skills

To unbind the voice skills of Amazon Alexa and Google Assistant, you only need to get a list of skills and process the events of tapping the list.

Get the list of bound skills

API description

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

Data model of AuthorityBean

Example

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
				}
			});

Unbind skills

API description

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

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

Parameters

Update bound skill list

Updates the list of voice skills that have been bound with your app.

API description

   @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) {
                  // Call the getAuthorityPlatforms method to refresh the list of skills.
                   
                }
                break;
            default:
                break;
        }
    }