AbilityContext

AbilityContext是Ability的上下文環(huán)境，繼承自Context。

AbilityContext模塊提供允許訪問特定于ability的資源的能力，包括對Ability的啟動、停止的設置、獲取caller通信接口、拉起彈窗請求用戶授權等。

說明：

本模塊首批接口從API version 9開始支持。后續(xù)版本的新增接口，采用上角標單獨標記接口的起始版本。
本模塊接口僅可在Stage模型下使用。

使用說明

在使用AbilityContext的功能前，需要通過Ability子類實例獲取。

import Ability from '@ohos.application.Ability'
class MainAbility extends Ability {
    onWindowStageCreate(windowStage) {
        let context = this.context;
    }
}

開發(fā)前請熟悉鴻蒙開發(fā)指導文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]點擊或者復制轉到。

屬性

系統(tǒng)能力 ：以下各項對應的系統(tǒng)能力均為SystemCapability.Ability.AbilityRuntime.Core

AbilityContext.startAbility

startAbility(want: Want, callback: AsyncCallback): void

啟動Ability。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

var want = {
	"deviceId": "",
	"bundleName": "com.extreme.test",
	"abilityName": "MainAbility"
};
this.context.startAbility(want, (error) = > {
    console.log("error.code = " + error.code)
})

AbilityContext.startAbility

startAbility(want: Want, options: StartOptions, callback: AsyncCallback): void

啟動Ability。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

var want = {
	"deviceId": "",
	"bundleName": "com.extreme.test",
	"abilityName": "MainAbility"
};
var options = {
	windowMode: 0,
};
this.context.startAbility(want, options, (error) = > {
    console.log("error.code = " + error.code)
})

AbilityContext.startAbility

startAbility(want: Want, options?: StartOptions): Promise;

啟動Ability。通過Promise返回結果。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

返回值：

示例：

var want = {
	"deviceId": "",
	"bundleName": "com.extreme.test",
	"abilityName": "MainAbility"
};
var options = {
	windowMode: 0,
};
this.context.startAbility(want, options)
.then((data) = > {
    console.log('Operation successful.')
}).catch((error) = > {
    console.log('Operation failed.');
})

AbilityContext.startAbilityForResult

startAbilityForResult(want: Want, callback: AsyncCallback): void;

啟動Ability并在結束的時候返回執(zhí)行結果。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

this.context.startAbilityForResult(
    {bundleName: "com.extreme.myapplication", abilityName: "MainAbilityDemo2"},
    (error, result) = > {
        console.log("startAbilityForResult AsyncCallback is called, error.code = " + error.code)
        console.log("startAbilityForResult AsyncCallback is called, result.resultCode = " + result.resultCode)
     }
);

AbilityContext.startAbilityForResult

startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback): void;

啟動Ability并在結束的時候返回執(zhí)行結果。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

var options = {
  windowMode: 0,
};
this.context.startAbilityForResult(
    {bundleName: "com.extreme.myapplication", abilityName: "MainAbilityDemo2"}, options,
    (error, result) = > {
        console.log("startAbilityForResult AsyncCallback is called, error.code = " + error.code)
        console.log("startAbilityForResult AsyncCallback is called, result.resultCode = " + result.resultCode)
     }
);

AbilityContext.startAbilityForResult

startAbilityForResult(want: Want, options?: StartOptions): Promise;

啟動Ability并在結束的時候返回執(zhí)行結果。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

返回值：

示例：

var options = {
  windowMode: 0,
};
this.context.startAbilityForResult({bundleName: "com.extreme.myapplication", abilityName: "MainAbilityDemo2"}, options).then((result) = > {
    console.log("startAbilityForResult Promise.resolve is called, result.resultCode = " + result.resultCode)
}, (error) = > {
    console.log("startAbilityForResult Promise.Reject is called, error.code = " + error.code)
})

AbilityContext.startAbilityForResultWithAccount

startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback): void;

啟動一個Ability并在該Ability帳號銷毀時返回執(zhí)行結果（callback形式）。

