harmony 鸿蒙ConnectOptions

2022-12-13
浏览 (697)

ConnectOptions

在连接指定的后台服务时作为入参，用于接收连接过程中的状态变化，如作为connectServiceExtensionAbility的入参，连接指定的ServiceExtensionAbility。

说明：

本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import common from '@ohos.app.ability.common';

属性

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

名称	类型	必填	说明
onConnect⁷⁺	function	是	建立连接时的回调函数。
onDisconnect⁷⁺	function	是	断开连接时的回调函数。
onFailed⁷⁺	function	是	连接失败时的回调函数。

示例：

  import UIAbility from '@ohos.app.ability.UIAbility';
  import common from '@ohos.app.ability.common';
  import Want from '@ohos.app.ability.Want';

  let connectWant: Want = {
    bundleName: 'com.example.myapp',
    abilityName: 'MyAbility'
  };

  let connectOptions: common.ConnectOptions = {
    onConnect(elementName, remote) { 
        console.log('onConnect elementName: ${elementName}');
    },
    onDisconnect(elementName) { 
        console.log('onDisconnect elementName: ${elementName}');
    },
    onFailed(code) { 
        console.error('onFailed code: ${code}');
    }
  };

  class EntryAbility extends UIAbility {
    onCreate(want, launchParam) {
      let connection: number = this.context.connectServiceExtensionAbility(connectWant, connectOptions);
    }
  }