!16092 API9终审资料修改挑单3.2Release

Merge pull request !16092 from dy/API9_changelog_3.2Releae

zh-cn/application-dev/application-models/hop-multi-device-collaboration.md

@@ -331,8 +331,8 @@
 | startAbilityByCall(want: Want): Promise<Caller>; | 启动指定UIAbility至前台或后台，同时获取其Caller通信接口，调用方可使用Caller与被启动的Ability进行通信。 |
 | on(method: string, callback: CalleeCallBack): void | 通用组件Callee注册method对应的callback方法。 |
 | off(method: string): void | 通用组件Callee解注册method的callback方法。 |
-| call(method: string, data: rpc.Sequenceable): Promise<void> | 向通用组件Callee发送约定序列化数据。 |
-| callWithResult(method: string, data: rpc.Sequenceable): Promise<rpc.MessageParcel> | 向通用组件Callee发送约定序列化数据, 并将Callee返回的约定序列化数据带回。 |
+| call(method: string, data: rpc.Parcelable): Promise<void> | 向通用组件Callee发送约定序列化数据。 |
+| callWithResult(method: string, data: rpc.Parcelable): Promise<rpc.MessageSequence> | 向通用组件Callee发送约定序列化数据, 并将Callee返回的约定序列化数据带回。 |
 | release(): void | 释放通用组件的Caller通信接口。 |
 | on(type: "release", callback: OnReleaseCallback): void | 注册通用组件通信断开监听通知。 |
 
