未验证 提交 240e43b9 编写于 作者: O openharmony_ci 提交者: Gitee

!23077 arkts 指导文档示例代码规范化整改

Merge pull request !23077 from hunili/master
...@@ -60,10 +60,10 @@ ...@@ -60,10 +60,10 @@
```json ```json
{ {
"module": { "module": {
... // ...
"abilities": [ "abilities": [
{ {
... // ...
"continuable": true, "continuable": true,
} }
] ]
...@@ -84,20 +84,24 @@ ...@@ -84,20 +84,24 @@
- 迁移决策:开发者可以通过onContinue接口的返回值决定是否支持此次迁移,返回值信息见[接口说明](#接口说明) - 迁移决策:开发者可以通过onContinue接口的返回值决定是否支持此次迁移,返回值信息见[接口说明](#接口说明)
示例如下: 示例如下:
```ts
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
onContinue(wantParam : {[key: string]: Object}) { ```ts
console.info(`onContinue version = ${wantParam.version}, targetDevice: ${wantParam.targetDevice}`) //准备迁移数据 import UIAbility from '@ohos.app.ability.UIAbility';
let continueInput = '迁移的数据'; import AbilityConstant from '@ohos.app.ability.AbilityConstant';
// 将要迁移的数据保存在wantParam的自定义字段(如:data)中;
wantParam["data"] = continueInput export default class EntryAbility extends UIAbility {
console.info(`onContinue input = ${wantParam["input"]}`); onContinue(wantParam: Record<string, Object>) {
return AbilityConstant.OnContinueResult.AGREE console.info(`onContinue version = ${wantParam.version}, targetDevice: ${wantParam.targetDevice}`) // 准备迁移数据
} let continueInput = '迁移的数据';
``` if (continueInput) {
// 将要迁移的数据保存在wantParam的自定义字段(如:data)中;
wantParam["data"] = continueInput;
}
console.info(`onContinue input = ${wantParam["data"]}`);
return AbilityConstant.OnContinueResult.AGREE;
}
}
```
5.在Stage模型中,应用在不同启动模式下将调用不同的接口,以恢复数据、加载界面。 5.在Stage模型中,应用在不同启动模式下将调用不同的接口,以恢复数据、加载界面。
...@@ -113,42 +117,51 @@ onContinue(wantParam : {[key: string]: Object}) { ...@@ -113,42 +117,51 @@ onContinue(wantParam : {[key: string]: Object}) {
- 完成数据恢复后,开发者需要调用restoreWindowStage来触发页面恢复:包括页面栈信息。 - 完成数据恢复后,开发者需要调用restoreWindowStage来触发页面恢复:包括页面栈信息。
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant'; import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import Want from '@ohos.app.ability.Want';
export default class EntryAbility extends UIAbility {
storage : LocalStorage; export default class EntryAbility extends UIAbility {
onCreate(want, launchParam) { storage : LocalStorage = new LocalStorage();
console.info(`EntryAbility onCreate ${AbilityConstant.LaunchReason.CONTINUATION}`) onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
if (launchParam.launchReason == AbilityConstant.LaunchReason.CONTINUATION) { console.info(`EntryAbility onCreate ${AbilityConstant.LaunchReason.CONTINUATION}`)
// 将上述的保存的数据取出恢复 if (launchParam.launchReason == AbilityConstant.LaunchReason.CONTINUATION) {
let continueInput = want.parameters.data // 将上述的保存的数据取出恢复
console.info(`continue input ${continueInput}`) let continueInput = '';
// 将数据显示当前页面 if (want.parameters != undefined) {
this.storage = new LocalStorage(); continueInput = JSON.stringify(want.parameters.data);
this.context.restoreWindowStage(this.storage); console.info(`continue input ${continueInput}`)
} }
} // 将数据显示当前页面
this.context.restoreWindowStage(this.storage);
}
}
} }
``` ```
- 如果是单实例应用,需要额外实现onNewWant接口,实现方式与onCreate的实现相同。 - 如果是单实例应用,需要额外实现onNewWant接口,实现方式与onCreate的实现相同。
- 在onNewWant中判断迁移场景,恢复数据,并触发页面恢复 - 在onNewWant中判断迁移场景,恢复数据,并触发页面恢复
```ts ```ts
export default class EntryAbility extends UIAbility { import UIAbility from '@ohos.app.ability.UIAbility';
storage : LocalStorage; import AbilityConstant from '@ohos.app.ability.AbilityConstant';
onNewWant(want, launchParam) { import Want from '@ohos.app.ability.Want';
console.info(`EntryAbility onNewWant ${AbilityConstant.LaunchReason.CONTINUATION}`)
if (launchParam.launchReason == AbilityConstant.LaunchReason.CONTINUATION) { export default class EntryAbility extends UIAbility {
// get user data from want params storage : LocalStorage = new LocalStorage();
let continueInput = want.parameters.data onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {
console.info(`continue input ${continueInput}`) console.info(`EntryAbility onNewWant ${AbilityConstant.LaunchReason.CONTINUATION}`)
this.storage = new LocalStorage(); if (launchParam.launchReason == AbilityConstant.LaunchReason.CONTINUATION) {
this.context.restoreWindowStage(this.storage); // get user data from want params
} let continueInput = '';
} if (want.parameters != undefined) {
continueInput = JSON.stringify(want.parameters.data);
console.info(`continue input ${continueInput}`);
}
this.context.restoreWindowStage(this.storage);
}
} }
``` }
```
...@@ -171,12 +184,17 @@ onContinue(wantParam : {[key: string]: Object}) { ...@@ -171,12 +184,17 @@ onContinue(wantParam : {[key: string]: Object}) {
```ts ```ts
// EntryAbility.ets // EntryAbility.ets
onCreate(want, launchParam) { import UIAbility from '@ohos.app.ability.UIAbility';
... import AbilityConstant from '@ohos.app.ability.AbilityConstant';
this.context.setMissionContinueState(AbilityConstant.ContinueState.ACTIVE, (result) => { import Want from '@ohos.app.ability.Want';
console.info('setMissionContinueState ACTIVE result: ', JSON.stringify(result)); export default class EntryAbility extends UIAbility {
}; onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
... // ...
this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result) => {
console.info(`setMissionContinueState: ${JSON.stringify(result)}`);
});
// ...
}
} }
``` ```
...@@ -184,16 +202,21 @@ onCreate(want, launchParam) { ...@@ -184,16 +202,21 @@ onCreate(want, launchParam) {
```ts ```ts
// PageName.ets // PageName.ets
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import common from '@ohos.app.ability.common'
@Entry
@Component
struct PageName { struct PageName {
Build() { private context = getContext(this) as common.UIAbilityContext;
... build() {
// ...
} }
... // ...
onPageShow(){ onPageShow(){
// 进入该页面时,将应用设置为可迁移状态 // 进入该页面时,将应用设置为可迁移状态
this.context.setMissionContinueState(AbilityConstant.ContinueState.ACTIVE, (result) => { this.context.setMissionContinueState(AbilityConstant.ContinueState.ACTIVE, (result) => {
console.info('setMissionContinueState ACTIVE result: ', JSON.stringify(result)); console.info('setMissionContinueState ACTIVE result: ', JSON.stringify(result));
}; });
} }
} }
``` ```
...@@ -201,16 +224,25 @@ struct PageName { ...@@ -201,16 +224,25 @@ struct PageName {
在某个组件的触发事件中设置应用迁移能力。如下例中,使用 **Button** 组件的 **onClick** 事件,触发迁移能力的改变。 在某个组件的触发事件中设置应用迁移能力。如下例中,使用 **Button** 组件的 **onClick** 事件,触发迁移能力的改变。
```ts ```ts
// xxx.ets // PageName.ets
Button(){ import AbilityConstant from '@ohos.app.ability.AbilityConstant';
... import common from '@ohos.app.ability.common'
@Entry
@Component
struct PageName {
private context = getContext(this) as common.UIAbilityContext;
build() {
// ...
Button() {
//...
}.onClick(()=>{
//点击该按钮时,将应用设置为可迁移状态
this.context.setMissionContinueState(AbilityConstant.ContinueState.ACTIVE, (result) => {
console.info('setMissionContinueState ACTIVE result: ', JSON.stringify(result));
});
})
}
} }
.onClick(()=>{
//点击该按钮时,将应用设置为可迁移状态
this.context.setMissionContinueState(AbilityConstant.ContinueState.ACTIVE, (result) => {
console.info('setMissionContinueState ACTIVE result: ', JSON.stringify(result));
};
})
``` ```
**保证迁移连续性** **保证迁移连续性**
...@@ -219,24 +251,28 @@ Button(){ ...@@ -219,24 +251,28 @@ Button(){
```ts ```ts
// EntryAbility.ets // EntryAbility.ets
onCreate(want, launchparam) { import UIAbility from '@ohos.app.ability.UIAbility';
... import AbilityConstant from '@ohos.app.ability.AbilityConstant';
// 调用原因为迁移时,设置状态为可迁移,应对冷启动情况 import Want from '@ohos.app.ability.Want';
if (launchParam.launchReason == AbilityConstant.LaunchReason.CONTINUATION) { export default class EntryAbility extends UIAbility {
this.context.setMissionContinueState(AbilityConstant.ContinueState.ACTIVE, (result) => { // ...
console.info('setMissionContinueState ACTIVE result: ', JSON.stringify(result)); onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
}; // ...
// 调用原因为迁移时,设置状态为可迁移,应对冷启动情况
this.context.setMissionContinueState(AbilityConstant.ContinueState.INACTIVE, (result) => {
console.info(`setMissionContinueState: ${JSON.stringify(result)}`);
});
} }
} onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {
// ...
onNewWant(want, launchparam) { // 调用原因为迁移时,设置状态为可迁移,应对热启动情况
... if (launchParam.launchReason == AbilityConstant.LaunchReason.CONTINUATION) {
// 调用原因为迁移时,设置状态为可迁移,应对热启动情况 this.context.setMissionContinueState(AbilityConstant.ContinueState.ACTIVE, (result) => {
if (launchParam.launchReason == AbilityConstant.LaunchReason.CONTINUATION) { console.info('setMissionContinueState ACTIVE result: ', JSON.stringify(result));
this.context.setMissionContinueState(AbilityConstant.ContinueState.ACTIVE, (result) => { });
console.info('setMissionContinueState ACTIVE result: ', JSON.stringify(result)); }
};
} }
// ...
} }
``` ```
...@@ -251,18 +287,29 @@ onNewWant(want, launchparam) { ...@@ -251,18 +287,29 @@ onNewWant(want, launchparam) {
- 示例:应用迁移不需要自动迁移页面栈信息 - 示例:应用迁移不需要自动迁移页面栈信息
```ts ```ts
// EntryAbility.ets
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import wantConstant from '@ohos.app.ability.wantConstant'; import wantConstant from '@ohos.app.ability.wantConstant';
import window from '@ohos.window';
onContinue(wantParam : {[key: string]: Object}) { export default class EntryAbility extends UIAbility {
console.info(`onContinue version = ${wantParam.version}, targetDevice: ${wantParam.targetDevice}`) // ...
onContinue(wantParam: Record<string, Object>) {
console.info(`onContinue version = ${wantParam.version}, targetDevice: ${wantParam.targetDevice}`);
wantParam[wantConstant.Params.SUPPORT_CONTINUE_PAGE_STACK_KEY] = false; wantParam[wantConstant.Params.SUPPORT_CONTINUE_PAGE_STACK_KEY] = false;
return AbilityConstant.OnContinueResult.AGREE; return AbilityConstant.OnContinueResult.AGREE;
} }
// ...
onWindowStageRestore(windowStage) { onWindowStageRestore(windowStage: window.WindowStage) {
// 若不需要自动迁移页面栈信息,则需要在此处设置应用迁移后进入的页面 // 若不需要自动迁移页面栈信息,则需要在此处设置应用迁移后进入的页面
windowStage.setUIContent(this.contex, "pages/index", null); windowStage.loadContent('pages/Index', (err, data) => {
if (err.code) {
console.info('Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
return;
}
console.info('Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');
});
}
} }
``` ```
...@@ -274,12 +321,16 @@ onNewWant(want, launchparam) { ...@@ -274,12 +321,16 @@ onNewWant(want, launchparam) {
```ts ```ts
import UIAbility from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
import wantConstant from '@ohos.app.ability.wantConstant'; import wantConstant from '@ohos.app.ability.wantConstant';
export default class EntryAbility extends UIAbility {
onContinue(wantParam : {[key: string]: Object}) { // ...
console.info(`onContinue version = ${wantParam.version}, targetDevice: ${wantParam.targetDevice}`) onContinue(wantParam: Record<string, Object>) {
console.info(`onContinue version = ${wantParam.version}, targetDevice: ${wantParam.targetDevice}`);
wantParam[wantConstant.Params.SUPPORT_CONTINUE_SOURCE_EXIT_KEY] = false; wantParam[wantConstant.Params.SUPPORT_CONTINUE_SOURCE_EXIT_KEY] = false;
return AbilityConstant.OnContinueResult.AGREE; return AbilityConstant.OnContinueResult.AGREE;
}
// ...
} }
``` ```
......
...@@ -57,22 +57,22 @@ ...@@ -57,22 +57,22 @@
```ts ```ts
import deviceManager from '@ohos.distributedDeviceManager'; import deviceManager from '@ohos.distributedDeviceManager';
let dmClass: deviceManager.DeviceManager; let dmClass: deviceManager.DeviceManager;
function initDmClass() { function initDmClass() {
// 其中createDeviceManager接口为系统API // 其中createDeviceManager接口为系统API
try{ try{
dmClass = deviceManager.createDeviceManager('ohos.samples.demo'); dmClass = deviceManager.createDeviceManager('ohos.samples.demo');
} catch(err) { } catch(err) {
console.error("createDeviceManager errCode:" + err.code + ",errMessage:" + err.message); console.error("createDeviceManager err: " + JSON.stringify(err));
} }
} }
function getRemoteDeviceId() { function getRemoteDeviceId() {
if (typeof dmClass === 'object' && dmClass !== null) { if (typeof dmClass === 'object' && dmClass !== null) {
let list = dmClass.getAvailableDeviceListSync(); let list = dmClass.getAvailableDeviceListSync();
if (typeof (list) === 'undefined' || typeof (list.length) === 'undefined') { if (typeof (list) === 'undefined' || typeof (list.length) === 'undefined') {
console.info('getRemoteDeviceId err: list is null'); console.info('getRemoteDeviceId err: list is null');
return; return;
} }
if (list.length === 0) { if (list.length === 0) {
console.info("getRemoteDeviceId err: list is empty"); console.info("getRemoteDeviceId err: list is empty");
...@@ -81,6 +81,7 @@ ...@@ -81,6 +81,7 @@
return list[0].networkId; return list[0].networkId;
} else { } else {
console.info('getRemoteDeviceId err: dmClass is null'); console.info('getRemoteDeviceId err: dmClass is null');
return;
} }
} }
``` ```
...@@ -88,24 +89,29 @@ ...@@ -88,24 +89,29 @@
4. 设置目标组件参数,调用[`startAbility()`](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability)接口,启动UIAbility或ServiceExtensionAbility。 4. 设置目标组件参数,调用[`startAbility()`](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstartability)接口,启动UIAbility或ServiceExtensionAbility。
```ts ```ts
let want = { import { BusinessError } from '@ohos.base';
deviceId: getRemoteDeviceId(), import Want from '@ohos.app.ability.Want';
let want: Want = {
deviceId: getRemoteDeviceId(),
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'EntryAbility', abilityName: 'EntryAbility',
moduleName: 'entry', // moduleName非必选 moduleName: 'entry', // moduleName非必选
} }
// context为发起端UIAbility的AbilityContext // context为发起端UIAbility的AbilityContext
this.context.startAbility(want).then(() => { this.context.startAbility(want).then(() => {
... // ...
}).catch((err) => { }).catch((err: BusinessError) => {
... // ...
console.error("startAbility err: " + JSON.stringify(err));
}) })
``` ```
5. 当设备A发起端应用不需要设备B上的ServiceExtensionAbility时,可调用[stopServiceExtensionAbility](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstopserviceextensionability)接口退出。(该接口不支持UIAbility的退出,UIAbility由用户手动通过任务管理退出) 5. 当设备A发起端应用不需要设备B上的ServiceExtensionAbility时,可调用[stopServiceExtensionAbility](../reference/apis/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextstopserviceextensionability)接口退出。(该接口不支持UIAbility的退出,UIAbility由用户手动通过任务管理退出)
```ts ```ts
let want = { import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
let want: Want = {
deviceId: getRemoteDeviceId(), deviceId: getRemoteDeviceId(),
bundleName: 'com.example.myapplication', bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility', abilityName: 'FuncAbility',
...@@ -114,7 +120,7 @@ ...@@ -114,7 +120,7 @@
// 退出由startAbility接口启动的ServiceExtensionAbility // 退出由startAbility接口启动的ServiceExtensionAbility
this.context.stopServiceExtensionAbility(want).then(() => { this.context.stopServiceExtensionAbility(want).then(() => {
console.info("stop service extension ability success") console.info("stop service extension ability success")
}).catch((err) => { }).catch((err: BusinessError) => {
console.info("stop service extension ability err is " + JSON.stringify(err)) console.info("stop service extension ability err is " + JSON.stringify(err))
}) })
``` ```
...@@ -144,55 +150,107 @@ ...@@ -144,55 +150,107 @@
3. 在发起端设置目标组件参数,调用startAbilityForResult()接口启动目标端UIAbility,异步回调中的data用于接收目标端UIAbility停止自身后返回给调用方UIAbility的信息。getRemoteDeviceId方法参照[通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据](#通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据) 3. 在发起端设置目标组件参数,调用startAbilityForResult()接口启动目标端UIAbility,异步回调中的data用于接收目标端UIAbility停止自身后返回给调用方UIAbility的信息。getRemoteDeviceId方法参照[通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据](#通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据)
```ts ```ts
let want = { import AbilityConstant from '@ohos.app.ability.AbilityConstant';
deviceId: getRemoteDeviceId(), import common from '@ohos.app.ability.common';
bundleName: 'com.example.myapplication', import { BusinessError } from '@ohos.base';
abilityName: 'FuncAbility', import Want from '@ohos.app.ability.Want';
moduleName: 'module1', // moduleName非必选 @Entry
@Component
struct PageName {
private context = getContext(this) as common.UIAbilityContext;
build() {
// ...
Button('StartAbilityForResult')
.onClick(()=>{
let want: Want = {
deviceId: getRemoteDeviceId(),
bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility',
moduleName: 'module1', // moduleName非必选
}
// context为发起端UIAbility的AbilityContext
this.context.startAbilityForResult(want).then((data) => {
// ...
}).catch((error: BusinessError) => {
console.info("startAbilityForResult err: " + JSON.stringify(error));
})
}
)
}
} }
// context为发起端UIAbility的AbilityContext
this.context.startAbilityForResult(want).then((data) => {
...
}).catch((err) => {
...
})
``` ```
4. 在目标端UIAbility任务完成后,调用terminateSelfWithResult()方法,将数据返回给发起端的UIAbility。 4. 在目标端UIAbility任务完成后,调用terminateSelfWithResult()方法,将数据返回给发起端的UIAbility。
```ts ```ts
const RESULT_CODE: number = 1001; import { BusinessError } from '@ohos.base';
let abilityResult = { import common from '@ohos.app.ability.common';
resultCode: RESULT_CODE, @Entry
want: { @Component
bundleName: 'com.example.myapplication', struct PageName {
abilityName: 'FuncAbility', private context = getContext(this) as common.UIAbilityContext;
moduleName: 'module1', build() {
}, // ...
Button('terminateSelfWithResult')
.onClick(()=>{
const RESULT_CODE: number = 1001;
// context为目标端UIAbility的AbilityContext
this.context.terminateSelfWithResult(
{
resultCode: RESULT_CODE,
want: {
bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility',
moduleName: 'module1',
},
},
(err: BusinessError) => {
// ...
console.info("terminateSelfWithResult err: " + JSON.stringify(err));
});
}
// ...
)
}
} }
// context为目标端UIAbility的AbilityContext
this.context.terminateSelfWithResult(abilityResult, (err) => {
...
});
``` ```
5. 发起端UIAbility接收到目标端UIAbility返回的信息,对其进行处理。 5. 发起端UIAbility接收到目标端UIAbility返回的信息,对其进行处理。
```ts ```ts
const RESULT_CODE: number = 1001; import common from '@ohos.app.ability.common';
import { BusinessError } from '@ohos.base';
... import Want from '@ohos.app.ability.Want';
@Entry
// context为调用方UIAbility的UIAbilityContext @Component
this.context.startAbilityForResult(want).then((data) => { struct PageName {
if (data?.resultCode === RESULT_CODE) { private context = getContext(this) as common.UIAbilityContext;
// 解析目标端UIAbility返回的信息 build() {
let info = data.want?.parameters?.info // ...
... Button('StartAbilityForResult')
} .onClick(()=>{
}).catch((err) => { let want: Want = {
... deviceId: getRemoteDeviceId(),
}) bundleName: 'com.example.myapplication',
abilityName: 'FuncAbility',
moduleName: 'module1', // moduleName非必选
}
const RESULT_CODE: number = 1001;
// ...
// context为调用方UIAbility的UIAbilityContext
this.context.startAbilityForResult(want).then((data) => {
if (data?.resultCode === RESULT_CODE) {
// 解析目标端UIAbility返回的信息
let info = data.want?.parameters?.info;
// ...
}
}).catch((error: BusinessError) => {
// ...
})
}
)
}
}
``` ```
...@@ -229,48 +287,60 @@ ...@@ -229,48 +287,60 @@
```ts ```ts
import rpc from '@ohos.rpc'; import rpc from '@ohos.rpc';
import Want from '@ohos.app.ability.Want';
const REQUEST_CODE = 99; import common from '@ohos.app.ability.common';
let want = { import { BusinessError } from '@ohos.base';
"deviceId": getRemoteDeviceId(), @Entry
"bundleName": "com.example.myapplication", @Component
"abilityName": "ServiceExtAbility" struct PageName {
}; private context = getContext(this) as common.UIAbilityContext;
let options = { build() {
onConnect(elementName, remote) { // ...
console.info('onConnect callback'); Button('connectServiceExtensionAbility')
if (remote === null) { .onClick(()=>{
console.info(`onConnect remote is null`); const REQUEST_CODE = 99;
return; let want: Want = {
} "deviceId": getRemoteDeviceId(),
let option = new rpc.MessageOption(); "bundleName": "com.example.myapplication",
let data = new rpc.MessageParcel(); "abilityName": "ServiceExtAbility"
let reply = new rpc.MessageParcel(); };
data.writeInt(1); // 建立连接后返回的Id需要保存下来,在解绑服务时需要作为参数传入
data.writeInt(99); // 开发者可发送data到目标端应用进行相应操作 let connectionId = this.context.connectServiceExtensionAbility(want,
{
// @param code 表示客户端发送的服务请求代码。 onConnect(elementName, remote) {
// @param data 表示客户端发送的{@link MessageParcel}对象。 console.info('onConnect callback');
// @param reply 表示远程服务发送的响应消息对象。 if (remote === null) {
// @param options 指示操作是同步的还是异步的。 console.info(`onConnect remote is null`);
// return;
// @return 如果操作成功返回{@code true}; 否则返回 {@code false}。 }
remote.sendRequest(REQUEST_CODE, data, reply, option).then((ret) => { let option = new rpc.MessageOption();
let msg = reply.readInt(); // 在成功连接的情况下,会收到来自目标端返回的信息(100) let data = new rpc.MessageParcel();
console.info(`sendRequest ret:${ret} msg:${msg}`); let reply = new rpc.MessageParcel();
}).catch((error) => { data.writeInt(1);
console.info('sendRequest failed'); data.writeInt(99); // 开发者可发送data到目标端应用进行相应操作
}); // @param code 表示客户端发送的服务请求代码。
}, // @param data 表示客户端发送的{@link MessageParcel}对象。
onDisconnect(elementName) { // @param reply 表示远程服务发送的响应消息对象。
console.info('onDisconnect callback'); // @param options 指示操作是同步的还是异步的。
}, //
onFailed(code) { // @return 如果操作成功返回{@code true}; 否则返回 {@code false}。
console.info('onFailed callback'); remote.sendRequest(REQUEST_CODE, data, reply, option).then((ret: rpc.SendRequestResult) => {
let msg = reply.readInt(); // 在成功连接的情况下,会收到来自目标端返回的信息(100)
console.info(`sendRequest ret:${ret} msg:${msg}`);
}).catch((error: BusinessError) => {
console.info('sendRequest failed');
});
},
onDisconnect(elementName) {
console.info('onDisconnect callback');
},
onFailed(code) {
console.info('onFailed callback');
}
});
})
} }
} }
// 建立连接后返回的Id需要保存下来,在解绑服务时需要作为参数传入
let connectionId = this.context.connectServiceExtensionAbility(want, options);
``` ```
getRemoteDeviceId方法参照[通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据](#通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据)。 getRemoteDeviceId方法参照[通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据](#通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据)。
...@@ -278,12 +348,25 @@ ...@@ -278,12 +348,25 @@
5. 断开连接。调用disconnectServiceExtensionAbility()断开与后台服务的连接。 5. 断开连接。调用disconnectServiceExtensionAbility()断开与后台服务的连接。
```ts ```ts
let connectionId = 1 // 在通过connectServiceExtensionAbility绑定服务时返回的Id import common from '@ohos.app.ability.common';
this.context.disconnectServiceExtensionAbility(connectionId).then((data) => { import { BusinessError } from '@ohos.base';
console.info('disconnectServiceExtensionAbility success'); @Entry
}).catch((error) => { @Component
console.error('disconnectServiceExtensionAbility failed'); struct PageName {
}) private context = getContext(this) as common.UIAbilityContext;
build() {
// ...
Button('disconnectServiceExtensionAbility')
.onClick(()=>{
let connectionId: number = 1 // 在通过connectServiceExtensionAbility绑定服务时返回的Id
this.context.disconnectServiceExtensionAbility(connectionId).then(() => {
console.info('disconnectServiceExtensionAbility success');
}).catch((error: BusinessError) => {
console.error('disconnectServiceExtensionAbility failed');
})
})
}
}
``` ```
...@@ -342,29 +425,30 @@ ...@@ -342,29 +425,30 @@
2. 导入UIAbility模块。 2. 导入UIAbility模块。
```ts ```ts
import Ability from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
``` ```
3. 定义约定的序列化数据。 3. 定义约定的序列化数据。
调用端及被调用端发送接收的数据格式需协商一致,如下示例约定数据由number和string组成。 调用端及被调用端发送接收的数据格式需协商一致,如下示例约定数据由number和string组成。
```ts ```ts
import rpc from '@ohos.rpc'
export default class MyParcelable { export default class MyParcelable {
num: number = 0; num: number = 0;
str: string = ""; str: string = "";
constructor(num, string) { constructor(num: number, string: string) {
this.num = num; this.num = num;
this.str = string; this.str = string;
} }
marshalling(messageSequence) { marshalling(messageSequence: rpc.MessageParcel) {
messageSequence.writeInt(this.num); messageSequence.writeInt(this.num);
messageSequence.writeString(this.str); messageSequence.writeString(this.str);
return true; return true;
} }
unmarshalling(messageSequence) { unmarshalling(messageSequence: rpc.MessageParcel) {
this.num = messageSequence.readInt(); this.num = messageSequence.readInt();
this.str = messageSequence.readString(); this.str = messageSequence.readString();
return true; return true;
...@@ -375,24 +459,28 @@ ...@@ -375,24 +459,28 @@
如下示例在Ability的onCreate注册MSG_SEND_METHOD监听,在onDestroy取消监听,收到序列化数据后作相应处理并返回。应用开发者根据实际业务需要做相应处理。 如下示例在Ability的onCreate注册MSG_SEND_METHOD监听,在onDestroy取消监听,收到序列化数据后作相应处理并返回。应用开发者根据实际业务需要做相应处理。
```ts ```ts
import rpc from '@ohos.rpc';
import Want from '@ohos.app.ability.Want';
import UIAbility from '@ohos.app.ability.UIAbility';
import AbilityConstant from '@ohos.app.ability.AbilityConstant';
const TAG: string = '[CalleeAbility]'; const TAG: string = '[CalleeAbility]';
const MSG_SEND_METHOD: string = 'CallSendMsg'; const MSG_SEND_METHOD: string = 'CallSendMsg';
function sendMsgCallback(data) { function sendMsgCallback(data: rpc.MessageSequence): MyParcelable {
console.info('CalleeSortFunc called'); console.info('CalleeSortFunc called');
// 获取Caller发送的序列化数据 // 获取Caller发送的序列化数据
let receivedData = new MyParcelable(0, ''); let receivedData: MyParcelable = new MyParcelable(0, '');
data.readParcelable(receivedData); data.readParcelable(receivedData);
console.info(`receiveData[${receivedData.num}, ${receivedData.str}]`); console.info(`receiveData[${receivedData.num}, ${receivedData.str}]`);
// 作相应处理 // 作相应处理
// 返回序列化数据result给Caller // 返回序列化数据result给Caller
return new MyParcelable(receivedData.num + 1, `send ${receivedData.str} succeed`); return new MyParcelable(Number(receivedData.num) + 1, `send ${receivedData.str} succeed`);
} }
export default class CalleeAbility extends Ability { export default class CalleeAbility extends UIAbility {
onCreate(want, launchParam) { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
try { try {
this.callee.on(MSG_SEND_METHOD, sendMsgCallback); this.callee.on(MSG_SEND_METHOD, sendMsgCallback);
} catch (error) { } catch (error) {
...@@ -414,42 +502,48 @@ ...@@ -414,42 +502,48 @@
1. 导入UIAbility模块。 1. 导入UIAbility模块。
```ts ```ts
import Ability from '@ohos.app.ability.UIAbility'; import UIAbility from '@ohos.app.ability.UIAbility';
``` ```
2. 获取Caller通信接口。 2. 获取Caller通信接口。
Ability的context属性实现了startAbilityByCall方法,用于获取指定通用组件的Caller通信接口。如下示例通过this.context获取Ability实例的context属性,使用startAbilityByCall拉起Callee被调用端并获取Caller通信接口,注册Caller的onRelease和onRemoteStateChange监听。应用开发者根据实际业务需要做相应处理。 Ability的context属性实现了startAbilityByCall方法,用于获取指定通用组件的Caller通信接口。如下示例通过this.context获取Ability实例的context属性,使用startAbilityByCall拉起Callee被调用端并获取Caller通信接口,注册Caller的onRelease和onRemoteStateChange监听。应用开发者根据实际业务需要做相应处理。
```ts ```ts
async onButtonGetRemoteCaller() { import UIAbility, { Caller } from '@ohos.app.ability.UIAbility';
var caller = undefined; import { BusinessError } from '@ohos.base';
var context = this.context; export default class EntryAbility extends UIAbility {
// ...
context.startAbilityByCall({ async onButtonGetRemoteCaller() {
deviceId: getRemoteDeviceId(), let caller: Caller | undefined;
bundleName: 'com.samples.CallApplication', let context = this.context;
abilityName: 'CalleeAbility'
}).then((data) => { context.startAbilityByCall({
if (data != null) { deviceId: getRemoteDeviceId(),
caller = data; bundleName: 'com.samples.CallApplication',
console.info('get remote caller success'); abilityName: 'CalleeAbility'
// 注册caller的release监听 }).then((data) => {
caller.onRelease((msg) => { if (data != null) {
console.info(`remote caller onRelease is called ${msg}`); caller = data;
}) console.info('get remote caller success');
console.info('remote caller register OnRelease succeed'); // 注册caller的release监听
// 注册caller的协同场景下跨设备组件状态变化监听通知 caller.onRelease((msg) => {
try { console.info(`remote caller onRelease is called ${msg}`);
caller.onRemoteStateChange((str) => { })
console.info('Remote state changed ' + str); console.info('remote caller register OnRelease succeed');
}); // 注册caller的协同场景下跨设备组件状态变化监听通知
} catch (error) { try {
console.info('Caller.onRemoteStateChange catch error, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}'); caller.onRemoteStateChange((str) => {
console.info('Remote state changed ' + str);
});
} catch (error) {
console.info('Caller.onRemoteStateChange catch error, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}');
}
} }
} }).catch((error: BusinessError) => {
}).catch((error) => { console.error(`get remote caller failed with ${error}`);
console.error(`get remote caller failed with ${error}`); })
}) }
// ...
} }
``` ```
...@@ -459,49 +553,72 @@ ...@@ -459,49 +553,72 @@
1. 向被调用端发送Parcelable数据有两种方式,一种是不带返回值,一种是获取被调用端返回的数据,method以及序列化数据需要与被调用端协商一致。如下示例调用Call接口,向Callee被调用端发送数据。 1. 向被调用端发送Parcelable数据有两种方式,一种是不带返回值,一种是获取被调用端返回的数据,method以及序列化数据需要与被调用端协商一致。如下示例调用Call接口,向Callee被调用端发送数据。
```ts ```ts
import UIAbility, { Caller } from '@ohos.app.ability.UIAbility';
import { BusinessError } from '@ohos.base';
const MSG_SEND_METHOD: string = 'CallSendMsg'; const MSG_SEND_METHOD: string = 'CallSendMsg';
async onButtonCall() { export default class EntryAbility extends UIAbility {
try { // ...
let msg = new MyParcelable(1, 'origin_Msg'); caller: Caller | undefined;
await this.caller.call(MSG_SEND_METHOD, msg); async onButtonCall() {
} catch (error) { try {
console.info(`caller call failed with ${error}`); let msg: MyParcelable = new MyParcelable(1, 'origin_Msg');
} if (this.caller) {
await this.caller.call(MSG_SEND_METHOD, msg);
}
} catch (error) {
console.info(`caller call failed with ${error}`);
}
}
// ...
} }
``` ```
2. 如下示例调用CallWithResult接口,向Callee被调用端发送待处理的数据originMsg,并将’CallSendMsg’方法处理完毕的数据赋值给backMsg。 2. 如下示例调用CallWithResult接口,向Callee被调用端发送待处理的数据originMsg,并将’CallSendMsg’方法处理完毕的数据赋值给backMsg。
```ts ```ts
const MSG_SEND_METHOD: string = 'CallSendMsg'; import UIAbility, { Caller } from '@ohos.app.ability.UIAbility';
let originMsg: string = ''; import rpc from '@ohos.rpc';
let backMsg: string = ''; const MSG_SEND_METHOD: string = 'CallSendMsg';
async onButtonCallWithResult(originMsg, backMsg) { let originMsg: string = '';
try { let backMsg: string = '';
let msg = new MyParcelable(1, originMsg); export default class EntryAbility extends UIAbility {
const data = await this.caller.callWithResult(MSG_SEND_METHOD, msg); // ...
console.info('caller callWithResult succeed'); caller: Caller | undefined;
async onButtonCallWithResult(originMsg: string, backMsg: string) {
let result = new MyParcelable(0, ''); try {
data.readParcelable(result); let msg: MyParcelable = new MyParcelable(1, originMsg);
backMsg(result.str); if (this.caller) {
console.info(`caller result is [${result.num}, ${result.str}]`); const data = await this.caller.callWithResult(MSG_SEND_METHOD, msg);
} catch (error) { console.info('caller callWithResult succeed');
console.info(`caller callWithResult failed with ${error}`); let result: MyParcelable = new MyParcelable(0, '');
} data.readParcelable(result);
} backMsg = result.str;
``` console.info(`caller result is [${result.num}, ${result.str}]`);
}
} catch (error) {
console.info(`caller callWithResult failed with ${error}`);
}
}
// ...
}
```
6. 释放Caller通信接口。 6. 释放Caller通信接口。
Caller不再使用后,应用开发者可以通过release接口释放Caller。 Caller不再使用后,应用开发者可以通过release接口释放Caller。
```ts ```ts
releaseCall() { import UIAbility, { Caller } from '@ohos.app.ability.UIAbility';
try { export default class EntryAbility extends UIAbility {
this.caller.release(); caller: Caller | undefined;
this.caller = undefined releaseCall() {
console.info('caller release succeed'); try {
} catch (error) { if (this.caller) {
console.info(`caller release failed with ${error}`); this.caller.release();
} this.caller = undefined;
}
console.info('caller release succeed');
} catch (error) {
console.info(`caller release failed with ${error}`);
}
}
} }
``` ```
...@@ -43,7 +43,8 @@ register(callback: AsyncCallback\<number>): void; ...@@ -43,7 +43,8 @@ register(callback: AsyncCallback\<number>): void;
**示例:** **示例:**
```ts ```ts
let token = -1; import continuationManager from '@ohos.continuation.continuationManager'
let token: number = -1;
continuationManager.register((err, data) => { continuationManager.register((err, data) => {
if (err.code != 0) { if (err.code != 0) {
console.error('register failed, cause: ' + JSON.stringify(err)); console.error('register failed, cause: ' + JSON.stringify(err));
...@@ -85,17 +86,19 @@ register(options: ContinuationExtraParams, callback: AsyncCallback\<number>): vo ...@@ -85,17 +86,19 @@ register(options: ContinuationExtraParams, callback: AsyncCallback\<number>): vo
**示例:** **示例:**
```ts ```ts
let token = -1; import continuationManager from '@ohos.continuation.continuationManager'
let continuationExtraParams = { let token: number = -1;
deviceType: ["00E"] continuationManager.register(
}; {
continuationManager.register(continuationExtraParams, (err, data) => { deviceType: ["00E"]
if (err.code != 0) { },
console.error('register failed, cause: ' + JSON.stringify(err)); (err, data) => {
return; if (err.code != 0) {
} console.error('register failed, cause: ' + JSON.stringify(err));
console.info('register finished, ' + JSON.stringify(data)); return;
token = data; }
console.info('register finished, ' + JSON.stringify(data));
token = data;
}); });
``` ```
...@@ -135,18 +138,16 @@ register(options?: ContinuationExtraParams): Promise\<number>; ...@@ -135,18 +138,16 @@ register(options?: ContinuationExtraParams): Promise\<number>;
**示例:** **示例:**
```ts ```ts
let token = -1; import continuationManager from '@ohos.continuation.continuationManager'
let continuationExtraParams = { import { BusinessError } from '@ohos.base';
deviceType: ["00E"] let token: number = -1;
}; continuationManager.register(
continuationManager.register(continuationExtraParams) { deviceType: ["00E"] }).then((data) => {
.then((data) => {
console.info('register finished, ' + JSON.stringify(data)); console.info('register finished, ' + JSON.stringify(data));
token = data; token = data;
}) }).catch((err: BusinessError) => {
.catch((err) => {
console.error('register failed, cause: ' + JSON.stringify(err)); console.error('register failed, cause: ' + JSON.stringify(err));
}); });
``` ```
## continuationManager.registerContinuation<sup>9+</sup> ## continuationManager.registerContinuation<sup>9+</sup>
...@@ -177,7 +178,8 @@ registerContinuation(callback: AsyncCallback\<number>): void; ...@@ -177,7 +178,8 @@ registerContinuation(callback: AsyncCallback\<number>): void;
**示例:** **示例:**
```ts ```ts
let token = -1; import continuationManager from '@ohos.continuation.continuationManager'
let token: number = -1;
try { try {
continuationManager.registerContinuation((err, data) => { continuationManager.registerContinuation((err, data) => {
if (err.code != 0) { if (err.code != 0) {
...@@ -221,18 +223,20 @@ registerContinuation(options: ContinuationExtraParams, callback: AsyncCallback\< ...@@ -221,18 +223,20 @@ registerContinuation(options: ContinuationExtraParams, callback: AsyncCallback\<
**示例:** **示例:**
```ts ```ts
let token = -1; import continuationManager from '@ohos.continuation.continuationManager';
let continuationExtraParams = { let token: number = -1;
deviceType: ["00E"]
};
try { try {
continuationManager.registerContinuation(continuationExtraParams, (err, data) => { continuationManager.registerContinuation(
if (err.code != 0) { {
console.error('registerContinuation failed, cause: ' + JSON.stringify(err)); deviceType: ["00E"]
return; },
} (err, data) => {
console.info('registerContinuation finished, ' + JSON.stringify(data)); if (err.code != 0) {
token = data; console.error('registerContinuation failed, cause: ' + JSON.stringify(err));
return;
}
console.info('registerContinuation finished, ' + JSON.stringify(data));
token = data;
}); });
} catch (err) { } catch (err) {
console.error('registerContinuation failed, cause: ' + JSON.stringify(err)); console.error('registerContinuation failed, cause: ' + JSON.stringify(err));
...@@ -273,19 +277,19 @@ registerContinuation(options?: ContinuationExtraParams): Promise\<number>; ...@@ -273,19 +277,19 @@ registerContinuation(options?: ContinuationExtraParams): Promise\<number>;
**示例:** **示例:**
```ts ```ts
let token = -1; import continuationManager from '@ohos.continuation.continuationManager';
let continuationExtraParams = { import { BusinessError } from '@ohos.base';
deviceType: ["00E"] let token: number = -1;
};
try { try {
continuationManager.register(continuationExtraParams) continuationManager.register(
.then((data) => { {
deviceType: ["00E"]
}).then((data) => {
console.info('registerContinuation finished, ' + JSON.stringify(data)); console.info('registerContinuation finished, ' + JSON.stringify(data));
token = data; token = data;
}) }).catch((err: BusinessError) => {
.catch((err) => {
console.error('registerContinuation failed, cause: ' + JSON.stringify(err)); console.error('registerContinuation failed, cause: ' + JSON.stringify(err));
}); });
} catch (err) { } catch (err) {
console.error('registerContinuation failed, cause: ' + JSON.stringify(err)); console.error('registerContinuation failed, cause: ' + JSON.stringify(err));
} }
...@@ -324,6 +328,7 @@ on(type: "deviceConnect", callback: Callback\<ContinuationResult>): void; ...@@ -324,6 +328,7 @@ on(type: "deviceConnect", callback: Callback\<ContinuationResult>): void;
**示例:** **示例:**
```ts ```ts
import continuationManager from '@ohos.continuation.continuationManager';
continuationManager.on("deviceConnect", (data) => { continuationManager.on("deviceConnect", (data) => {
console.info('onDeviceConnect deviceId: ' + JSON.stringify(data.id)); console.info('onDeviceConnect deviceId: ' + JSON.stringify(data.id));
console.info('onDeviceConnect deviceType: ' + JSON.stringify(data.type)); console.info('onDeviceConnect deviceType: ' + JSON.stringify(data.type));
...@@ -363,6 +368,7 @@ on(type: "deviceDisconnect", callback: Callback\<string>): void; ...@@ -363,6 +368,7 @@ on(type: "deviceDisconnect", callback: Callback\<string>): void;
**示例:** **示例:**
```ts ```ts
import continuationManager from '@ohos.continuation.continuationManager';
continuationManager.on("deviceDisconnect", (data) => { continuationManager.on("deviceDisconnect", (data) => {
console.info('onDeviceDisconnect deviceId: ' + JSON.stringify(data)); console.info('onDeviceDisconnect deviceId: ' + JSON.stringify(data));
}); });
...@@ -400,6 +406,7 @@ off(type: "deviceConnect", callback?: Callback\<ContinuationResult>): void; ...@@ -400,6 +406,7 @@ off(type: "deviceConnect", callback?: Callback\<ContinuationResult>): void;
**示例:** **示例:**
```ts ```ts
import continuationManager from '@ohos.continuation.continuationManager';
continuationManager.off("deviceConnect", (data) => { continuationManager.off("deviceConnect", (data) => {
console.info('onDeviceConnect deviceId: ' + JSON.stringify(data.id)); console.info('onDeviceConnect deviceId: ' + JSON.stringify(data.id));
console.info('onDeviceConnect deviceType: ' + JSON.stringify(data.type)); console.info('onDeviceConnect deviceType: ' + JSON.stringify(data.type));
...@@ -439,6 +446,7 @@ off(type: "deviceDisconnect", callback?: Callback\<string>): void; ...@@ -439,6 +446,7 @@ off(type: "deviceDisconnect", callback?: Callback\<string>): void;
**示例:** **示例:**
```ts ```ts
import continuationManager from '@ohos.continuation.continuationManager';
continuationManager.off("deviceDisconnect", (data) => { continuationManager.off("deviceDisconnect", (data) => {
console.info('onDeviceDisconnect deviceId: ' + JSON.stringify(data)); console.info('onDeviceDisconnect deviceId: ' + JSON.stringify(data));
}); });
...@@ -475,7 +483,8 @@ on(type: "deviceSelected", token: number, callback: Callback\<Array\<Continuatio ...@@ -475,7 +483,8 @@ on(type: "deviceSelected", token: number, callback: Callback\<Array\<Continuatio
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
let token: number = 1;
try { try {
continuationManager.on("deviceSelected", token, (data) => { continuationManager.on("deviceSelected", token, (data) => {
console.info('onDeviceSelected len: ' + data.length); console.info('onDeviceSelected len: ' + data.length);
...@@ -521,7 +530,8 @@ on(type: "deviceUnselected", token: number, callback: Callback\<Array\<Continuat ...@@ -521,7 +530,8 @@ on(type: "deviceUnselected", token: number, callback: Callback\<Array\<Continuat
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
let token: number = 1;
try { try {
continuationManager.on("deviceUnselected", token, (data) => { continuationManager.on("deviceUnselected", token, (data) => {
console.info('onDeviceUnselected len: ' + data.length); console.info('onDeviceUnselected len: ' + data.length);
...@@ -567,7 +577,8 @@ off(type: "deviceSelected", token: number): void; ...@@ -567,7 +577,8 @@ off(type: "deviceSelected", token: number): void;
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
let token: number = 1;
try { try {
continuationManager.off("deviceSelected", token); continuationManager.off("deviceSelected", token);
} catch (err) { } catch (err) {
...@@ -605,7 +616,8 @@ off(type: "deviceUnselected", token: number): void; ...@@ -605,7 +616,8 @@ off(type: "deviceUnselected", token: number): void;
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
let token: number = 1;
try { try {
continuationManager.off("deviceUnselected", token); continuationManager.off("deviceUnselected", token);
} catch (err) { } catch (err) {
...@@ -646,7 +658,8 @@ startDeviceManager(token: number, callback: AsyncCallback\<void>): void; ...@@ -646,7 +658,8 @@ startDeviceManager(token: number, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
let token: number = 1;
continuationManager.startDeviceManager(token, (err, data) => { continuationManager.startDeviceManager(token, (err, data) => {
if (err.code != 0) { if (err.code != 0) {
console.error('startDeviceManager failed, cause: ' + JSON.stringify(err)); console.error('startDeviceManager failed, cause: ' + JSON.stringify(err));
...@@ -690,16 +703,19 @@ startDeviceManager(token: number, options: ContinuationExtraParams, callback: As ...@@ -690,16 +703,19 @@ startDeviceManager(token: number, options: ContinuationExtraParams, callback: As
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
let continuationExtraParams = { let token: number = 1;
deviceType: ["00E"] continuationManager.startDeviceManager(
}; token,
continuationManager.startDeviceManager(token, continuationExtraParams, (err, data) => { {
if (err.code != 0) { deviceType: ["00E"]
console.error('startDeviceManager failed, cause: ' + JSON.stringify(err)); },
return; (err, data) => {
} if (err.code != 0) {
console.info('startDeviceManager finished, ' + JSON.stringify(data)); console.error('startDeviceManager failed, cause: ' + JSON.stringify(err));
return;
}
console.info('startDeviceManager finished, ' + JSON.stringify(data));
}); });
``` ```
...@@ -742,17 +758,18 @@ startDeviceManager(token: number, options?: ContinuationExtraParams): Promise\<v ...@@ -742,17 +758,18 @@ startDeviceManager(token: number, options?: ContinuationExtraParams): Promise\<v
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
let continuationExtraParams = { import { BusinessError } from '@ohos.base';
deviceType: ["00E"] let token: number = -1;
}; continuationManager.startDeviceManager(
continuationManager.startDeviceManager(token, continuationExtraParams) token,
.then((data) => { {
deviceType: ["00E"]
}).then((data) => {
console.info('startDeviceManager finished, ' + JSON.stringify(data)); console.info('startDeviceManager finished, ' + JSON.stringify(data));
}) }).catch((err: BusinessError) => {
.catch((err) => {
console.error('startDeviceManager failed, cause: ' + JSON.stringify(err)); console.error('startDeviceManager failed, cause: ' + JSON.stringify(err));
}); });
``` ```
## continuationManager.startContinuationDeviceManager<sup>9+</sup> ## continuationManager.startContinuationDeviceManager<sup>9+</sup>
...@@ -784,7 +801,8 @@ startContinuationDeviceManager(token: number, callback: AsyncCallback\<void>): v ...@@ -784,7 +801,8 @@ startContinuationDeviceManager(token: number, callback: AsyncCallback\<void>): v
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
let token: number = -1;
try { try {
continuationManager.startContinuationDeviceManager(token, (err, data) => { continuationManager.startContinuationDeviceManager(token, (err, data) => {
if (err.code != 0) { if (err.code != 0) {
...@@ -828,17 +846,20 @@ startContinuationDeviceManager(token: number, options: ContinuationExtraParams, ...@@ -828,17 +846,20 @@ startContinuationDeviceManager(token: number, options: ContinuationExtraParams,
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
let continuationExtraParams = { let token: number = -1;
deviceType: ["00E"]
};
try { try {
continuationManager.startContinuationDeviceManager(token, continuationExtraParams, (err, data) => { continuationManager.startContinuationDeviceManager(
if (err.code != 0) { token,
console.error('startContinuationDeviceManager failed, cause: ' + JSON.stringify(err)); {
return; deviceType: ["00E"]
} },
console.info('startContinuationDeviceManager finished, ' + JSON.stringify(data)); (err, data) => {
if (err.code != 0) {
console.error('startContinuationDeviceManager failed, cause: ' + JSON.stringify(err));
return;
}
console.info('startContinuationDeviceManager finished, ' + JSON.stringify(data));
}); });
} catch (err) { } catch (err) {
console.error('startContinuationDeviceManager failed, cause: ' + JSON.stringify(err)); console.error('startContinuationDeviceManager failed, cause: ' + JSON.stringify(err));
...@@ -880,16 +901,17 @@ startContinuationDeviceManager(token: number, options?: ContinuationExtraParams) ...@@ -880,16 +901,17 @@ startContinuationDeviceManager(token: number, options?: ContinuationExtraParams)
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
let continuationExtraParams = { import { BusinessError } from '@ohos.base';
deviceType: ["00E"] let token: number = -1;
};
try { try {
continuationManager.startContinuationDeviceManager(token, continuationExtraParams) continuationManager.startContinuationDeviceManager(
.then((data) => { token,
{
deviceType: ["00E"]
}).then((data) => {
console.info('startContinuationDeviceManager finished, ' + JSON.stringify(data)); console.info('startContinuationDeviceManager finished, ' + JSON.stringify(data));
}) }).catch((err: BusinessError) => {
.catch((err) => {
console.error('startContinuationDeviceManager failed, cause: ' + JSON.stringify(err)); console.error('startContinuationDeviceManager failed, cause: ' + JSON.stringify(err));
}); });
} catch (err) { } catch (err) {
...@@ -932,7 +954,8 @@ updateConnectStatus(token: number, deviceId: string, status: DeviceConnectState, ...@@ -932,7 +954,8 @@ updateConnectStatus(token: number, deviceId: string, status: DeviceConnectState,
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
let token: number = -1;
let deviceId: string = "test deviceId"; let deviceId: string = "test deviceId";
continuationManager.updateConnectStatus(token, deviceId, continuationManager.DeviceConnectState.CONNECTED, (err, data) => { continuationManager.updateConnectStatus(token, deviceId, continuationManager.DeviceConnectState.CONNECTED, (err, data) => {
if (err.code != 0) { if (err.code != 0) {
...@@ -983,15 +1006,17 @@ updateConnectStatus(token: number, deviceId: string, status: DeviceConnectState) ...@@ -983,15 +1006,17 @@ updateConnectStatus(token: number, deviceId: string, status: DeviceConnectState)
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
import { BusinessError } from '@ohos.base';
let token: number = 1;
let deviceId: string = "test deviceId"; let deviceId: string = "test deviceId";
continuationManager.updateConnectStatus(token, deviceId, continuationManager.DeviceConnectState.CONNECTED) continuationManager.updateConnectStatus(token, deviceId, continuationManager.DeviceConnectState.CONNECTED)
.then((data) => { .then((data) => {
console.info('updateConnectStatus finished, ' + JSON.stringify(data)); console.info('updateConnectStatus finished, ' + JSON.stringify(data));
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('updateConnectStatus failed, cause: ' + JSON.stringify(err)); console.error('updateConnectStatus failed, cause: ' + JSON.stringify(err));
}); });
``` ```
## continuationManager.updateContinuationState<sup>9+</sup> ## continuationManager.updateContinuationState<sup>9+</sup>
...@@ -1025,7 +1050,8 @@ updateContinuationState(token: number, deviceId: string, status: DeviceConnectSt ...@@ -1025,7 +1050,8 @@ updateContinuationState(token: number, deviceId: string, status: DeviceConnectSt
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
let token: number = 1;
let deviceId: string = "test deviceId"; let deviceId: string = "test deviceId";
try { try {
continuationManager.updateContinuationState(token, deviceId, continuationManager.DeviceConnectState.CONNECTED, (err, data) => { continuationManager.updateContinuationState(token, deviceId, continuationManager.DeviceConnectState.CONNECTED, (err, data) => {
...@@ -1076,14 +1102,16 @@ updateContinuationState(token: number, deviceId: string, status: DeviceConnectSt ...@@ -1076,14 +1102,16 @@ updateContinuationState(token: number, deviceId: string, status: DeviceConnectSt
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
import { BusinessError } from '@ohos.base';
let token: number = 1;
let deviceId: string = "test deviceId"; let deviceId: string = "test deviceId";
try { try {
continuationManager.updateContinuationState(token, deviceId, continuationManager.DeviceConnectState.CONNECTED) continuationManager.updateContinuationState(token, deviceId, continuationManager.DeviceConnectState.CONNECTED)
.then((data) => { .then((data) => {
console.info('updateContinuationState finished, ' + JSON.stringify(data)); console.info('updateContinuationState finished, ' + JSON.stringify(data));
}) })
.catch((err) => { .catch((err: BusinessError) => {
console.error('updateContinuationState failed, cause: ' + JSON.stringify(err)); console.error('updateContinuationState failed, cause: ' + JSON.stringify(err));
}); });
} catch (err) { } catch (err) {
...@@ -1122,7 +1150,8 @@ unregister(token: number, callback: AsyncCallback\<void>): void; ...@@ -1122,7 +1150,8 @@ unregister(token: number, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
let token: number = 1;
continuationManager.unregister(token, (err, data) => { continuationManager.unregister(token, (err, data) => {
if (err.code != 0) { if (err.code != 0) {
console.error('unregister failed, cause: ' + JSON.stringify(err)); console.error('unregister failed, cause: ' + JSON.stringify(err));
...@@ -1167,14 +1196,15 @@ unregister(token: number): Promise\<void>; ...@@ -1167,14 +1196,15 @@ unregister(token: number): Promise\<void>;
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
import { BusinessError } from '@ohos.base';
let token: number = 1;
continuationManager.unregister(token) continuationManager.unregister(token)
.then((data) => { .then((data) => {
console.info('unregister finished, ' + JSON.stringify(data)); console.info('unregister finished, ' + JSON.stringify(data));
}) }).catch((err: BusinessError) => {
.catch((err) => {
console.error('unregister failed, cause: ' + JSON.stringify(err)); console.error('unregister failed, cause: ' + JSON.stringify(err));
}); });
``` ```
## continuationManager.unregisterContinuation<sup>9+</sup> ## continuationManager.unregisterContinuation<sup>9+</sup>
...@@ -1206,7 +1236,9 @@ unregisterContinuation(token: number, callback: AsyncCallback\<void>): void; ...@@ -1206,7 +1236,9 @@ unregisterContinuation(token: number, callback: AsyncCallback\<void>): void;
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
import { BusinessError } from '@ohos.base';
let token: number = 1;
try { try {
continuationManager.unregisterContinuation(token, (err, data) => { continuationManager.unregisterContinuation(token, (err, data) => {
if (err.code != 0) { if (err.code != 0) {
...@@ -1254,15 +1286,15 @@ unregisterContinuation(token: number): Promise\<void>; ...@@ -1254,15 +1286,15 @@ unregisterContinuation(token: number): Promise\<void>;
**示例:** **示例:**
```ts ```ts
let token = 1; import continuationManager from '@ohos.continuation.continuationManager';
import { BusinessError } from '@ohos.base';
let token: number = -1;
try { try {
continuationManager.unregisterContinuation(token) continuationManager.unregisterContinuation(token).then((data) => {
.then((data) => {
console.info('unregisterContinuation finished, ' + JSON.stringify(data)); console.info('unregisterContinuation finished, ' + JSON.stringify(data));
}) }).catch((err: BusinessError) => {
.catch((err) => {
console.error('unregisterContinuation failed, cause: ' + JSON.stringify(err)); console.error('unregisterContinuation failed, cause: ' + JSON.stringify(err));
}); });
} catch (err) { } catch (err) {
console.error('unregisterContinuation failed, cause: ' + JSON.stringify(err)); console.error('unregisterContinuation failed, cause: ' + JSON.stringify(err));
} }
......
...@@ -35,34 +35,35 @@ registerMissionListener(parameter: MissionDeviceInfo, options: MissionCallback, ...@@ -35,34 +35,35 @@ registerMissionListener(parameter: MissionDeviceInfo, options: MissionCallback,
**示例:** **示例:**
```ts ```ts
function NotifyMissionsChanged(deviceId) { import distributedMissionManager from '@ohos.distributedMissionManager'
console.log('NotifyMissionsChanged deviceId ' + JSON.stringify(deviceId)); import { BusinessError } from '@ohos.base';
function NotifyMissionsChanged(deviceId: string): void {
console.log('NotifyMissionsChanged deviceId ' + JSON.stringify(deviceId));
} }
function NotifySnapshot(deviceId, missionId) { function NotifySnapshot(deviceId: string, missionId: number): void {
console.log('NotifySnapshot deviceId ' + JSON.stringify(deviceId)); console.log('NotifySnapshot deviceId ' + JSON.stringify(deviceId));
console.log('NotifySnapshot missionId ' + JSON.stringify(missionId)); console.log('NotifySnapshot missionId ' + JSON.stringify(missionId));
} }
function NotifyNetDisconnect(deviceId, state) { function NotifyNetDisconnect(deviceId: string, state: number): void {
console.log('NotifyNetDisconnect deviceId ' + JSON.stringify(deviceId)); console.log('NotifyNetDisconnect deviceId ' + JSON.stringify(deviceId));
console.log('NotifyNetDisconnect state ' + JSON.stringify(state)); console.log('NotifyNetDisconnect state ' + JSON.stringify(state));
}
var parameter = {
deviceId: ""
};
var options = {
notifyMissionsChanged: NotifyMissionsChanged,
notifySnapshot: NotifySnapshot,
notifyNetDisconnect: NotifyNetDisconnect
} }
try { try {
distributedMissionManager.registerMissionListener(parameter, options, (error) => { distributedMissionManager.registerMissionListener(
if (error.code != 0) { { deviceId: "" },
console.error('registerMissionListener failed, cause: ' + JSON.stringify(error)) {
} notifyMissionsChanged: NotifyMissionsChanged,
console.info('registerMissionListener finished') notifySnapshot: NotifySnapshot,
}) notifyNetDisconnect: NotifyNetDisconnect
},
(error: BusinessError) => {
if (error.code != 0) {
console.error('registerMissionListener failed, cause: ' + JSON.stringify(error))
}
console.info('registerMissionListener finished')
});
} catch (error) { } catch (error) {
console.error('registerMissionListener failed, cause: ' + JSON.stringify(error)) console.error('registerMissionListener failed, cause: ' + JSON.stringify(error))
} }
``` ```
## distributedMissionManager.registerMissionListener ## distributedMissionManager.registerMissionListener
...@@ -91,30 +92,29 @@ registerMissionListener(parameter: MissionDeviceInfo, options: MissionCallback): ...@@ -91,30 +92,29 @@ registerMissionListener(parameter: MissionDeviceInfo, options: MissionCallback):
**示例:** **示例:**
```ts ```ts
function NotifyMissionsChanged(deviceId) { import distributedMissionManager from '@ohos.distributedMissionManager'
console.log('NotifyMissionsChanged deviceId ' + JSON.stringify(deviceId)); import { BusinessError } from '@ohos.base';
function NotifyMissionsChanged(deviceId: string): void {
console.log('NotifyMissionsChanged deviceId ' + JSON.stringify(deviceId));
} }
function NotifySnapshot(deviceId, missionId) { function NotifySnapshot(deviceId: string, missionId: number): void {
console.log('NotifySnapshot deviceId ' + JSON.stringify(deviceId)); console.log('NotifySnapshot deviceId ' + JSON.stringify(deviceId));
console.log('NotifySnapshot missionId ' + JSON.stringify(missionId)); console.log('NotifySnapshot missionId ' + JSON.stringify(missionId));
} }
function NotifyNetDisconnect(deviceId, state) { function NotifyNetDisconnect(deviceId: string, state: number): void {
console.log('NotifyNetDisconnect deviceId ' + JSON.stringify(deviceId)); console.log('NotifyNetDisconnect deviceId ' + JSON.stringify(deviceId));
console.log('NotifyNetDisconnect state ' + JSON.stringify(state)); console.log('NotifyNetDisconnect state ' + JSON.stringify(state));
}
var parameter = {
deviceId: ""
};
var options = {
notifyMissionsChanged: NotifyMissionsChanged,
notifySnapshot: NotifySnapshot,
notifyNetDisconnect: NotifyNetDisconnect
} }
try { try {
distributedMissionManager.registerMissionListener(parameter, options) distributedMissionManager.registerMissionListener(
.then(data => { { deviceId: "" },
{
notifyMissionsChanged: NotifyMissionsChanged,
notifySnapshot: NotifySnapshot,
notifyNetDisconnect: NotifyNetDisconnect
}).then((data: void) => {
console.info('registerMissionListener finished, ' + JSON.stringify(data)); console.info('registerMissionListener finished, ' + JSON.stringify(data));
}).catch(error => { }).catch((error: BusinessError) => {
console.error('registerMissionListener failed, cause: ' + JSON.stringify(error)); console.error('registerMissionListener failed, cause: ' + JSON.stringify(error));
}) })
} catch (error) { } catch (error) {
...@@ -142,16 +142,17 @@ unRegisterMissionListener(parameter: MissionDeviceInfo, callback: AsyncCallback& ...@@ -142,16 +142,17 @@ unRegisterMissionListener(parameter: MissionDeviceInfo, callback: AsyncCallback&
**示例:** **示例:**
```ts ```ts
var parameter = { import distributedMissionManager from '@ohos.distributedMissionManager'
deviceId: "" import { BusinessError } from '@ohos.base';
};
try { try {
distributedMissionManager.unRegisterMissionListener(parameter, (error) => { distributedMissionManager.unRegisterMissionListener(
if (error.code != 0) { { deviceId: "" },
console.error('unRegisterMissionListener failed, cause: ' + JSON.stringify(error)) (error: BusinessError) => {
} if (error.code != 0) {
console.info('unRegisterMissionListener finished') console.error('unRegisterMissionListener failed, cause: ' + JSON.stringify(error))
}) }
console.info('unRegisterMissionListener finished')
})
} catch (error) { } catch (error) {
console.error('unRegisterMissionListener failed, cause: ' + JSON.stringify(error)) console.error('unRegisterMissionListener failed, cause: ' + JSON.stringify(error))
} }
...@@ -182,16 +183,14 @@ unRegisterMissionListener(parameter: MissionDeviceInfo): Promise&lt;void&gt; ...@@ -182,16 +183,14 @@ unRegisterMissionListener(parameter: MissionDeviceInfo): Promise&lt;void&gt;
**示例:** **示例:**
```ts ```ts
var parameter = { import distributedMissionManager from '@ohos.distributedMissionManager'
deviceId: "" import { BusinessError } from '@ohos.base';
};
try { try {
distributedMissionManager.unRegisterMissionListener(parameter) distributedMissionManager.unRegisterMissionListener({deviceId: ""}).then(() => {
.then(data => { console.info('unRegisterMissionListener finished successfully');
console.info('unRegisterMissionListener finished, ' + JSON.stringify(data)); }).catch((error: BusinessError) => {
}).catch(error => { console.error('unRegisterMissionListener failed, cause: ' + JSON.stringify(error));
console.error('unRegisterMissionListener failed, cause: ' + JSON.stringify(error)); })
})
} catch (error) { } catch (error) {
console.error('unRegisterMissionListener failed, cause: ' + JSON.stringify(error)) console.error('unRegisterMissionListener failed, cause: ' + JSON.stringify(error))
} }
...@@ -217,20 +216,23 @@ startSyncRemoteMissions(parameter: MissionParameter, callback: AsyncCallback&lt; ...@@ -217,20 +216,23 @@ startSyncRemoteMissions(parameter: MissionParameter, callback: AsyncCallback&lt;
**示例:** **示例:**
```ts ```ts
var parameter = { import distributedMissionManager from '@ohos.distributedMissionManager'
deviceId: "", import { BusinessError } from '@ohos.base';
fixConflict: false,
tag: 0
};
try { try {
distributedMissionManager.startSyncRemoteMissions(parameter, (error) => { distributedMissionManager.startSyncRemoteMissions(
if (error.code != 0) { {
console.error('startSyncRemoteMissions failed, cause: ' + JSON.stringify(error)) deviceId: "",
} fixConflict: false,
console.info('startSyncRemoteMissions finished') tag: 0
}) },
(error: BusinessError) => {
if (error.code != 0) {
console.error('startSyncRemoteMissions failed, cause: ' + JSON.stringify(error))
}
console.info('startSyncRemoteMissions finished')}
)
} catch (error) { } catch (error) {
console.error('startSyncRemoteMissions failed, cause: ' + JSON.stringify(error)) console.error('startSyncRemoteMissions failed, cause: ' + JSON.stringify(error))
} }
``` ```
...@@ -259,20 +261,22 @@ startSyncRemoteMissions(parameter: MissionParameter): Promise&lt;void&gt; ...@@ -259,20 +261,22 @@ startSyncRemoteMissions(parameter: MissionParameter): Promise&lt;void&gt;
**示例:** **示例:**
```ts ```ts
var parameter = { import distributedMissionManager from '@ohos.distributedMissionManager'
deviceId: "", import { BusinessError } from '@ohos.base';
fixConflict: false,
tag: 0
};
try { try {
distributedMissionManager.startSyncRemoteMissions(parameter) distributedMissionManager.startSyncRemoteMissions(
.then(data => { {
console.info('startSyncRemoteMissions finished, ' + JSON.stringify(data)); deviceId: "",
}).catch(error => { fixConflict: false,
console.error('startSyncRemoteMissions failed, cause: ' + JSON.stringify(error)); tag: 0
}) }
).then(() => {
console.info('startSyncRemoteMissions finished successfully');
}).catch((error: BusinessError) => {
console.error('startSyncRemoteMissions failed, cause: ' + JSON.stringify(error));
})
} catch (error) { } catch (error) {
console.error('startSyncRemoteMissions failed, cause: ' + JSON.stringify(error)) console.error('startSyncRemoteMissions failed, cause: ' + JSON.stringify(error))
} }
``` ```
...@@ -296,18 +300,21 @@ stopSyncRemoteMissions(parameter: MissionDeviceInfo, callback: AsyncCallback&lt; ...@@ -296,18 +300,21 @@ stopSyncRemoteMissions(parameter: MissionDeviceInfo, callback: AsyncCallback&lt;
**示例:** **示例:**
```ts ```ts
var parameter = { import distributedMissionManager from '@ohos.distributedMissionManager'
deviceId: "" import { BusinessError } from '@ohos.base';
};
try { try {
distributedMissionManager.stopSyncRemoteMissions(parameter, (error) => { distributedMissionManager.stopSyncRemoteMissions(
if (error.code != 0) { {
console.error('stopSyncRemoteMissions failed, cause: ' + JSON.stringify(error)) deviceId: ""
} },
console.info('stopSyncRemoteMissions finished') (error: BusinessError) => {
}) if (error.code != 0) {
console.error('stopSyncRemoteMissions failed, cause: ' + JSON.stringify(error))
}
console.info('stopSyncRemoteMissions finished')}
)
} catch (error) { } catch (error) {
console.error('stopSyncRemoteMissions failed, cause: ' + JSON.stringify(error)) console.error('stopSyncRemoteMissions failed, cause: ' + JSON.stringify(error))
} }
``` ```
...@@ -336,18 +343,19 @@ stopSyncRemoteMissions(parameter: MissionDeviceInfo): Promise&lt;void&gt; ...@@ -336,18 +343,19 @@ stopSyncRemoteMissions(parameter: MissionDeviceInfo): Promise&lt;void&gt;
**示例:** **示例:**
```ts ```ts
var parameter = { import distributedMissionManager from '@ohos.distributedMissionManager'
deviceId: "" import { BusinessError } from '@ohos.base';
};
try { try {
distributedMissionManager.stopSyncRemoteMissions(parameter) distributedMissionManager.stopSyncRemoteMissions(
.then(data => { {
console.info('stopSyncRemoteMissions finished, ' + JSON.stringify(data)); deviceId: ""
}).catch(error => { }).then((data: void) => {
console.error('stopSyncRemoteMissions failed, cause: ' + JSON.stringify(error)); console.info('stopSyncRemoteMissions finished successfully');
}) }).catch((error: BusinessError) => {
console.error('stopSyncRemoteMissions failed, cause: ' + JSON.stringify(error));
})
} catch (error) { } catch (error) {
console.error('stopSyncRemoteMissions failed, cause: ' + JSON.stringify(error)) console.error('stopSyncRemoteMissions failed, cause: ' + JSON.stringify(error))
} }
``` ```
...@@ -385,27 +393,28 @@ continueMission(parameter: ContinueDeviceInfo, options: ContinueCallback, callba ...@@ -385,27 +393,28 @@ continueMission(parameter: ContinueDeviceInfo, options: ContinueCallback, callba
**示例:** **示例:**
```ts ```ts
var parameter = { import distributedMissionManager from '@ohos.distributedMissionManager'
srcDeviceId: "", import { BusinessError } from '@ohos.base';
dstDeviceId: "", function onContinueDone(resultCode: number): void {
missionId: 1, console.log('onContinueDone resultCode: ' + JSON.stringify(resultCode));
wantParam: {"key": "value"}
};
function onContinueDone(resultCode) {
console.log('onContinueDone resultCode: ' + JSON.stringify(resultCode));
};
var options = {
onContinueDone: onContinueDone
}; };
try { try {
distributedMissionManager.continueMission(parameter, options, (error) => { distributedMissionManager.continueMission(
if (error.code != 0) { {
console.error('continueMission failed, cause: ' + JSON.stringify(error)) srcDeviceId: "",
} dstDeviceId: "",
console.info('continueMission finished') missionId: 1,
}) wantParam: {"key": "value"}
},
{ onContinueDone: onContinueDone },
(error: BusinessError) => {
if (error.code != 0) {
console.error('continueMission failed, cause: ' + JSON.stringify(error))
}
console.info('continueMission finished')
})
} catch (error) { } catch (error) {
console.error('continueMission failed, cause: ' + JSON.stringify(error)) console.error('continueMission failed, cause: ' + JSON.stringify(error))
} }
``` ```
...@@ -448,27 +457,26 @@ continueMission(parameter: ContinueDeviceInfo, options: ContinueCallback): Promi ...@@ -448,27 +457,26 @@ continueMission(parameter: ContinueDeviceInfo, options: ContinueCallback): Promi
**示例:** **示例:**
```ts ```ts
var parameter = { import distributedMissionManager from '@ohos.distributedMissionManager'
srcDeviceId: "", import { BusinessError } from '@ohos.base';
dstDeviceId: "", function onContinueDone(resultCode: number): void {
missionId: 1, console.log('onContinueDone resultCode: ' + JSON.stringify(resultCode));
wantParam: {"key": "value"}
};
function onContinueDone(resultCode) {
console.log('onContinueDone resultCode: ' + JSON.stringify(resultCode));
};
var options = {
onContinueDone: onContinueDone
}; };
try { try {
distributedMissionManager.continueMission(parameter, options) distributedMissionManager.continueMission(
.then(data => { {
console.info('continueMission finished, ' + JSON.stringify(data)); srcDeviceId: "",
}).catch(error => { dstDeviceId: "",
console.error('continueMission failed, cause: ' + JSON.stringify(error)); missionId: 1,
}) wantParam: {"key": "value"}
},
{ onContinueDone: onContinueDone }).then(() => {
console.info('continueMission finished successfully');
}).catch((error: BusinessError) => {
console.error('continueMission failed, cause: ' + JSON.stringify(error));
})
} catch (error) { } catch (error) {
console.error('continueMission failed, cause: ' + JSON.stringify(error)) console.error('continueMission failed, cause: ' + JSON.stringify(error))
} }
``` ```
...@@ -505,21 +513,24 @@ continueMission(parameter: ContinueMissionInfo, callback: AsyncCallback&lt;void& ...@@ -505,21 +513,24 @@ continueMission(parameter: ContinueMissionInfo, callback: AsyncCallback&lt;void&
**示例:** **示例:**
```ts ```ts
var parameter = { import distributedMissionManager from '@ohos.distributedMissionManager'
srcDeviceId: "", import { BusinessError } from '@ohos.base';
dstDeviceId: "",
bundleName: "ohos.test.continueapp",
wantParam: {"key": "value"}
};
try { try {
distributedMissionManager.continueMission(parameter, (error) => { distributedMissionManager.continueMission(
if (error.code != 0) { {
console.error('continueMission failed, cause: ' + JSON.stringify(error)) srcDeviceId: "",
} dstDeviceId: "",
console.info('continueMission finished') bundleName: "ohos.test.continueapp",
}) wantParam: {"key": "value"}
},
(error: BusinessError) => {
if (error.code != 0) {
console.error('continueMission failed, cause: ' + JSON.stringify(error))
}
console.info('continueMission finished')
})
} catch (error) { } catch (error) {
console.error('continueMission failed, cause: ' + JSON.stringify(error)) console.error('continueMission failed, cause: ' + JSON.stringify(error))
} }
``` ```
...@@ -561,17 +572,19 @@ continueMission(parameter: ContinueMissionInfo): Promise&lt;void&gt; ...@@ -561,17 +572,19 @@ continueMission(parameter: ContinueMissionInfo): Promise&lt;void&gt;
**示例:** **示例:**
```ts ```ts
var parameter = { import distributedMissionManager from '@ohos.distributedMissionManager'
srcDeviceId: "", import { BusinessError } from '@ohos.base';
dstDeviceId: "",
bundleName: "ohos.test.continueapp",
wantParam: {"key": "value"}
};
try { try {
distributedMissionManager.continueMission(parameter) distributedMissionManager.continueMission(
.then(data => { {
console.info('continueMission finished, ' + JSON.stringify(data)); srcDeviceId: "",
}).catch(error => { dstDeviceId: "",
bundleName: "ohos.test.continueapp",
wantParam: {"key": "value"}
}
).then(() => {
console.info('continueMission finished successfully');
}).catch((error: BusinessError) => {
console.error('continueMission failed, cause: ' + JSON.stringify(error)); console.error('continueMission failed, cause: ' + JSON.stringify(error));
}) })
} catch (error) { } catch (error) {
...@@ -599,12 +612,13 @@ on(type: 'continueStateChange', callback: Callback&lt;{ state: ContinueState, i ...@@ -599,12 +612,13 @@ on(type: 'continueStateChange', callback: Callback&lt;{ state: ContinueState, i
**示例:** **示例:**
```js ```js
import distributedMissionManager from '@ohos.distributedMissionManager'
try { try {
distributedMissionManager.on('continueStateChange', (data) => { distributedMissionManager.on('continueStateChange', (data) => {
console.info("continueStateChange on:" + JSON.stringify(data)); console.info("continueStateChange on:" + JSON.stringify(data));
}); });
} catch (err) { } catch (error) {
console.error("continueStateChange errCode:" + err.code + ",errMessage:" + err.message); console.error("continueStateChange err: " + JSON.stringify(error));
} }
``` ```
...@@ -628,12 +642,13 @@ off(type: 'continueStateChange', callback?: Callback&lt;{ state: ContinueState, ...@@ -628,12 +642,13 @@ off(type: 'continueStateChange', callback?: Callback&lt;{ state: ContinueState,
**示例:** **示例:**
```js ```js
import distributedMissionManager from '@ohos.distributedMissionManager'
try { try {
distributedMissionManager.off('continueStateChange', (data) => { distributedMissionManager.off('continueStateChange', (data) => {
console.info("continueStateChange on:" + JSON.stringify(data)); console.info("continueStateChange off:" + JSON.stringify(data));
}); });
} catch (err) { } catch (err) {
console.error("continueStateChange errCode:" + err.code + ",errMessage:" + err.message); console.error("continueStateChange err: " + JSON.stringify(error));
} }
``` ```
......
...@@ -25,13 +25,13 @@ import distributedMissionManager from '@ohos.distributedMissionManager'; ...@@ -25,13 +25,13 @@ import distributedMissionManager from '@ohos.distributedMissionManager';
**示例:** **示例:**
```js ```js
import distributedMissionManager from '@ohos.distributedMissionManager'; import distributedMissionManager from '@ohos.distributedMissionManager';
try { try {
distributedMissionManager.on('continueStateChange', (data) => { distributedMissionManager.on('continueStateChange', (data) => {
console.info("continueStateChange on:" + JSON.stringify(data)); console.info("continueStateChange on:" + JSON.stringify(data));
}); });
} catch (err) { } catch (err) {
console.error("continueStateChange errCode:" + err.code + ",errMessage:" + err.message); console.error("continueStateChange err: " + JSON.stringify(err));
} }
``` ```
\ No newline at end of file \ No newline at end of file
...@@ -26,26 +26,25 @@ Mission迁移完成后调用,返回迁移结果。 ...@@ -26,26 +26,25 @@ Mission迁移完成后调用,返回迁移结果。
```ts ```ts
import distributedMissionManager from '@ohos.distributedMissionManager'; import distributedMissionManager from '@ohos.distributedMissionManager';
import { BusinessError } from '@ohos.base';
let continueDeviceInfo = { distributedMissionManager.continueMission(
{
srcDeviceId: '123', srcDeviceId: '123',
dstDeviceId: '456', dstDeviceId: '456',
missionId: 123, missionId: 123,
wantParam: { wantParam: {
'key':'value' 'key':'value'
} }
}; },
{
let continueCallback = {
onContinueDone(result) { onContinueDone(result) {
console.log('onContinueDone, result: ${JSON.stringify(result)}'); console.log('onContinueDone, result: ${JSON.stringify(result)}');
} }
}; }, (error: BusinessError) => {
distributedMissionManager.continueMission(continueDeviceInfo, continueCallback, (error) => {
if (error && error.code) { if (error && error.code) {
console.error('continueMission failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('continueMission failed, error.code: ${error.code}, error.message: ${error.message}');
} }
console.log('continueMission finished'); console.log('continueMission finished');
}); });
``` ```
...@@ -24,22 +24,20 @@ ...@@ -24,22 +24,20 @@
```ts ```ts
import distributedMissionManager from '@ohos.distributedMissionManager'; import distributedMissionManager from '@ohos.distributedMissionManager';
let continueDeviceInfo = { distributedMissionManager.continueMission(
{
srcDeviceId: '123', srcDeviceId: '123',
dstDeviceId: '456', dstDeviceId: '456',
missionId: 123, missionId: 123,
wantParam: { wantParam: {
'key':'value' 'key':'value'
} }
}; },
{
let continueCallback = { onContinueDone(result): void {
onContinueDone(result) {
console.log('onContinueDone, result: ${JSON.stringify(result)}'); console.log('onContinueDone, result: ${JSON.stringify(result)}');
} }
}; }, (error) => {
distributedMissionManager.continueMission(continueDeviceInfo, continueCallback, (error) => {
if (error && error.code) { if (error && error.code) {
console.error('continueMission failed, error.code: ${error.code}, error.message: ${error.message}'); console.error('continueMission failed, error.code: ${error.code}, error.message: ${error.message}');
} }
......
...@@ -28,15 +28,16 @@ import distributedMissionManager from '@ohos.distributedMissionManager'; ...@@ -28,15 +28,16 @@ import distributedMissionManager from '@ohos.distributedMissionManager';
```ts ```ts
import distributedMissionManager from '@ohos.distributedMissionManager'; import distributedMissionManager from '@ohos.distributedMissionManager';
import { BusinessError } from '@ohos.base';
var parameter = {
srcDeviceId: "",
dstDeviceId: "",
bundleName: "ohos.test.continueapp",
wantParam: {"key": "value"}
};
try { try {
distributedMissionManager.continueMission(parameter, (error) => { distributedMissionManager.continueMission(
{
srcDeviceId: "",
dstDeviceId: "",
bundleName: "ohos.test.continueapp",
wantParam: {"key": "value"}
}, (error: BusinessError) => {
if (error.code != 0) { if (error.code != 0) {
console.error('continueMission failed, cause: ' + JSON.stringify(error)) console.error('continueMission failed, cause: ' + JSON.stringify(error))
} }
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册