需要權限 : ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統(tǒng)API : 此接口為系統(tǒng)接口，三方應用不支持調(diào)用。

參數(shù)：

示例：

var want = {
  "deviceId": "",
  "bundleName": "com.extreme.test",
  "abilityName": "MainAbility"
};
var accountId = 100;
this.context.startAbilityWithAccount(want, accountId, (err, data) = > {
  console.log('---------- startAbilityWithAccount fail, err:  -----------', err);
  console.log('---------- startAbilityWithAccount success, data:  -----------', data);
});

AbilityContext.startAbilityForResultWithAccount

startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback): void;

啟動一個Ability并在該Ability帳號銷毀時返回執(zhí)行結果（callback形式）。

需要權限 : ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統(tǒng)API : 此接口為系統(tǒng)接口，三方應用不支持調(diào)用。

參數(shù)：

示例：

var want = {
  "deviceId": "",
  "bundleName": "com.extreme.test",
  "abilityName": "MainAbility"
};
var accountId = 100;
var options = {
  windowMode: 0,
};
this.context.startAbilityForResultWithAccount(want, accountId, options, (err) = > {
  console.log('---------- startAbilityForResultWithAccount fail, err:  -----------', err);
});

AbilityContext.startAbilityForResultWithAccount

startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartOptions): Promise;

啟動一個Ability并在該Ability帳號銷毀時返回執(zhí)行結果（callback形式）。

需要權限 : ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統(tǒng)API : 此接口為系統(tǒng)接口，三方應用不支持調(diào)用。

參數(shù)：

返回值：

示例：

var want = {
  "deviceId": "",
  "bundleName": "com.extreme.test",
  "abilityName": "MainAbility"
};
var accountId = 100;
var options = {
  windowMode: 0,
};
this.context.startAbilityForResultWithAccount(want, accountId, options)
  .then((data) = > {
      console.log('---------- startAbilityForResultWithAccount success, data:  -----------', data);
  })
  .catch((err) = > {
      console.log('---------- startAbilityForResultWithAccount fail, err:  -----------', err);
  })

AbilityContext.terminateSelf

terminateSelf(callback: AsyncCallback): void;

停止Ability自身。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

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

AbilityContext.terminateSelf

terminateSelf(): Promise;

停止Ability自身。通過Promise返回結果。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

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

AbilityContext.terminateSelfWithResult

terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback): void;

停止Ability，并返回給調(diào)用startAbilityForResult 接口調(diào)用方的相關信息。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

this.context.terminateSelfWithResult(
   {
        want: {bundleName: "com.extreme.myapplication", abilityName: "MainAbilityDemo"},
        resultCode: 100
    }, (error) = > {
        console.log("terminateSelfWithResult is called = " + error.code)
    }
);

AbilityContext.terminateSelfWithResult

terminateSelfWithResult(parameter: AbilityResult): Promise;

停止Ability，并返回給調(diào)用startAbilityForResult 接口相關信息。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

返回值：

示例：

this.context.terminateSelfWithResult(
{
    want: {bundleName: "com.extreme.myapplication", abilityName: "MainAbilityDemo"},
    resultCode: 100
}).then((result) = > {
    console.log("terminateSelfWithResult")
}
)

AbilityContext.connectAbility

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

使用AbilityInfo.AbilityType.SERVICE模板將當前能力連接到一個能力。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統(tǒng)API : 此接口為系統(tǒng)接口，三方應用不支持調(diào)用。

參數(shù)：

返回值：

示例：

var want = {
  "deviceId": "",
  "bundleName": "com.extreme.test",
  "abilityName": "MainAbility"
};
var options = {
  onConnect(elementName, remote) { console.log('----------- onConnect -----------') },
  onDisconnect(elementName) { console.log('----------- onDisconnect -----------') },
  onFailed(code) { console.log('----------- onFailed -----------') }
}
const result = this.context.connectAbility(want, options);
console.log('----------- connectAbilityResult: ------------', result);

