Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
e1d8e634
D
Docs
项目概览
OpenHarmony
/
Docs
11 个月 前同步成功
通知
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看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
e1d8e634
编写于
6月 08, 2022
作者:
O
openharmony_ci
提交者:
Gitee
6月 08, 2022
浏览文件
操作
浏览文件
下载
差异文件
!4398 【轻量级 PR】: 【OpenHarmony开源贡献者计划2022】stage-call.md描述优化
Merge pull request !4398 from gloria/N/A
上级
f52417ee
466a3777
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
11 addition
and
11 deletion
+11
-11
zh-cn/application-dev/ability/stage-call.md
zh-cn/application-dev/ability/stage-call.md
+11
-11
未找到文件。
zh-cn/application-dev/ability/stage-call.md
浏览文件 @
e1d8e634
# Call调用开发指导
# Call调用开发指导
## 场景介绍
## 场景介绍
Ability Call调用是Ability能力的扩展,它为Ability提供一种能够被外部调用的能力
。
使Ability既能被拉起到前台展示UI,也支持Ability在后台被创建并运行。应用开发者可通过Call调用,使用IPC通信实现不同Ability之间的数据共享。Call调用的场景主要包括:
Ability Call调用是Ability能力的扩展,它为Ability提供一种能够被外部调用的能力
,
使Ability既能被拉起到前台展示UI,也支持Ability在后台被创建并运行。应用开发者可通过Call调用,使用IPC通信实现不同Ability之间的数据共享。Call调用的场景主要包括:
-
创建Callee被调用端。
-
创建Callee被调用端。
-
访问Callee被调用端。
-
访问Callee被调用端。
...
@@ -37,7 +37,7 @@ Callee被调用端,需要实现指定方法的数据接收回调函数、数
...
@@ -37,7 +37,7 @@ Callee被调用端,需要实现指定方法的数据接收回调函数、数
|Json字段|字段说明|
|Json字段|字段说明|
|:------|:------|
|:------|:------|
|"launchType"|Ability的启动模式,设置为"singleton"类型 |
|"launchType"|Ability的启动模式,设置为"singleton"类型
。
|
Ability配置标签示例如下:
Ability配置标签示例如下:
```
json
```
json
...
@@ -51,11 +51,11 @@ Ability配置标签示例如下:
...
@@ -51,11 +51,11 @@ Ability配置标签示例如下:
"visible"
:
true
"visible"
:
true
}]
}]
```
```
2.
导入Ability模块
2.
导入Ability模块
。
```
```
import Ability from '@ohos.application.Ability'
import Ability from '@ohos.application.Ability'
```
```
3.
定义约定的序列化数据
3.
定义约定的序列化数据
。
调用端及被调用端发送接收的数据格式需协商一致,如下示例约定数据由number和string组成。具体示例代码如下:
调用端及被调用端发送接收的数据格式需协商一致,如下示例约定数据由number和string组成。具体示例代码如下:
```
ts
```
ts
...
@@ -81,7 +81,7 @@ export default class MySequenceable {
...
@@ -81,7 +81,7 @@ export default class MySequenceable {
}
}
}
}
```
```
4.
实现Callee.on监听及Callee.off解除监听
4.
实现Callee.on监听及Callee.off解除监听
。
被调用端Callee的监听函数注册时机, 取决于应用开发者。注册监听之前的数据不会被处理,取消监听之后的数据不会被处理。如下示例在Ability的onCreate注册'CalleeSortMethod'监听,在onDestroy取消监听,收到序列化数据后作相应处理并返回,应用开发者根据实际需要做相应处理。具体示例代码如下:
被调用端Callee的监听函数注册时机, 取决于应用开发者。注册监听之前的数据不会被处理,取消监听之后的数据不会被处理。如下示例在Ability的onCreate注册'CalleeSortMethod'监听,在onDestroy取消监听,收到序列化数据后作相应处理并返回,应用开发者根据实际需要做相应处理。具体示例代码如下:
```
ts
```
ts
...
@@ -121,11 +121,11 @@ export default class CalleeAbility extends Ability {
...
@@ -121,11 +121,11 @@ export default class CalleeAbility extends Ability {
```
```
### 访问Callee被调用端
### 访问Callee被调用端
1.
导入Ability模块
1.
导入Ability模块
。
```
```
import Ability from '@ohos.application.Ability'
import Ability from '@ohos.application.Ability'
```
```
2.
获取Caller通信接口
2.
获取Caller通信接口
。
Ability的context属性实现了startAbilityByCall方法,用于获取指定通用组件的Caller通信接口。如下示例通过
`this.context`
获取Ability实例的context属性,使用startAbilityByCall拉起Callee被调用端并获取Caller通信接口,注册Caller的onRelease监听。应用开发者根据实际需要做相应处理。具体示例代码如下:
Ability的context属性实现了startAbilityByCall方法,用于获取指定通用组件的Caller通信接口。如下示例通过
`this.context`
获取Ability实例的context属性,使用startAbilityByCall拉起Callee被调用端并获取Caller通信接口,注册Caller的onRelease监听。应用开发者根据实际需要做相应处理。具体示例代码如下:
```
ts
```
ts
...
@@ -148,7 +148,7 @@ async onButtonGetCaller() {
...
@@ -148,7 +148,7 @@ async onButtonGetCaller() {
console
.
error
(
TAG
+
'
get caller failed with
'
+
error
)
console
.
error
(
TAG
+
'
get caller failed with
'
+
error
)
})
})
```
```
在跨设备场景下,需指定对端设备deviceId。具体示例代码如下:
在跨设备场景下,需指定对端设备deviceId。具体示例代码如下:
```
ts
```
ts
let
TAG
=
'
[MainAbility]
'
let
TAG
=
'
[MainAbility]
'
var
caller
=
undefined
var
caller
=
undefined
...
@@ -172,7 +172,7 @@ context.startAbilityByCall({
...
@@ -172,7 +172,7 @@ context.startAbilityByCall({
console
.
error
(
TAG
+
'
get remote caller failed with
'
+
error
)
console
.
error
(
TAG
+
'
get remote caller failed with
'
+
error
)
})
})
```
```
从DeviceManager获取指定设备的deviceId,getTrustedDeviceListSync接口仅对系统应用开放。具体示例代码如下:
从DeviceManager获取指定设备的deviceId,getTrustedDeviceListSync接口仅对系统应用开放。具体示例代码如下:
```
ts
```
ts
import
deviceManager
from
'
@ohos.distributedHardware.deviceManager
'
;
import
deviceManager
from
'
@ohos.distributedHardware.deviceManager
'
;
var
dmClass
;
var
dmClass
;
...
@@ -190,7 +190,7 @@ function getRemoteDeviceId() {
...
@@ -190,7 +190,7 @@ function getRemoteDeviceId() {
}
}
}
}
```
```
在跨设备场景下,需要向用户申请数据同步的权限。具体示例代码如下:
在跨设备场景下,需要向用户申请数据同步的权限。具体示例代码如下:
```
ts
```
ts
let
context
=
this
.
context
let
context
=
this
.
context
let
permissions
:
Array
<
string
>
=
[
'
ohos.permission.DISTRIBUTED_DATASYNC
'
]
let
permissions
:
Array
<
string
>
=
[
'
ohos.permission.DISTRIBUTED_DATASYNC
'
]
...
@@ -215,7 +215,7 @@ async onButtonCall() {
...
@@ -215,7 +215,7 @@ async onButtonCall() {
}
}
```
```
如下示例调用CallWithResult接口,向Callee被调用端发送待处理的数据
`originMsg`
,并将'CallSendMsg'方法处理完毕的数据赋值给
`backMsg`
。具体示例代码如下:
如下示例调用CallWithResult接口,向Callee被调用端发送待处理的数据
`originMsg`
,并将'CallSendMsg'方法处理完毕的数据赋值给
`backMsg`
。具体示例代码如下:
```
ts
```
ts
const
MSG_SEND_METHOD
:
string
=
'
CallSendMsg
'
const
MSG_SEND_METHOD
:
string
=
'
CallSendMsg
'
originMsg
:
string
=
''
originMsg
:
string
=
''
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录