使用call事件拉起指定UIAbility到后臺(tái)

許多應(yīng)用希望借助卡片的能力，實(shí)現(xiàn)和應(yīng)用在前臺(tái)時(shí)相同的功能。例如音樂卡片，卡片上提供播放、暫停等按鈕，點(diǎn)擊不同按鈕將觸發(fā)音樂應(yīng)用的不同功能，進(jìn)而提高用戶的體驗(yàn)。在卡片中使用postCardAction接口的call能力，能夠?qū)⒖ㄆ峁┓綉?yīng)用的指定UIAbility拉到后臺(tái)。同時(shí)，call能力提供了調(diào)用應(yīng)用指定方法、傳遞數(shù)據(jù)的功能，使應(yīng)用在后臺(tái)運(yùn)行時(shí)可以通過卡片上的按鈕執(zhí)行不同的功能。

通常使用按鈕控件來觸發(fā)call事件，示例代碼如下：

• 在卡片頁面中布局兩個(gè)按鈕，點(diǎn)擊其中一個(gè)按鈕時(shí)調(diào)用postCardAction向指定UIAbility發(fā)送call事件，并在事件內(nèi)定義需要調(diào)用的方法和傳遞的數(shù)據(jù)。需要注意的是，method參數(shù)為必選參數(shù)，且類型需要為string類型，用于觸發(fā)UIAbility中對(duì)應(yīng)的方法。

  @Entry
  @Component
  struct WidgetCard {
    build() {
      Column() {
        Button('功能A')
          .margin('20%')
          .onClick(() => {
            console.info('call EntryAbility funA');
            postCardAction(this, {
              'action': 'call',
              'abilityName': 'EntryAbility', // 只能跳轉(zhuǎn)到當(dāng)前應(yīng)用下的UIAbility
              'params': {
                'method': 'funA' // 在EntryAbility中調(diào)用的方法名
              }
            });
          })
         Button('功能B')
          .margin('20%')
          .onClick(() => {
            console.info('call EntryAbility funB');
            postCardAction(this, {
              'action': 'call',
              'abilityName': 'EntryAbility', // 只能跳轉(zhuǎn)到當(dāng)前應(yīng)用下的UIAbility
              'params': {
                'method': 'funB', // 在EntryAbility中調(diào)用的方法名
                'num': 1 // 需要傳遞的其他參數(shù)
              }
            });
          })
      }
      .width('100%')
      .height('100%')
    }
  }

• 在UIAbility中接收call事件并獲取參數(shù)，根據(jù)傳遞的method不同，執(zhí)行不同的方法。其余數(shù)據(jù)可以通過readString的方式獲取。需要注意的是，UIAbility需要onCreate生命周期中監(jiān)聽所需的方法。

  import UIAbility from '@ohos.app.ability.UIAbility';
   
  function FunACall(data) {
    // 獲取call事件中傳遞的所有參數(shù)
    console.log('FunACall param:' + JSON.stringify(data.readString()));
    return null;
  }
   function FunBCall(data) {
    console.log('FunACall param:' + JSON.stringify(data.readString()));
    return null;
  }
   
  export default class CameraAbility extends UIAbility {
    // 如果UIAbility第一次啟動(dòng)，在收到call事件后會(huì)觸發(fā)onCreate生命周期回調(diào)
    onCreate(want, launchParam) {
        try {
            // 監(jiān)聽call事件所需的方法
            this.callee.on('funA', FunACall);
            this.callee.on('funB', FunBCall);
        } catch (error) {
            console.log('register failed with error. Cause: ' + JSON.stringify(error));
        }
    }
     
    // 進(jìn)程退出時(shí)，解除監(jiān)聽
    onDestroy() {
        try {
            this.callee.off('funA');
            this.callee.off('funB');
        } catch (error) {
            console.log('register failed with error. Cause: ' + JSON.stringify(error));
        }
    }
  };