AbilityContext.connectAbilityWithAccount

connectAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number;

使用AbilityInfo.AbilityType.SERVICE模板和account將當前能力連接到一個能力。

需要權限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統(tǒng)API : 此接口為系統(tǒng)接口，三方應用不支持調(diào)用。

參數(shù)：

返回值：

示例：

var want = {
  "deviceId": "",
  "bundleName": "com.extreme.test",
  "abilityName": "MainAbility"
};
var accountId = 100;
var options = {
  onConnect(elementName, remote) { console.log('----------- onConnect -----------') },
  onDisconnect(elementName) { console.log('----------- onDisconnect -----------') },
  onFailed(code) { console.log('----------- onFailed -----------') }
}
const result = this.context.connectAbilityWithAccount(want, accountId, options);
console.log('----------- connectAbilityResult: ------------', result);

AbilityContext.disconnectAbility

disconnectAbility(connection: number): Promise;

已成功連接接口。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統(tǒng)API : 此接口為系統(tǒng)接口，三方應用不支持調(diào)用。

參數(shù)：

返回值：

示例：

var connectionNumber = 0;
this.context.disconnectAbility(connectionNumber).then((data) = > {
     console.log('disconnectAbility success, data: ', data);
}).catch((err) = > {
     console.log('disconnectAbility fail, err: ', err);
});

AbilityContext.disconnectAbility

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

已成功連接接口。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統(tǒng)API : 此接口為系統(tǒng)接口，三方應用不支持調(diào)用。

參數(shù)：

示例：

var connectionNumber = 0;
  this.context.disconnectAbility(connectionNumber, (err) = > {
     console.log('---------- disconnectAbility fail, err: -----------', err);
  });

AbilityContext.startAbilityByCall

startAbilityByCall(want: Want): Promise;

獲取指定通用組件服務端的caller通信接口, 并且將指定通用組件服務端拉起并切換到后臺。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

返回值：

示例：

import Ability from '@ohos.application.Ability';
var caller;
export default class MainAbility extends Ability {
    onWindowStageCreate(windowStage) {
        this.context.startAbilityByCall({
            bundleName: "com.example.myservice",
            abilityName: "MainAbility",
            deviceId: ""
        }).then((obj) = > {
            caller = obj;
            console.log('Caller GetCaller Get ' + caller);
        }).catch((e) = > {
            console.log('Caller GetCaller error ' + e);
        });
    }
}

AbilityContext.startAbilityWithAccount

startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void;

根據(jù)account啟動Ability（callback形式）。

需要權限 : ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統(tǒng)API : 此接口為系統(tǒng)接口，三方應用不支持調(diào)用。

參數(shù)：

示例：

var want = {
  "deviceId": "",
  "bundleName": "com.extreme.test",
  "abilityName": "MainAbility"
};
var accountId = 100;
this.context.startAbilityWithAccount(want, accountId, (err) = > {
  console.log('---------- startAbilityWithAccount fail, err:  -----------', err);
});

AbilityContext.startAbilityWithAccount

startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback): void;

根據(jù)account啟動Ability（callback形式）。

需要權限 : ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統(tǒng)API : 此接口為系統(tǒng)接口，三方應用不支持調(diào)用。

參數(shù)：

示例：

var want = {
  "deviceId": "",
  "bundleName": "com.extreme.test",
  "abilityName": "MainAbility"
};
var accountId = 100;
var options = {
  windowMode: 0,
};
this.context.startAbilityWithAccount(want, accountId, options, (err) = > {
  console.log('---------- startAbilityWithAccount fail, err:  -----------', err);
});

AbilityContext.startAbilityWithAccount

startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise;

根據(jù)account啟動Ability（Promise形式）。

需要權限 : ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統(tǒng)API : 此接口為系統(tǒng)接口，三方應用不支持調(diào)用。

參數(shù)：

示例：

