Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
ba94f4d0
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
ba94f4d0
编写于
3月 24, 2022
作者:
O
openharmony_ci
提交者:
Gitee
3月 24, 2022
浏览文件
操作
浏览文件
下载
差异文件
!2421 修改文档
Merge pull request !2421 from wuang/master
上级
643e52ae
51c25eab
变更
3
隐藏空白更改
内联
并排
Showing
3 changed file
with
56 addition
and
38 deletion
+56
-38
zh-cn/application-dev/background-task-management/background-task-dev-guide.md
...v/background-task-management/background-task-dev-guide.md
+37
-20
zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md
...ation-dev/reference/apis/js-apis-backgroundTaskManager.md
+14
-13
zh-cn/application-dev/reference/apis/js-apis-particleAbility.md
...application-dev/reference/apis/js-apis-particleAbility.md
+5
-5
未找到文件。
zh-cn/application-dev/background-task-management/background-task-dev-guide.md
浏览文件 @
ba94f4d0
...
...
@@ -106,36 +106,53 @@ ohos.permission.KEEP_BACKGROUND_RUNNING
| function stopBackgroundRunning(context: Context, callback: AsyncCallback
<
void
>
): void;
<br/>
function stopBackgroundRunning(context: Context): Promise
<
void
>
; | 停止后台长时任务的运行 |
其中,wantAgent的信息详见(
[
WantAgent
](
../reference/apis/js-apis-
notification.md#WantAgent接口
)
)
其中,wantAgent的信息详见(
[
WantAgent
](
../reference/apis/js-apis-
wantAgent.md
)
)
**表4**
后台模式类型
| 参数名 | id值 | 描述 |
| -------- | -------- | -------- |
| DATA_TRANSFER | 1 | 数据传输 |
| AUDIO_PLAYBACK | 2 | 音频播放 |
| AUDIO_RECORDING | 3 | 录音 |
| LOCATION | 4 | 定位导航 |
| BLUETOOTH_INTERACTION | 5 | 蓝牙相关 |
| MULTI_DEVICE_CONNECTION | 6 | 多设备互联 |
| WIFI_INTERACTION | 7 | WLAN相关(系统保留) |
| VOIP | 8 | 音视频通话(系统保留) |
| TASK_KEEPING | 9 | 计算任务(仅供PC使用) |
| 参数名 | id值 | 描述 |
配置项 |
| -------- | -------- | -------- |
-------- |
| DATA_TRANSFER | 1 | 数据传输 |
dataTransfer |
| AUDIO_PLAYBACK | 2 | 音频播放 |
audioPlayback |
| AUDIO_RECORDING | 3 | 录音 |
audioRecording |
| LOCATION | 4 | 定位导航 |
location |
| BLUETOOTH_INTERACTION | 5 | 蓝牙相关 |
bluetoothInteraction |
| MULTI_DEVICE_CONNECTION | 6 | 多设备互联 |
multiDeviceConnection |
| WIFI_INTERACTION | 7 | WLAN相关(系统保留) |
wifiInteraction |
| VOIP | 8 | 音视频通话(系统保留) |
voip |
| TASK_KEEPING | 9 | 计算任务(仅供PC使用) |
taskKeeping |
## 开发步骤
1.
在config.json文件中配置长时任务权限
1.
在config.json文件中配置长时任务权限
和后台模式类型,其中ability类型为service。
```json
"module": {
"package": "com.example.myapplication",
...,
"reqPermissions": [
{
"name": "ohos.permission.KEEP_BACKGROUND_RUNNING"
}
]
"package": "com.example.myapplication",
"abilities": [
{
"backgroundModes": [
"dataTransfer",
"location",
],
"type": "service"
}
],
"defPermissions": [
{
"name": "ohos.permission.KEEP_BACKGROUND_RUNNING"
}
],
"reqPermissions": [
{
"name": "ohos.permission.KEEP_BACKGROUND_RUNNING"
}
]
}
```
...
...
zh-cn/application-dev/reference/apis/js-apis-backgroundTaskManager.md
浏览文件 @
ba94f4d0
...
...
@@ -56,6 +56,7 @@ getRemainingDelayTime(requestId: number, callback: AsyncCallback<number>):
| callback | AsyncCallback
<
number
>
| 是 | 指定的callback回调方法。用于返回应用程序进入挂起状态之前的剩余时间,以毫秒为单位。 |
**示例**
:
```
js
let
id
=
1
;
backgroundTaskManager
.
getRemainingDelayTime
(
id
,
(
err
,
res
)
=>
{
...
...
@@ -127,12 +128,12 @@ startBackgroundRunning(context: Context, bgMode: BackgroundMode, wantAgent: Want
**系统能力:**
SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| context |
[
Context
](
js-apis-Context.md
)
| 是 | 应用运行的上下文。 |
| bgMode |
[
BackgroundMode
](
#backgroundmode8
)
| 是 | 向系统申请的后台模式。|
| wantAgent |
[
WantAgent
](
js-apis-notification.md#WantAgent接口
)
| 是 | 通知参数,用于指定长时任务通知点击后跳转的界面。 |
| callback | AsyncCallback
<
void
>
| 是 | callback形式返回启动长时任务的结果。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| context |
[
Context
](
js-apis-Context.md
)
| 是 | 应用运行的上下文。 |
| bgMode |
[
BackgroundMode
](
#backgroundmode8
)
| 是 | 向系统申请的后台模式。|
| wantAgent |
[
WantAgent
](
js-apis-wantAgent.md
)
| 是 | 通知参数,用于指定长时任务通知点击后跳转的界面。 |
| callback | AsyncCallback
<
void
>
| 是 | callback形式返回启动长时任务的结果。 |
**示例**
:
```
js
...
...
@@ -178,13 +179,13 @@ startBackgroundRunning(context: Context, bgMode: BackgroundMode, wantAgent: Want
**系统能力:**
SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| context |
[
Context
](
js-apis-Context.md
)
| 是 | 应用运行的上下文。 |
| bgMode |
[
BackgroundMode
](
#backgroundmode8
)
| 是 | 向系统申请的后台模式。 |
| wantAgent |
[
WantAgent
](
js-apis-notification.md#WantAgent接口
)
| 是 | 通知参数,用于指定长时任务通知点击跳转的界面。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| context |
[
Context
](
js-apis-Context.md
)
| 是 | 应用运行的上下文。 |
| bgMode |
[
BackgroundMode
](
#backgroundmode8
)
| 是 | 向系统申请的后台模式。 |
| wantAgent |
[
WantAgent
](
js-apis-wantAgent.md
)
| 是 | 通知参数,用于指定长时任务通知点击跳转的界面。 |
**返回值**
| 类型 | 说明 |
| -------------- | ------------------------- |
...
...
zh-cn/application-dev/reference/apis/js-apis-particleAbility.md
浏览文件 @
ba94f4d0
...
...
@@ -188,7 +188,7 @@ particleAbility.acquireDataAbilityHelper(uri)
startBackgroundRunning(id: number, request: NotificationRequest, callback: AsyncCallback
<
void
>
): void;
向系统申请长时任务,使用callback形式返回结果
。(此接口为api7接口,后续会被废弃,请使用新的api8接口)
向系统申请长时任务,使用callback形式返回结果
,建议使用新接口
[
backgroundTaskManager.startBackgroundRunning
](
js-apis-backgroundTaskManager.md#backgroundtaskmanagerstartbackgroundrunning8
)
。
**系统能力**
:SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask
...
...
@@ -252,7 +252,7 @@ startBackgroundRunning(id: number, request: NotificationRequest): Promise<voi
**系统能力**
:SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask
向系统申请长时任务,使用promise形式返回结果
。(此接口为api7接口,后续会被废弃,请使用新的api8接口)
向系统申请长时任务,使用promise形式返回结果
,建议使用新接口
[
backgroundTaskManager.startBackgroundRunning
](
js-apis-backgroundTaskManager.md#backgroundtaskmanagerstartbackgroundrunning8-1
)
。
**参数:**
...
...
@@ -313,7 +313,7 @@ wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
cancelBackgroundRunning(callback: AsyncCallback
<
void
>
): void;
向系统申请取消长时任务,使用callback形式返回结果
。(此接口为api7接口,后续会被废弃,请使用新的api8接口)
向系统申请取消长时任务,使用callback形式返回结果
,建议使用新接口
[
backgroundTaskManager.stopBackgroundRunning
](
js-apis-backgroundTaskManager.md#backgroundtaskmanagerstopbackgroundrunning8
)
。
**系统能力**
:SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask
...
...
@@ -344,7 +344,7 @@ particleAbility.cancelBackgroundRunning(callback);
cancelBackgroundRunning(): Promise
<
void
>
;
向系统申请取消长时任务,使用promise形式返回结果
。(此接口为api7接口,后续会被废弃,请使用新的api8接口)
向系统申请取消长时任务,使用promise形式返回结果
,建议使用新接口
[
backgroundTaskManager.stopBackgroundRunning
](
js-apis-backgroundTaskManager.md#backgroundtaskmanagerstopbackgroundrunning8-1
)
。
**系统能力**
:SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask
...
...
@@ -518,7 +518,7 @@ function onConnectCallback(element, remote){
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录