Gizwits Siri Shortcut

由于 Cordova 目前不支持创建多个 Target 的 iOS 项目，添加 Siri Widget 的大概步骤如下:

1. 先添加 iOS platform
2. 添加所有依赖的 plugin，包括本插件 cordova-gizwits-siri-shortcut
3. 手动添加 Intents Extension

Target 在 *.xcodeproj 中的排序是不确定的，Cordova 每次都是只拿排在第一的 Target 来操作 (主 App 的 Target 不一定排在第一位)，导致 Cordova 操作了其他的 Target，使得项目报错。所以添加 Intents Extension 必需在完成其他操作后再进行。

一旦添加了 Intents Extension，就不能再更新插件或其他使用 Cordova 命令更新项目的操作。若要进行这些操作，请先移除 iOS 项目再进行，操作完后再重新添加 iOS。

手动添加 Siri Shortcut 指引

支持平台

• iOS

插件添加/移除

# 添加
cordova plugin add cordova-gizwits-siri-shortcut --variable GROUP_ID=group.xxxx
# 移除
cordova plugin rm cordova-gizwits-siri-shortcut

接口使用说明

1. 添加 Siri Shortcut addSiriShortcut

   // 参数
   // url 手动场景执行命令地址 (已拼接 homeId 及 id)
   // version Version 接口版本号
   // sceneId 场景 id
   // sceneName 手动场景名称
   // suggestedInvocationPhrase 建议的 Siri 命令短语
   // icon 图标名称
   params = {"url": "", "version": "", "sceneId": "", "sceneName": "场景名称", "suggestedInvocationPhrase": "执行手动场景1", icon: ""};
   cordova.plugins.gizSiriShortcut.addSiriShortcut(params, success, error);
   

   手动场景执行命令请参考接口说明: http://app-demo1.lease.iotsdk.com/swagger-ui.html#!/2623423478app4525163211602233026223/executeUsingPOST

2. 编辑 Siri Shortcut editSiriShortcut

   // 参数
   // sceneId 场景 id
   // UUID Siri shortcut uuid
   params = {"sceneId": "", "UUID": ""};
   cordova.plugins.gizSiriShortcut.editSiriShortcut(params, success, error);
   

3. Siri Shortcut 是否可用 isSiriShortcutEnabled

   cordova.plugins.gizSiriShortcut.isSiriShortcutEnabled(func (isEnabled) {
       // isEnabled Siri Shortcut 是否可用
       // true 可用
       // false 不可用
   }, error);
   

4. 获取 Siri 授权状态 getSiriAuthorizationStatus

   cordova.plugins.gizSiriShortcut.getSiriAuthorizationStatus(func (status) {
       // status 授权状态值，请参照状态值表
   }, error);
   

5. 请求 Siri 授权 requestSiriAuthorizationStatus

   cordova.plugins.gizSiriShortcut.requestSiriAuthorizationStatus(func (status) {
       // status 授权状态值，请参照状态值表
   }, error);
   

6. 初始化 App Groups setupWithGroupId

   请在 App 启动之后调用该方法初始化 App Groups

   groupId = "group.com.gizwits.xb";
   cordova.plugins.gizSiriShortcut.setupWithGroupId(groupId, success, error);
   

7. 设置 Token setToken

   cordova.plugins.gizSiriShortcut.setToken("your token", success, error);
   

8. 获取 Token getToken

   cordova.plugins.gizSiriShortcut.getToken(func (token) {
       // token
   }, error);
   

9. 获取 Siri Shortcut getSiriShortcut

   // 参数
   // sceneId 场景 id
   sceneId = "";
   cordova.plugins.gizSiriShortcut.getSiriShortcut(sceneId, func (sceneInfo) {
       // sceneInfo 场景 Shortcut 信息 {"sceneId": "", "UUID": ""}
   }, error);
   

10. 获取所有 Siri Shortcut getAllSiriShortcut

    cordova.plugins.gizSiriShortcut.getAllSiriShortcut(func (sceneInfoArray) {
        // sceneInfoArray 场景 Shortcut 信息列表 [{"sceneId": "", "UUID": ""}]
    }, error);
    

状态值表

授权状态值	描述
0	未授权 Authorization status not determined
1	功能不可用 Authorization status restricted
2	拒绝授权 Authorization status denied
3	已授权 Authorization status authorized
4	未知状态 Authorization status unknown