使用call事件拉起指定UIAbility到后臺

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

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

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

  @Entry
  @Component
  struct WidgetCard {
    build() {
      Column() {
        Button('功能A')
          .margin('20%')
          .onClick(() => {
            console.info('call EntryAbility funA');
            postCardAction(this, {
              'action': 'call',
              'abilityName': 'EntryAbility', // 只能跳轉(zhuǎn)到當前應用下的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)到當前應用下的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第一次啟動，在收到call事件后會觸發(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));
        }
    }
     
    // 進程退出時，解除監(jiān)聽
    onDestroy() {
        try {
            this.callee.off('funA');
            this.callee.off('funB');
        } catch (error) {
            console.log('register failed with error. Cause: ' + JSON.stringify(error));
        }
    }
  };