var want = {
  "deviceId": "",
  "bundleName": "com.extreme.test",
  "abilityName": "MainAbility"
};
var accountId = 100;
var options = {
  windowMode: 0,
};
this.context.startAbilityWithAccount(want, accountId, options)
  .then((data) = > {
      console.log('---------- startAbilityWithAccount success, data:  -----------', data);
  })
  .catch((err) = > {
      console.log('---------- startAbilityWithAccount fail, err:  -----------', err);
  })

AbilityContext.requestPermissionsFromUser

requestPermissionsFromUser(permissions: Array, requestCallback: AsyncCallback) : void;

拉起彈窗請求用戶授權。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

var permissions=['com.example.permission']
     this.context.requestPermissionsFromUser(permissions,(result) = > {
     console.log('requestPermissionsFromUserresult:' + JSON.stringify(result));
});

AbilityContext.requestPermissionsFromUser

requestPermissionsFromUser(permissions: Array) : Promise;

拉起彈窗請求用戶授權。通過Promise返回結果。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

返回值：

示例：

var permissions=['com.example.permission']
     this.context.requestPermissionsFromUser(permissions).then((data) = > {
    console.log('success:' + JSON.stringify(data));
}).catch((error) = > {
    console.log('failed:' + JSON.stringify(error));
});

AbilityContext.setMissionLabel

setMissionLabel(label: string, callback:AsyncCallback): void;

設置ability在任務中顯示的名稱。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

this.context.setMissionLabel("test",(result) = > {
    console.log('requestPermissionsFromUserresult:' + JSON.stringify(result));
});

AbilityContext.setMissionLabel

setMissionLabel(label: string): Promise

設置ability在任務中顯示的名稱。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

返回值：

示例：

this.context.setMissionLabel("test").then((data) = > {
    console.log('success:' + JSON.stringify(data));
}).catch((error) = > {
    console.log('failed:' + JSON.stringify(error));
});

AbilityContext.setMissionIcon

setMissionIcon(icon: image.PixelMap, callback:AsyncCallback): void;

設置當前ability的任務標簽。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統(tǒng)API : 此接口為系統(tǒng)接口，三方應用不支持調(diào)用。

參數(shù)：

示例：

import image from '@ohos.multimedia.image'
  var imagePixelMap;
  var color = new ArrayBuffer(0);
  var initializationOptions = {
     size: {
         height: 100,
         width: 100
     }
  };
  image.createPixelMap(color, initializationOptions)
     .then((data) = > {
         imagePixelMap = data;
     })
     .catch((err) = > {
         console.log('--------- createPixelMap fail, err: ---------', err)
     });
  this.context.setMissionIcon(imagePixelMap, (err) = > {
     console.log('---------- setMissionIcon fail, err: -----------', err);
  })

AbilityContext.setMissionIcon

setMissionIcon(icon: image.PixelMap): Promise;

設置當前ability的任務標簽。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

系統(tǒng)API : 此接口為系統(tǒng)接口，三方應用不支持調(diào)用。

參數(shù)：

返回值：

示例：

import image from '@ohos.multimedia.image'
  var imagePixelMap;
  var color = new ArrayBuffer(0);
  var initializationOptions = {
    size: {
        height: 100,
        width: 100
    }
  };
  image.createPixelMap(color, initializationOptions)
    .then((data) = > {
        imagePixelMap = data;
    })
    .catch((err) = > {
        console.log('--------- createPixelMap fail, err: ---------', err)
    });
  this.context.setMissionIcon(imagePixelMap)
    .then((data) = > {
        console.log('-------------- setMissionIcon success, data: -------------', data);
    })
    .catch((err) = > {
        console.log('-------------- setMissionIcon fail, err: -------------', err);
    });

AbilityContext.restoreWindowStage

restoreWindowStage(localStorage: LocalStorage) : void;

恢復ability中的window stage數(shù)據(jù)。

系統(tǒng)能力 ：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

var storage = new LocalStorage();
  this.context.restoreWindowStage(storage);

審核編輯 黃宇