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';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import bundleManager from '@ohos.bundle.bundleManager';
import rpc from '@ohos.rpc';
let connectWant: Want = {
bundleName: 'com.example.myapp',
abilityName: 'MyAbility'
};
let connectOptions: common.ConnectOptions = {
onConnect(elementName: bundleManager.ElementName, remote: rpc.IRemoteObject) {
console.log(`onConnect elementName: ${elementName}`);
},
onDisconnect(elementName: bundleManager.ElementName) {
console.log(`onDisconnect elementName: ${elementName}`);
},
onFailed(code: number) {
console.error(`onFailed code: ${code}`);
}
};
class EntryAbility extends UIAbility {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
let connection: number = this.context.connectServiceExtensionAbility(connectWant, connectOptions);
}
}