ServiceExtensionContext

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

ServiceExtension的上下文环境，提供ServiceExtension具有的能力和接口，继承自ExtensionContext。

startAbility

startAbility(want: Want, callback: AsyncCallback<void>): void;

启动Ability。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

示例：

let want = {
    "bundleName": "com.example.myapp",
    "abilityName": "com.example.myapp.MyAbility"
};
this.context.startAbility(want, (err) => {
    console.log('startAbility result:' + JSON.stringfy(err));
});

ServiceExtensionContext.startAbility

startAbility(want: Want): Promise<void>;

启动Ability。通过Promise返回结果。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

返回值：

示例：

let want = {
    "bundleName": "com.example.myapp",
    "abilityName": "com.example.myapp.MyAbility"
};
this.context.startAbility(want).then((data) => {
    console.log('success:' + JSON.stringfy(data));
}).catch((error) => {
    console.log('failed:' + JSON.stringfy(error));
});

ServiceExtensionContext.terminateSelf

terminateSelf(callback: AsyncCallback<void>): void;

停止Ability自身。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

示例：

this.context.terminateSelf((err) => {
    console.log('terminateSelf result:' + JSON.stringfy(err));
});

ServiceExtensionContext.terminateSelf

terminateSelf(): Promise<void>;

停止自身。通过Promise返回结果。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

this.context.terminateSelf(want).then((data) => {
    console.log('success:' + JSON.stringfy(data));
}).catch((error) => {
    console.log('failed:' + JSON.stringfy(error));
});

ServiceExtensionContext.connectAbility

connectAbility(want: Want, options: ConnectOptions): number;

将一个Ability与服务类型的Ability绑定。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

返回值：

示例：

let want = {
    "bundleName": "com.example.myapp",
    "abilityName": "com.example.myapp.MyAbility"
};
let options = {
    onConnect: function(elementName, proxy) {},
    onDisConnect: function(elementName) {},
    onFailed: function(code) {}
}
let connection = this.context.connectAbility(want,options);

ServiceExtensionContext.disconnectAbility

disconnectAbility(connection: number, callback:AsyncCallback<void>): void;

将一个Ability与绑定的服务类型的Ability解绑。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

示例：

this.context.disconnectAbility(connection, (err) => { // connection为connectAbility中的返回值
    console.log('terminateSelf result:' + JSON.stringfy(err));
});

ServiceExtensionContext.disconnectAbility

disconnectAbility(connection: number): Promise<void>;

将一个Ability与绑定的服务类型的Ability解绑。通过Promise返回结果。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

返回值：

示例：

this.context.disconnectAbility(connection).then((data) => { // connection为connectAbility中的返回值
    console.log('success:' + JSON.stringfy(data));
}).catch((error) => {
    console.log('failed:' + JSON.stringfy(error));
});

ConnectOptions

ConnectOptions数据结构。

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