diff --git a/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegator.md b/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegator.md index 1050a4e155dbd46c8d33e46b8cc6acda245dbad6..9910561a8871270d4d384aee118047b7cce0c7d6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegator.md +++ b/zh-cn/application-dev/reference/apis/js-apis-application-abilityDelegator.md @@ -13,404 +13,6 @@ import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry ## AbilityDelegator - -### addAbilityMonitor9+ - -addAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\): void - -添加AbilityMonitor实例（callback形式） - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填说明 | 说明 | -| -------- | ------------------------------------------------------------ | -------- | ------------------------------------------------------------ | -| monitor | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor)实例 | -| callback | AsyncCallback\ | 是 | 表示指定的回调方法 | - -**示例：** - -```js -var abilityDelegator; - -function onAbilityCreateCallback() { - console.info("onAbilityCreateCallback"); -} - -var monitor = { - abilityName: "abilityname", - onAbilityCreate: onAbilityCreateCallback -} - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.addAbilityMonitor(monitor, (err) => { - console.info("addAbilityMonitor callback"); -}); -``` - - - -### addAbilityMonitor9+ - -addAbilityMonitor(monitor: AbilityMonitor): Promise\ - -添加AbilityMonitor实例（promise形式） - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| ------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| monitor | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor)实例 | - -**返回值：** - -| 类型 | 说明 | -| -------------- | ------------------- | -| Promise\ | 以Promise形式返回。 | - -**示例：** - -```js -var abilityDelegator; - -function onAbilityCreateCallback() { - console.info("onAbilityCreateCallback"); -} - -var monitor = { - abilityName: "abilityname", - onAbilityCreate: onAbilityCreateCallback -} - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.addAbilityMonitor(monitor).then(() => { - console.info("addAbilityMonitor promise"); -}); -``` - - - -### removeAbilityMonitor9+ - -removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\): void - -删除已经添加的AbilityMonitor实例（callback形式） - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| monitor | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor)实例 | -| callback | AsyncCallback\ | 是 | 表示指定的回调方法 | - -**示例：** - -```js -var abilityDelegator; - -function onAbilityCreateCallback() { - console.info("onAbilityCreateCallback"); -} - -var monitor = { - abilityName: "abilityname", - onAbilityCreate: onAbilityCreateCallback -} - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.removeAbilityMonitor(monitor, (err) => { - console.info("removeAbilityMonitor callback"); -}); -``` - - - -### removeAbilityMonitor9+ - -removeAbilityMonitor(monitor: AbilityMonitor): Promise\ - -删除已经添加的AbilityMonitor实例（promise形式） - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 名称 | 类型 | 必填 | 说明 | -| ------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| monitor | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor)实例 | - -**返回值：** - -| 类型 | 说明 | -| -------------- | ------------------- | -| Promise\ | 以Promise形式返回。 | - -- 示例 - -```js -var abilityDelegator; - -function onAbilityCreateCallback() { - console.info("onAbilityCreateCallback"); -} - -var monitor = { - abilityName: "abilityname", - onAbilityCreate: onAbilityCreateCallback -} - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.removeAbilityMonitor(monitor).then(() => { - console.info("removeAbilityMonitor promise"); -}); -``` - - - -### waitAbilityMonitor9+ - -waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback\): void - -等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期，并返回ability实例（callback形式） - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| monitor | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor)实例 | -| callback | AsyncCallback\<[Ability](js-apis-application-ability.md#Ability)> | 是 | 表示指定的回调方法 | - -**示例：** - -```js -var abilityDelegator; - -function onAbilityCreateCallback() { - console.info("onAbilityCreateCallback"); -} - -var monitor = { - abilityName: "abilityname", - onAbilityCreate: onAbilityCreateCallback -} - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.waitAbilityMonitor(monitor, (err, data) => { - console.info("waitAbilityMonitor callback"); -}); -``` - - - -### waitAbilityMonitor9+ - -waitAbilityMonitor(monitor: AbilityMonitor, timeout: number, callback: AsyncCallback\): void - -设置等待时间，等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期，并返回ability实例（callback形式） - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| monitor | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor)实例 | -| timeout | number | 是 | 最大等待时间，单位毫秒（ms） | -| callback | AsyncCallback\<[Ability](js-apis-application-ability.md#Ability)> | 是 | 表示指定的回调方法 | - -**示例：** - -```js -var abilityDelegator; -var timeout = 100; - -function onAbilityCreateCallback() { - console.info("onAbilityCreateCallback"); -} - -var monitor = { - abilityName: "abilityname", - onAbilityCreate: onAbilityCreateCallback -} - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.waitAbilityMonitor(monitor, timeout, (err, data) => { - console.info("waitAbilityMonitor callback"); -}); -``` - - - -### waitAbilityMonitor9+ - -waitAbilityMonitor(monitor: AbilityMonitor, timeout?: number): Promise\ - -设置等待时间，等待与AbilityMonitor实例匹配的ability到达OnCreate生命周期，并返回ability实例（promise形式） - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| ------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| monitor | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor) | 是 | [AbilityMonitor](js-apis-application-abilityMonitor.md#AbilityMonitor)实例 | -| timeout | number | 否 | 最大等待时间，单位毫秒（ms） | - -**返回值：** - -| 类型 | 说明 | -| ----------------------------------------------------------- | -------------------------- | -| Promise\<[Ability](js-apis-application-ability.md#Ability)> | 以Promise形式返回Ability。 | - -**示例：** - -```js -var abilityDelegator; - -function onAbilityCreateCallback() { - console.info("onAbilityCreateCallback"); -} - -var monitor = { - abilityName: "abilityname", - onAbilityCreate: onAbilityCreateCallback -} - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.waitAbilityMonitor(monitor).then((data : any) => { - console.info("waitAbilityMonitor promise"); -}); -``` - - - -### getAppContext9+ - -getAppContext(): Context - -获取应用Context - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**返回值：** - -| 类型 | 说明 | -| ------------------------------------- | ------------------------------------------- | -| [Context](js-apis-Context.md#Context) | 应用[Context](js-apis-Context.md#Context)。 | - -**示例：** - -```js -var abilityDelegator; - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -var context = abilityDelegator.getAppContext(); -``` - - - -### getAbilityState9+ - -getAbilityState(ability: Ability): number - -获取指定ability的生命周期状态 - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| ------- | ------------------------------------------------- | ---- | --------------- | -| ability | [Ability](js-apis-application-ability.md#Ability) | 是 | 指定Ability对象 | - -**返回值：** - -| 类型 | 说明 | -| ------ | ------------------------------------------------------------ | -| number | 指定ability的生命周期状态。状态枚举值使用[AbilityLifecycleState](js-apis-abilityDelegatorRegistry.md#AbilityLifecycleState)。 | - -**示例：** - -```js -var abilityDelegator; -var ability; - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.getCurrentTopAbility((err, data) => { - console.info("getCurrentTopAbility callback"); - ability = data; - var state = abilityDelegator.getAbilityState(ability); - console.info("getAbilityState" + state); -}); -``` - - - -### getCurrentTopAbility9+ - -getCurrentTopAbility(callback: AsyncCallback\): void - -获取当前应用顶部ability（callback形式） - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | ------------------------------------------------------------ | ---- | ------------------ | -| callback | AsyncCallback\<[Ability](js-apis-application-ability.md#Ability)> | 是 | 表示指定的回调方法 | - -**示例：** - -```js -var abilityDelegator; -var ability; - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.getCurrentTopAbility((err, data) => { - console.info("getCurrentTopAbility callback"); - ability = data; -}); -``` - - - -### getCurrentTopAbility9+ - -getCurrentTopAbility(): Promise\ - -获取当前应用顶部ability（promise形式） - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**返回值：** - -| 类型 | 说明 | -| ----------------------------------------------------------- | -------------------------------------- | -| Promise\<[Ability](js-apis-application-ability.md#Ability)> | 以Promise形式返回当前应用顶部ability。 | - -**示例：** - -```js -var abilityDelegator; -var ability; - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.getCurrentTopAbility().then((data : any) => { - console.info("getCurrentTopAbility promise"); - ability = data; -}); -``` - - - ### startAbility startAbility(want: Want, callback: AsyncCallback\): void @@ -480,148 +82,6 @@ abilityDelegator.startAbility(want).then((data: any) => { -### doAbilityForeground9+ - -doAbilityForeground(ability: Ability, callback: AsyncCallback\): void - -调度指定ability生命周期状态到Foreground状态（callback形式） - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | ----------------------- | ---- | ------------------------------------------------------- | -| ability | Ability | 是 | 指定Ability对象 | -| callback | AsyncCallback\ | 是 | 表示指定的回调方法
\- true：成功
\- false：失败 | - -**示例：** - -```js -var abilityDelegator; -var ability; - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.getCurrentTopAbility((err, data) => { - console.info("getCurrentTopAbility callback"); - ability = data; - abilityDelegator.doAbilityForeground(ability, (err, data) => { - console.info("doAbilityForeground callback"); - }); -}); -``` - - - -### doAbilityForeground9+ - -doAbilityForeground(ability: Ability): Promise\ - -调度指定ability生命周期状态到Foreground状态（promise形式） - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| ------- | ------- | ---- | --------------- | -| ability | Ability | 是 | 指定Ability对象 | - -**返回值：** - -| 类型 | 说明 | -| ----------------- | ------------------------------------------------------------ | -| Promise\ | 以Promise形式返回执行结果。
\- true：成功
\- false：失败 | - -**示例：** - -```js -var abilityDelegator; -var ability; - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.getCurrentTopAbility((err, data) => { - console.info("getCurrentTopAbility callback"); - ability = data; - abilityDelegator.doAbilityForeground(ability).then((data : any) => { - console.info("doAbilityForeground promise"); - }); -}); -``` - - - -### doAbilityBackground9+ - -doAbilityBackground(ability: Ability, callback: AsyncCallback\): void - -调度指定ability生命周期状态到Background状态（callback形式） - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| -------- | ----------------------- | ---- | ------------------------------------------------------- | -| ability | Ability | 是 | 指定Ability对象 | -| callback | AsyncCallback\ | 是 | 表示指定的回调方法
\- true：成功
\- false：失败 | - -**示例：** - -```js -var abilityDelegator; -var ability; - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.getCurrentTopAbility((err, data) => { - console.info("getCurrentTopAbility callback"); - ability = data; - abilityDelegator.doAbilityBackground(ability, (err, data) => { - console.info("doAbilityBackground callback"); - }); -}); -``` - - - -### doAbilityBackground9+ - -doAbilityBackground(ability: Ability): Promise\ - -调度指定ability生命周期状态到Background状态（promise形式） - -**系统能力：** SystemCapability.Ability.AbilityRuntime.Core - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| ------- | ------- | ---- | --------------- | -| ability | Ability | 是 | 指定Ability对象 | - -**返回值：** - -| 类型 | 说明 | -| ----------------- | ------------------------------------------------------------ | -| Promise\ | 以Promise形式返回执行结果。
\- true：成功
\- false：失败 | - -**示例：** - -```js -var abilityDelegator; -var ability; - -abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator(); -abilityDelegator.getCurrentTopAbility((err, data) => { - console.info("getCurrentTopAbility callback"); - ability = data; - abilityDelegator.doAbilityBackground(ability).then((data) => { - console.info("doAbilityBackground promise"); - }); -}); -``` - - - ### print print(msg: string, callback: AsyncCallback\): void diff --git a/zh-cn/application-dev/reference/apis/js-apis-configuration.md b/zh-cn/application-dev/reference/apis/js-apis-configuration.md index 0a57fb491dbbc3c6ef3bce2536b118c5f42fcf54..50840bac15f9a60a437455cf2645cb0c5cc71261 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-configuration.md +++ b/zh-cn/application-dev/reference/apis/js-apis-configuration.md @@ -22,7 +22,4 @@ import Configuration from '@ohos.application.Configuration'; | 名称 | 参数类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | language | string | 是 | 是 | 表示应用程序的当前语言。 | -| colorMode | [ColorMode](js-apis-configurationconstant.md) | 是 | 是 | 表示深浅色模式，取值范围：浅色模式（COLOR_MODE_LIGHT），深色模式（COLOR_MODE_DARK）。默认为浅色。 | -| direction9+ | Direction | 是 | 否 | 表示屏幕方向，取值范围：水平方向（DIRECTION_HORIZONTAL），垂直方向（DIRECTION_VERTICAL）。 | -| screenDensity9+ | ScreenDensity | 是 | 否 | 表示屏幕分辨率，取值范围：SCREEN_DENSITY_SDPI（120）、SCREEN_DENSITY_MDPI（160）、SCREEN_DENSITY_LDPI（240）、SCREEN_DENSITY_XLDPI（320）、SCREEN_DENSITY_XXLDPI（480）、SCREEN_DENSITY_XXXLDPI（640）。 | -| displayId9+ | number | 是 | 否 | 表示应用所在的displayId。 | +| colorMode | [ColorMode](js-apis-configurationconstant.md) | 是 | 是 | 表示深浅色模式，取值范围：浅色模式（COLOR_MODE_LIGHT），深色模式（COLOR_MODE_DARK）。默认为浅色。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-featureAbility.md b/zh-cn/application-dev/reference/apis/js-apis-featureAbility.md index 498beac2cf35330b742c8aa6451086417062a6a7..baa03c331c41fb8b5e6c1ae736db7cfde9d01f23 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-featureAbility.md +++ b/zh-cn/application-dev/reference/apis/js-apis-featureAbility.md @@ -925,8 +925,6 @@ featureAbility.AbilityStartSetting.BOUNDS_KEY | action | 只读 | string | 否 | 表示action选项描述。 | | parameters | 只读 | {[key: string]: any} | 否 | 表示WantParams描述。 | | entities | 只读 | Array\ | 否 | 表示entities相关描述。 | -| extensionAbilityName9+ | 只读 | string | 否 | Want中扩展能力名称的描述。 | -| extensionAbilityType9+ | 只读 | number | 否 | Want中扩展能力类型的描述。 | ## flags说明 diff --git a/zh-cn/application-dev/reference/apis/js-apis-notification.md b/zh-cn/application-dev/reference/apis/js-apis-notification.md index 95379aa8e493b38cfb95651ebd38610324dbe478..cd1f548b1cb30122659d7af0fef7966914bd0e45 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-notification.md +++ b/zh-cn/application-dev/reference/apis/js-apis-notification.md @@ -2900,7 +2900,6 @@ Notification.subscribe(subscriber, subscribeCallback); | title | 是 | 是 | string | 是 | 按钮标题。 | | wantAgent | 是 | 是 | WantAgent | 是 | 点击按钮时触发的WantAgent。 | | extras | 是 | 是 | { [key: string]: any } | 否 | 按钮扩展信息。 | -| userInput9+ | 是 | 是 | [NotificationUserInput](#notificationuserinput8) | 否 | 用户输入对象实例。 | ## NotificationBasicContent