• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# StartAbilityParameter
2
3定义启动Ability参数,可以作为入参调用[startAbility](js-apis-ability-featureAbility.md#featureabilitystartability)启动指定的Ability。
4
5> **说明:**
6>
7> 本接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8> 本接口仅可在FA模型下使用
9
10## 导入模块
11
12```ts
13import ability from '@ohos.ability.ability';
14```
15
16**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
17
18| 名称               |   类型   | 必填   | 说明                                    |
19| ------------------- | -------- | ---- | -------------------------------------- |
20| want                | [Want](js-apis-application-want.md)|   是   | 表示需要包含有关目标启动能力的信息。                     |
21| abilityStartSetting | {[key: string]: any} | 否    | 表示能力的特殊属性,当开发者启动能力时,该属性可以作为调用中的输入参数传递。 |
22
23**示例:**
24```ts
25import featureAbility from '@ohos.ability.featureAbility';
26
27let Want = {
28    bundleName: 'com.example.abilityStartSettingApp2',
29    abilityName: 'com.example.abilityStartSettingApp.MainAbility',
30};
31
32let abilityStartSetting ={
33    [featureAbility.AbilityStartSetting.BOUNDS_KEY] : [100,200,300,400],
34    [featureAbility.AbilityStartSetting.WINDOW_MODE_KEY] :
35    featureAbility.AbilityWindowConfiguration.WINDOW_MODE_UNDEFINED,
36    [featureAbility.AbilityStartSetting.DISPLAY_ID_KEY] : 1,
37};
38
39let startAbilityParameter: ability.StartAbilityParameter = {
40    want : Want,
41    abilityStartSetting : abilityStartSetting
42};
43
44featureAbility.startAbility(startAbilityParameter, (err, data)=>{
45    console.log('errCode : ' + JSON.stringify(err));
46    console.log('data : ' + JSON.stringify(data));
47});
48```