@@ -401,7 +401,7 @@
 
        
        ```ts
-       export default class MySequenceable {
+       export default class MyParcelable {
            num: number = 0
            str: string = ""
        
@@ -410,15 +410,15 @@
                this.str = string
            }
        
-           marshalling(messageParcel) {
-               messageParcel.writeInt(this.num)
-               messageParcel.writeString(this.str)
+           marshalling(messageSequence) {
+               messageSequence.writeInt(this.num)
+               messageSequence.writeString(this.str)
                return true
            }
        
-           unmarshalling(messageParcel) {
-               this.num = messageParcel.readInt()
-               this.str = messageParcel.readString()
+           unmarshalling(messageSequence) {
+               this.num = messageSequence.readInt()
+               this.str = messageSequence.readString()
                return true
            }
        }
@@ -434,13 +434,13 @@
            console.info('CalleeSortFunc called')
        
            // 获取Caller发送的序列化数据
-           let receivedData = new MySequenceable(0, '')
-           data.readSequenceable(receivedData)
+           let receivedData = new MyParcelable(0, '')
+           data.readParcelable(receivedData)
            console.info(`receiveData[${receivedData.num}, ${receivedData.str}]`)
        
            // 作相应处理
            // 返回序列化数据result给Caller
-           return new MySequenceable(receivedData.num + 1, `send ${receivedData.str} succeed`)
+           return new MyParcelable(receivedData.num + 1, `send ${receivedData.str} succeed`)
        }
        
        export default class CalleeAbility extends Ability {
@@ -500,13 +500,13 @@
        getRemoteDeviceId方法参照[通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据](#通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据)。
 
 5. 向被调用端UIAbility发送约定序列化数据。
-   1. 向被调用端发送Sequenceable数据有两种方式，一种是不带返回值，一种是获取被调用端返回的数据，method以及序列化数据需要与被调用端协商一致。如下示例调用Call接口，向Callee被调用端发送数据。
+   1. 向被调用端发送Parcelable数据有两种方式，一种是不带返回值，一种是获取被调用端返回的数据，method以及序列化数据需要与被调用端协商一致。如下示例调用Call接口，向Callee被调用端发送数据。
       
        ```ts
        const MSG_SEND_METHOD: string = 'CallSendMsg'
        async onButtonCall() {
            try {
-               let msg = new MySequenceable(1, 'origin_Msg')
+               let msg = new MyParcelable(1, 'origin_Msg')
                await this.caller.call(MSG_SEND_METHOD, msg)
            } catch (error) {
                console.info(`caller call failed with ${error}`)
@@ -521,12 +521,12 @@
        backMsg: string = ''
        async onButtonCallWithResult(originMsg, backMsg) {
            try {
-               let msg = new MySequenceable(1, originMsg)
+               let msg = new MyParcelable(1, originMsg)
                const data = await this.caller.callWithResult(MSG_SEND_METHOD, msg)
                console.info('caller callWithResult succeed')
        
-               let result = new MySequenceable(0, '')
-               data.readSequenceable(result)
+               let result = new MyParcelable(0, '')
+               data.readParcelable(result)
                backMsg(result.str)
                console.info(`caller result is [${result.num}, ${result.str}]`)
            } catch (error) {

zh-cn/application-dev/application-models/uiability-intra-device-interaction.md

@@ -469,8 +469,8 @@ Call功能主要接口如下表所示。具体的API详见[接口文档](../refe
 | startAbilityByCall(want: Want): Promise<Caller> | 启动指定UIAbility并获取其Caller通信接口，默认为后台启动，通过配置want可实现前台启动，详见[接口文档](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextstartabilitybycall)。AbilityContext与ServiceExtensionContext均支持该接口。 |
 | on(method: string, callback: CalleeCallBack): void | 通用组件Callee注册method对应的callback方法。 |
 | off(method: string): void | 通用组件Callee解注册method的callback方法。 |
-| call(method: string, data: rpc.Sequenceable): Promise<void> | 向通用组件Callee发送约定序列化数据。 |
-| callWithResult(method: string, data: rpc.Sequenceable): Promise<rpc.MessageParcel> | 向通用组件Callee发送约定序列化数据, 并将Callee返回的约定序列化数据带回。 |
+| call(method: string, data: rpc.Parcelable): Promise<void> | 向通用组件Callee发送约定序列化数据。 |
+| callWithResult(method: string, data: rpc.Parcelable): Promise<rpc.MessageSequence> | 向通用组件Callee发送约定序列化数据, 并将Callee返回的约定序列化数据带回。 |
 | release(): void | 释放通用组件的Caller通信接口。 |
 | on(type: "release", callback: OnReleaseCallback): void | 注册通用组件通信断开监听通知。 |
 
@@ -518,7 +518,7 @@ Call功能主要接口如下表所示。具体的API详见[接口文档](../refe
 
    
    ```ts
-   export default class MySequenceable {
+   export default class MyParcelable {
        num: number = 0
        str: string = ""
    
@@ -527,15 +527,15 @@ Call功能主要接口如下表所示。具体的API详见[接口文档](../refe
            this.str = string
        }
    
-       marshalling(messageParcel) {
-           messageParcel.writeInt(this.num)
-           messageParcel.writeString(this.str)
+       marshalling(messageSequence) {
+           messageSequence.writeInt(this.num)
+           messageSequence.writeString(this.str)
            return true
        }
    
-       unmarshalling(messageParcel) {
-           this.num = messageParcel.readInt()
-           this.str = messageParcel.readString()
+       unmarshalling(messageSequence) {
+           this.num = messageSequence.readInt()
+           this.str = messageSequence.readString()
            return true
        }
    }
@@ -553,13 +553,13 @@ Call功能主要接口如下表所示。具体的API详见[接口文档](../refe
        console.info('CalleeSortFunc called');
    
        // 获取Caller发送的序列化数据
-       let receivedData = new MySequenceable(0, '');
-       data.readSequenceable(receivedData);
+       let receivedData = new MyParcelable(0, '');
+       data.readParcelable(receivedData);
        console.info(`receiveData[${receivedData.num}, ${receivedData.str}]`);
    
        // 作相应处理
        // 返回序列化数据result给Caller
-       return new MySequenceable(receivedData.num + 1, `send ${receivedData.str} succeed`);
+       return new MyParcelable(receivedData.num + 1, `send ${receivedData.str} succeed`);
    }
    
    export default class CalleeAbility extends Ability {

zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md

@@ -316,10 +316,10 @@ call(method: string, data: rpc.Parcelable): Promise<void>;
 
 **参数：**
 
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| method | string | 是 | 约定的服务端注册事件字符串。 |
-| data | [rpc.Parcelable](js-apis-rpc.md#parcelabledeprecated) | 是 | 由开发者实现的Sequenceable可序列化数据。 |
+  | 参数名 | 类型 | 必填 | 说明 | 
+  | -------- | -------- | -------- | -------- |
+  | method | string | 是 | 约定的服务端注册事件字符串。 | 
+  | data | [rpc.Parcelable](js-apis-rpc.md#parcelable9) | 是 | 由开发者实现的Parcelable可序列化数据。 |
 
 **返回值：**
 
@@ -337,7 +337,7 @@ call(method: string, data: rpc.Parcelable): Promise<void>;
 **示例：**
     
   ```ts
-  class MyMessageAble{ // 自定义的Sequenceable数据结构
+  class MyMessageAble{ // 自定义的Parcelable数据结构
     name:''
     str:''
     num: 1
@@ -345,15 +345,15 @@ call(method: string, data: rpc.Parcelable): Promise<void>;
       this.name = name;
       this.str = str;
     }
-    marshalling(messageParcel) {
-      messageParcel.writeInt(this.num);
-      messageParcel.writeString(this.str);
+    marshalling(messageSequence) {
+      messageSequence.writeInt(this.num);
+      messageSequence.writeString(this.str);
       console.log('MyMessageAble marshalling num[' + this.num + '] str[' + this.str + ']');
       return true;
     }
-    unmarshalling(messageParcel) {
-      this.num = messageParcel.readInt();
-      this.str = messageParcel.readString();
+    unmarshalling(messageSequence) {
+      this.num = messageSequence.readInt();
+      this.str = messageSequence.readString();
       console.log('MyMessageAble unmarshalling num[' + this.num + '] str[' + this.str + ']');
       return true;
     }
@@ -368,7 +368,7 @@ call(method: string, data: rpc.Parcelable): Promise<void>;
         deviceId: ''
       }).then((obj) => {
         caller = obj;
-        let msg = new MyMessageAble('msg', 'world'); // 参考Sequenceable数据定义
+        let msg = new MyMessageAble('msg', 'world'); // 参考Parcelable数据定义
         caller.call(method, msg)
           .then(() => {
             console.log('Caller call() called');
@@ -388,7 +388,7 @@ call(method: string, data: rpc.Parcelable): Promise<void>;
 
 ## Caller.callWithResult
 
-callWithResult(method: string, data: rpc.Parcelable): Promise<rpc.MessageParcel>;
+callWithResult(method: string, data: rpc.Parcelable): Promise<rpc.MessageSequence>;
 
 向通用组件服务端发送约定序列化数据, 并将服务端返回的约定序列化数据带回。
 
@@ -396,16 +396,16 @@ callWithResult(method: string, data: rpc.Parcelable): Promise<rpc.MessageParc
 
 **参数：**
 
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| method | string | 是 | 约定的服务端注册事件字符串。 |
-| data | [rpc.Parcelable](js-apis-rpc.md#parcelabledeprecated) | 是 | 由开发者实现的Sequenceable可序列化数据。 |
+  | 参数名 | 类型 | 必填 | 说明 | 
+  | -------- | -------- | -------- | -------- |
+  | method | string | 是 | 约定的服务端注册事件字符串。 | 
+  | data | [rpc.Parcelable](js-apis-rpc.md#parcelable9) | 是 | 由开发者实现的Parcelable可序列化数据。 |
 
 **返回值：**
 
-| 类型 | 说明 |
-| -------- | -------- |
-| Promise<[rpc.MessageParcel](js-apis-rpc.md#sequenceabledeprecated)> | Promise形式返回通用组件服务端应答数据。 |
+  | 类型 | 说明 | 
+  | -------- | -------- |
+  | Promise<[rpc.MessageSequence](js-apis-rpc.md#messagesequence9)> | Promise形式返回通用组件服务端应答数据。 |
 
 **错误码：**
 
@@ -425,15 +425,15 @@ callWithResult(method: string, data: rpc.Parcelable): Promise<rpc.MessageParc
       this.name = name;
       this.str = str;
     }
-    marshalling(messageParcel) {
-      messageParcel.writeInt(this.num);
-      messageParcel.writeString(this.str);
+    marshalling(messageSequence) {
+      messageSequence.writeInt(this.num);
+      messageSequence.writeString(this.str);
       console.log('MyMessageAble marshalling num[' + this.num + '] str[' + this.str + ']');
       return true;
     }
-    unmarshalling(messageParcel) {
-      this.num = messageParcel.readInt();
-      this.str = messageParcel.readString();
+    unmarshalling(messageSequence) {
+      this.num = messageSequence.readInt();
+      this.str = messageSequence.readString();
       console.log('MyMessageAble unmarshalling num[' + this.num + '] str[' + this.str + ']');
       return true;
     }
@@ -453,7 +453,7 @@ callWithResult(method: string, data: rpc.Parcelable): Promise<rpc.MessageParc
           .then((data) => {
             console.log('Caller callWithResult() called');
             let retmsg = new MyMessageAble(0, '');
-            data.readSequenceable(retmsg);
+            data.readParcelable(retmsg);
           })
           .catch((callErr) => {
             console.log('Caller.callWithResult catch error, error.code: ' + JSON.stringify(callErr.code) +
@@ -720,11 +720,11 @@ on(method: string, callback: CalleeCallback): void;
 
 **参数：**
 
-| 参数名 | 类型 | 必填 | 说明 |
-| -------- | -------- | -------- | -------- |
-| method | string | 是 | 与客户端约定的通知消息字符串。 |
-| callback | [CalleeCallback](#calleecallback) | 是 | 一个[rpc.MessageParcel](js-apis-rpc.md#sequenceabledeprecated)类型入参的js通知同步回调函数, 回调函数至少要返回一个空的[rpc.Sequenceable](js-apis-rpc.md#sequenceabledeprecated)数据对象, 其他视为函数执行错误。 |
-
+  | 参数名 | 类型 | 必填 | 说明 | 
+  | -------- | -------- | -------- | -------- |
+  | method | string | 是 | 与客户端约定的通知消息字符串。 | 
+  | callback | [CalleeCallback](#calleecallback) | 是 | 一个[rpc.MessageSequence](js-apis-rpc.md#messagesequence9)类型入参的js通知同步回调函数, 回调函数至少要返回一个空的[rpc.Parcelable](js-apis-rpc.md#parcelable9)数据对象, 其他视为函数执行错误。 |
+ 
 **错误码：**
 
 | 错误码ID | 错误信息 |
@@ -743,15 +743,15 @@ on(method: string, callback: CalleeCallback): void;
         this.name = name;
         this.str = str;
       }
-      marshalling(messageParcel) {
-          messageParcel.writeInt(this.num);
-          messageParcel.writeString(this.str);
+      marshalling(messageSequence) {
+          messageSequence.writeInt(this.num);
+          messageSequence.writeString(this.str);
           console.log('MyMessageAble marshalling num[' + this.num + '] str[' + this.str + ']');
           return true;
       }
-      unmarshalling(messageParcel) {
-          this.num = messageParcel.readInt();
-          this.str = messageParcel.readString();
+      unmarshalling(messageSequence) {
+          this.num = messageSequence.readInt();
+          this.str = messageSequence.readString();
           console.log('MyMessageAble unmarshalling num[' + this.num + '] str[' + this.str + ']');
           return true;
       }
@@ -760,7 +760,7 @@ on(method: string, callback: CalleeCallback): void;
   function funcCallBack(pdata) {
       console.log('Callee funcCallBack is called ' + pdata);
       let msg = new MyMessageAble('test', '');
-      pdata.readSequenceable(msg);
+      pdata.readParcelable(msg);
       return new MyMessageAble('test1', 'Callee test');
   }
   export default class MainAbility extends Ability {
@@ -827,10 +827,10 @@ off(method: string): void;
 
 ## CalleeCallback
 
-(indata: rpc.MessageParcel): rpc.Parcelable;
+(indata: rpc.MessageSequence): rpc.Parcelable;
 
 **系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
 
 | 名称 | 可读 | 可写 | 类型 | 说明 |
 | -------- | -------- | -------- | -------- | -------- |
-| (indata: [rpc.MessageParcel](js-apis-rpc.md#sequenceabledeprecated)) | 是 | 否 | [rpc.Parcelable](js-apis-rpc.md#parcelabledeprecated) | 被调用方注册的消息侦听器函数接口的原型。 |
+| (indata: [rpc.MessageSequence](js-apis-rpc.md#messagesequence9)) | 是 | 否 | [rpc.Parcelable](js-apis-rpc.md#parcelable9) | 被调用方注册的消息侦听器函数接口的原型。 |

zh-cn/application-dev/task-management/continuous-task-dev-guide.md

@@ -345,7 +345,7 @@ function stopContinuousTask() {
     }
 }
 
-class MySequenceable {
+class MyParcelable {
     num: number = 0;
     str: String = "";
 
@@ -354,23 +354,23 @@ class MySequenceable {
         this.str = string;
     }
 
-    marshalling(messageParcel) {
-        messageParcel.writeInt(this.num);
-        messageParcel.writeString(this.str);
+    marshalling(messageSequence) {
+        messageSequence.writeInt(this.num);
+        messageSequence.writeString(this.str);
         return true;
     }
 
-    unmarshalling(messageParcel) {
-        this.num = messageParcel.readInt();
-        this.str = messageParcel.readString();
+    unmarshalling(messageSequence) {
+        this.num = messageSequence.readInt();
+        this.str = messageSequence.readString();
         return true;
     }
 }
 
 function sendMsgCallback(data) {
     console.info('BgTaskAbility funcCallBack is called ' + data)
-    let receivedData = new MySequenceable(0, "")
-    data.readSequenceable(receivedData)
+    let receivedData = new MyParcelable(0, "")
+    data.readParcelable(receivedData)
     console.info(`receiveData[${receivedData.num}, ${receivedData.str}]`)
     // 可以根据Caller端发送的序列化数据的str值，执行不同的方法。
     if (receivedData.str === 'start_bgtask') {
@@ -378,7 +378,7 @@ function sendMsgCallback(data) {
     } else if (receivedData.str === 'stop_bgtask') {
         stopContinuousTask();
     }
-    return new MySequenceable(10, "Callee test");
+    return new MyParcelable(10, "Callee test");
 }
 
 export default class BgTaskAbility extends Ability {