• 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## 属性
17
18**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.FAModel
19
20| 名称               |   类型   | 必填   | 说明                                    |
21| ------------------- | -------- | ---- | -------------------------------------- |
22| want                | [Want](js-apis-application-want.md)|   是   | 启动Ability的want信息。                     |
23| abilityStartSetting | {[key: string]: any} | 否    | 启动Ability的特殊属性,当开发者启动Ability时,该属性可以作为调用中的输入参数传递。 |
24
25**示例:**
26```ts
27import ability from '@ohos.ability.ability';
28import featureAbility from '@ohos.ability.featureAbility';
29import Want from '@ohos.app.ability.Want';
30
31let want: Want = {
32    bundleName: 'com.example.abilityStartSettingApp2',
33    abilityName: 'com.example.abilityStartSettingApp.EntryAbility',
34};
35
36let startAbilityParameter: ability.StartAbilityParameter = {
37    want : want,
38    abilityStartSetting : {
39        abilityBounds : [100,200,300,400],
40        windowMode :
41        featureAbility.AbilityWindowConfiguration.WINDOW_MODE_UNDEFINED,
42        displayId : 1,
43    }
44};
45
46try {
47    featureAbility.startAbility(startAbilityParameter, (error, data) => {
48        if (error && error.code !== 0) {
49            console.error(`startAbility fail, error: ${JSON.stringify(error)}`);
50        } else {
51            console.log(`startAbility success, data: ${JSON.stringify(data)}`);
52        }
53    });
54} catch(error) {
55    console.error(`startAbility error: ${JSON.stringify(error)}`);
56}
57```