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