资料修改 Signed-off-by: hwgaizw <gaizhengwei@huawei.com>

Signed-off-by: Nhwgaizw <gaizhengwei@huawei.com>
Change-Id: I83d447fc47f7b295753d309ee02bdf29ac5109c8

zh-cn/application-dev/media/audio-playback.md

@@ -25,6 +25,9 @@
 AudioPlayer支持的src媒体源输入类型可参考：[src属性说明](../reference/apis/js-apis-media.md#audioplayer_属性)
 
 ```js
+import media from '@ohos.multimedia.media'
+import fileIO from '@ohos.fileio'
+
 function SetCallBack(audioPlayer) {
     audioPlayer.on('dataLoad', () => {              //设置'dataLoad'事件回调，src属性设置成功后，触发此回调
         console.info('audio set source success');
@@ -79,8 +82,19 @@ function printfDescription(obj) {
 //1、创建实例
 let audioPlayer = media.createAudioPlayer();
 SetCallBack(audioPlayer);                          //设置事件回调
-//2、用户选择音频，设置uri
-audioPlayer.src = 'file:///data/data/ohos.xxx.xxx/files/test.mp3';  //设置src属性，并触发'dataLoad'事件回调
+/* 用户选择视频设置fd(本地播放) */
+let fdPath = 'fd://'
+let path = 'data/accounts/account_0/appdata/ohos.xxx.xxx.xxx/01.mp3';
+await fileIO.open(path).then(fdNumber) => {
+   fdPath = fdPath + " + fdNumber;
+   console.info('open fd sucess fd is' + fdPath);
+}, (err) => {
+   console.info('open fd failed err is' + err);
+}),catch((err) => {
+   console.info('open fd failed err is' + err);
+});
+
+audioPlayer.src = fdPath;                         //设置src属性，并触发'dataLoad'事件回调
 //3、播放音频
 audioPlayer.play();                               //需等待'dataLoad'事件回调完成后，才可调用play进行播放，触发'play'事件回调
 //4、跳转播放位置
@@ -111,6 +125,9 @@ audioPlayer = undefined;
 ### 正常播放场景
 
 ```js
+import media from '@ohos.multimedia.media'
+import fileIO from '@ohos.fileio'
+
 function SetCallBack(audioPlayer) {
     audioPlayer.on('dataLoad', () => {              //设置'dataLoad'事件回调，src属性设置成功后，触发此回调
         console.info('audio set source success');
@@ -128,13 +145,27 @@ function SetCallBack(audioPlayer) {
 
 let audioPlayer = media.createAudioPlayer();       //创建一个音频播放实例
 SetCallBack(audioPlayer);                          //设置事件回调
-/* 用户选择音频，设置uri */
-audioPlayer.src = 'file:///data/data/ohos.xxx.xxx/files/test.mp3';  //设置src属性，并触发'dataLoad'事件回调
+/* 用户选择视频设置fd(本地播放) */
+let fdPath = 'fd://'
+let path = 'data/accounts/account_0/appdata/ohos.xxx.xxx.xxx/01.mp3';
+await fileIO.open(path).then(fdNumber) => {
+   fdPath = fdPath + " + fdNumber;
+   console.info('open fd sucess fd is' + fdPath);
+}, (err) => {
+   console.info('open fd failed err is' + err);
+}),catch((err) => {
+   console.info('open fd failed err is' + err);
+});
+
+audioPlayer.src = fdPath;                           //设置src属性，并触发'dataLoad'事件回调
 ```
 
 ### 切歌场景
 
 ```js
+import media from '@ohos.multimedia.media'
+import fileIO from '@ohos.fileio'
+
 function SetCallBack(audioPlayer) {
     audioPlayer.on('dataLoad', () => {              //设置'dataLoad'事件回调，src属性设置成功后，触发此回调
         console.info('audio set source success');
@@ -152,16 +183,42 @@ function SetCallBack(audioPlayer) {
 
 let audioPlayer = media.createAudioPlayer();       //创建一个音频播放实例
 SetCallBack(audioPlayer);                          //设置事件回调
-/* 用户选择音频，设置uri */
-audioPlayer.src = 'file:///data/data/ohos.xxx.xxx/files/test.mp3';  //设置src属性，并触发'dataLoad'事件回调
+/* 用户选择视频设置fd(本地播放) */
+let fdPath = 'fd://'
+let path = 'data/accounts/account_0/appdata/ohos.xxx.xxx.xxx/01.mp3';
+await fileIO.open(path).then(fdNumber) => {
+   fdPath = fdPath + " + fdNumber;
+   console.info('open fd sucess fd is' + fdPath);
+}, (err) => {
+   console.info('open fd failed err is' + err);
+}),catch((err) => {
+   console.info('open fd failed err is' + err);
+});
+
+audioPlayer.src = fdPath;                           //设置src属性，并触发'dataLoad'事件回调
 /* 播放一段时间后，下发切歌指令 */
 audioPlayer.reset();
-audioPlayer.src = 'file:///data/data/ohos.xxx.xxx/files/next.mp3';
+
+/* 用户选择视频设置fd(本地播放) */
+let fdNextPath = 'fd://'
+let nextPath = 'data/accounts/account_0/appdata/ohos.xxx.xxx.xxx/01.mp3';
+await fileIO.open(nextPath).then(fdNumber) => {
+   fdNextPath = fdNextPath + " + fdNumber;
+   console.info('open fd sucess fd is' + fdNextPath);
+}, (err) => {
+   console.info('open fd failed err is' + err);
+}),catch((err) => {
+   console.info('open fd failed err is' + err);
+});
+audioPlayer.src = fdNextPath;
 ```
 
 ### 单曲循环场景
 
 ```js
+import media from '@ohos.multimedia.media'
+import fileIO from '@ohos.fileio'
+
 function SetCallBack(audioPlayer) {
     audioPlayer.on('dataLoad', () => {              //设置'dataLoad'事件回调，src属性设置成功后，触发此回调
         console.info('audio set source success');
@@ -179,7 +236,19 @@ function SetCallBack(audioPlayer) {
 
 let audioPlayer = media.createAudioPlayer();       //创建一个音频播放实例
 SetCallBack(audioPlayer);                          //设置事件回调
-/* 用户选择音频，设置uri */
-audioPlayer.src = 'file:///data/data/ohos.xxx.xxx/files/test.mp3';  //设置src属性，并触发'dataLoad'事件回调
-audioPlayer.loop = true;                           //设置循环播放属性
+
+/* 用户选择视频设置fd(本地播放) */
+let fdPath = 'fd://'
+let path = 'data/accounts/account_0/appdata/ohos.xxx.xxx.xxx/01.mp3';
+await fileIO.open(path).then(fdNumber) => {
+   fdPath = fdPath + " + fdNumber;
+   console.info('open fd sucess fd is' + fdPath);
+}, (err) => {
+   console.info('open fd failed err is' + err);
+}),catch((err) => {
+   console.info('open fd failed err is' + err);
+});
+
+audioPlayer.src = fdPath;                           //设置src属性，并触发'dataLoad'事件回调
+audioPlayer.loop = true;                            //设置循环播放属性
 ```
\ No newline at end of file

zh-cn/application-dev/media/video-playback.md

@@ -30,10 +30,21 @@
 
 VideoPlayer支持的url媒体源输入类型可参考：[url属性说明](../reference/apis/js-apis-media.md#videoplayer_属性)
 
+Xcomponent创建方法可参考：[Xcomponent创建方法](#Xcomponent创建方法)
+
 ```js
+import media from '@ohos.multimedia.media'
+import fileIO from '@ohos.fileio'
+
 let videoPlayer = undefined; // 用于保存createVideoPlayer创建的对象
 let surfaceID = undefined; // 用于保存Xcomponent接口返回的surfaceID
 
+// 调用Xcomponent的接口用于获取surfaceID，并保存在surfaceID变量中，该接口由XComponent组件默认加载，非主动调用
+LoadXcomponent() {
+	surfaceID = this.$element('Xcomponent').getXComponentSurfaceId();
+    console.info('LoadXcomponent surfaceID is' + surfaceID);
+}
+
 // 函数调用发生错误时用于上报错误信息
 function failureCallback(error) {
     console.info(`error happened,error Name is ${error.name}`);
@@ -67,10 +78,19 @@ await media.createVideoPlayer().then((video) => {
     }
 }, failureCallback).catch(catchCallback);
 
-// 用户选择视频设置url
-videoPlayer.url = 'file:///data/data/ohos.xxx.xxx/files/test.mp4';
+// 用户选择视频设置fd(本地播放)
+let fdPath = 'fd://'
+let path = 'data/accounts/account_0/appdata/ohos.xxx.xxx.xxx/01.mp4';
+await fileIO.open(path).then(fdNumber) => {
+   fdPath = fdPath + " + fdNumber;
+   console.info('open fd sucess fd is' + fdPath);
+}, (err) => {
+   console.info('open fd failed err is' + err);
+}),catch((err) => {
+   console.info('open fd failed err is' + err);
+});
 
-// 该处需要调用Xcomponent的接口用于获取surfaceID，并保存在surfaceID变量中
+videoPlayer.url = fdPath;
 
 // 设置surfaceID用于显示视频画面
 await videoPlayer.setDisplaySurface(surfaceID).then(() => {
@@ -147,9 +167,18 @@ surfaceID = undefined;
 ### 正常播放场景
 
 ```js
+import media from '@ohos.multimedia.media'
+import fileIO from '@ohos.fileio'
+
 let videoPlayer = undefined; // 用于保存createVideoPlayer创建的对象
 let surfaceID = undefined; // 用于保存Xcomponent接口返回的surfaceID
 
+// 调用Xcomponent的接口用于获取surfaceID，并保存在surfaceID变量中，该接口由XComponent组件默认加载，非主动调用
+LoadXcomponent() {
+	surfaceID = this.$element('Xcomponent').getXComponentSurfaceId();
+    console.info('LoadXcomponent surfaceID is' + surfaceID);
+}
+
 // 函数调用发生错误时用于上报错误信息
 function failureCallback(error) {
     console.info(`error happened,error Name is ${error.name}`);
@@ -191,10 +220,19 @@ await media.createVideoPlayer().then((video) => {
 // 设置事件回调
 SetCallBack(videoPlayer);
 
-// 用户选择视频设置url
-videoPlayer.url = 'file:///data/data/ohos.xxx.xxx/files/test.mp4';
+// 用户选择视频设置fd(本地播放)
+let fdPath = 'fd://'
+let path = 'data/accounts/account_0/appdata/ohos.xxx.xxx.xxx/01.mp4';
+await fileIO.open(path).then(fdNumber) => {
+   fdPath = fdPath + " + fdNumber;
+   console.info('open fd sucess fd is' + fdPath);
+}, (err) => {
+   console.info('open fd failed err is' + err);
+}),catch((err) => {
+   console.info('open fd failed err is' + err);
+});
 
-// 该处需要调用Xcomponent的接口用于获取surfaceID，并保存在surfaceID变量中
+videoPlayer.url = fdPath;
 
 // 设置surfaceID用于显示视频画面
 await videoPlayer.setDisplaySurface(surfaceID).then(() => {
@@ -215,9 +253,18 @@ await videoPlayer.play().then(() => {
 ### 切视频场景
 
 ```js
+import media from '@ohos.multimedia.media'
+import fileIO from '@ohos.fileio'
+
 let videoPlayer = undefined; // 用于保存createVideoPlayer创建的对象
 let surfaceID = undefined; // 用于保存Xcomponent接口返回的surfaceID
 
+// 调用Xcomponent的接口用于获取surfaceID，并保存在surfaceID变量中，该接口由XComponent组件默认加载，非主动调用
+LoadXcomponent() {
+	surfaceID = this.$element('Xcomponent').getXComponentSurfaceId();
+    console.info('LoadXcomponent surfaceID is' + surfaceID);
+}
+
 // 函数调用发生错误时用于上报错误信息
 function failureCallback(error) {
     console.info(`error happened,error Name is ${error.name}`);
@@ -259,10 +306,19 @@ await media.createVideoPlayer().then((video) => {
 // 设置事件回调
 SetCallBack(videoPlayer);
 
-// 用户选择视频设置url
-videoPlayer.url = 'file:///data/data/ohos.xxx.xxx/files/test.mp4';
+// 用户选择视频设置fd(本地播放)
+let fdPath = 'fd://'
+let path = 'data/accounts/account_0/appdata/ohos.xxx.xxx.xxx/01.mp4';
+await fileIO.open(path).then(fdNumber) => {
+   fdPath = fdPath + " + fdNumber;
+   console.info('open fd sucess fd is' + fdPath);
+}, (err) => {
+   console.info('open fd failed err is' + err);
+}),catch((err) => {
+   console.info('open fd failed err is' + err);
+});
 
-// 该处需要调用Xcomponent的接口用于获取surfaceID，并保存在surfaceID变量中
+videoPlayer.url = fdPath;
 
 // 设置surfaceID用于显示视频画面
 await videoPlayer.setDisplaySurface(surfaceID).then(() => {
@@ -285,7 +341,19 @@ await videoPlayer.reset().then(() => {
     console.info('reset success');
 }, failureCallback).catch(catchCallback);
 
-videoPlayer.url = 'file:///data/data/ohos.xxx.xxx/files/next.mp4';
+// 用户选择视频设置fd(本地播放)
+let fdNextPath = 'fd://'
+let nextPath = 'data/accounts/account_0/appdata/ohos.xxx.xxx.xxx/02.mp4';
+await fileIO.open(nextPath).then(fdNumber) => {
+   fdNextPath = fdNextPath + " + fdNumber;
+   console.info('open fd sucess fd is' + fdNextPath);
+}, (err) => {
+   console.info('open fd failed err is' + err);
+}),catch((err) => {
+   console.info('open fd failed err is' + err);
+});
+
+videoPlayer.url = fdNextPath;
 
 // 设置surfaceID用于显示视频画面
 await videoPlayer.setDisplaySurface(surfaceID).then(() => {
@@ -306,9 +374,18 @@ await videoPlayer.play().then(() => {
 ### 单个视频循环场景
 
 ```js
+import media from '@ohos.multimedia.media'
+import fileIO from '@ohos.fileio'
+
 let videoPlayer = undefined; // 用于保存createVideoPlayer创建的对象
 let surfaceID = undefined; // 用于保存Xcomponent接口返回的surfaceID
 
+// 调用Xcomponent的接口用于获取surfaceID，并保存在surfaceID变量中，该接口由XComponent组件默认加载，非主动调用
+LoadXcomponent() {
+	surfaceID = this.$element('Xcomponent').getXComponentSurfaceId();
+    console.info('LoadXcomponent surfaceID is' + surfaceID);
+}
+
 // 函数调用发生错误时用于上报错误信息
 function failureCallback(error) {
     console.info(`error happened,error Name is ${error.name}`);
@@ -350,10 +427,19 @@ await media.createVideoPlayer().then((video) => {
 // 设置事件回调
 SetCallBack(videoPlayer);
 
-// 用户选择视频设置url
-videoPlayer.url = 'file:///data/data/ohos.xxx.xxx/files/test.mp4';
+// 用户选择视频设置fd(本地播放)
+let fdPath = 'fd://'
+let path = 'data/accounts/account_0/appdata/ohos.xxx.xxx.xxx/01.mp4';
+await fileIO.open(path).then(fdNumber) => {
+   fdPath = fdPath + " + fdNumber;
+   console.info('open fd sucess fd is' + fdPath);
+}, (err) => {
+   console.info('open fd failed err is' + err);
+}),catch((err) => {
+   console.info('open fd failed err is' + err);
+});
 
-// 该处需要调用Xcomponent的接口用于获取surfaceID，并保存在surfaceID变量中
+videoPlayer.url = fdPath;
 
 // 设置surfaceID用于显示视频画面
 await videoPlayer.setDisplaySurface(surfaceID).then(() => {
@@ -372,4 +458,16 @@ videoPlayer.loop = true;
 await videoPlayer.play().then(() => {
     console.info('play success');
 }, failureCallback).catch(catchCallback);
-```
\ No newline at end of file
+```
+
+### Xcomponent创建方法
+
+```js
+播放视频中获取surfaceID依赖了Xcomponent,需要创建一个和xxx.js同名的xxx.hml文件,xxx.hml里面需要添加如下代码：
+<xcomponent id = 'Xcomponent'
+	  if = "{{isFlush}}" // 刷新surfaceID，isFlush赋值false再赋值true为一次刷新，会主动再次加载LoadXcomponet获取新的surfaceID
+      type = 'surface'
+	  onload = 'LoadXcomponet' // 默认加载接口
+      style = "wodth:720px;height:480px;border-color:red;border-width:5px;"> // 设置窗口宽高等属性
+</xcomponent>
+```

zh-cn/application-dev/reference/apis/js-apis-media.md

@@ -362,7 +362,7 @@ Codec MIME类型枚举
 
 | 名称        | 类型                      | 可读 | 可写 | 说明                                                         |
 | ----------- | ------------------------- | ---- | ---- | ------------------------------------------------------------ |
-| src         | string                    | 是   | 是   | 音频媒体URI，支持当前主流的音频格式(mp4、aac、mp3、ogg)。<br>**支持路径示例**：<br>1、fd类型播放：fd:///xxx<br>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png)<br>2、http网络播放路径：开发中<br>3、hls网络播放路径：开发中<br>**注意事项**：<br>媒体素材需至少赋予读权限后，才可正常播放 |
+| src         | string                    | 是   | 是   | 音频媒体URI，支持当前主流的音频格式(mp4、aac、mp3、ogg)。<br>**支持路径示例**：<br>1、fd类型播放：fd://xxx<br>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png)<br>2、http网络播放路径：开发中<br>3、hls网络播放路径：开发中<br>**注意事项**：<br>媒体素材需至少赋予读权限后，才可正常播放 |
 | loop        | boolean                   | 是   | 是   | 音频循环播放属性，设置为'true'表示循环播放。                 |
 | currentTime | number                    | 是   | 否   | 音频的当前播放位置。                                         |
 | duration    | number                    | 是   | 否   | 音频时长。                                                   |
@@ -714,7 +714,7 @@ audioPlayer.setVolume(3);  //设置volume为无效值，触发'error'事件
 
 | 名称        | 类型                               | 可读 | 可写 | 说明                                                         |
 | ----------- | ---------------------------------- | ---- | ---- | ------------------------------------------------------------ |
-| url         | string                             | 是   | 是   | 视频媒体URL，支持当前主流的视频格式(mp4、mpeg-ts、webm、mkv)。<br>**支持路径示例**：<br>1. fd类型播放：fd:///xxx<br>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png)<br>**注意事项**：<br>媒体素材需至少赋予读权限后，才可正常播放 |
+| url         | string                             | 是   | 是   | 视频媒体URL，支持当前主流的视频格式(mp4、mpeg-ts、webm、mkv)。<br>**支持路径示例**：<br>1. fd类型播放：fd://xxx<br>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png)<br>**注意事项**：<br>媒体素材需至少赋予读权限后，才可正常播放 |
 | loop        | boolean                            | 是   | 是   | 视频循环播放属性，设置为'true'表示循环播放。                 |
 | currentTime | number                             | 是   | 否   | 视频的当前播放位置。                                         |
 | duration    | number                             | 是   | 否   | 视频时长，返回-1表示直播模式                                 |
@@ -1750,7 +1750,7 @@ audioRecorder.prepare();  												// prepare不设置参数，触发'error'
 | numberOfChannels      | number                                  | 否   | 音频采集声道数，默认值为2。                                  |
 | format                | [AudioOutputFormat](#audiooutputformat) | 否   | 音量输出封装格式，默认设置为MPEG_4。                         |
 | location<sup>8+</sup> | [Location](#location8)                  | 否   | 音频采集的地理位置。                                         |
-| uri                   | string                                  | 是   | 视频输出URI：file://1&nbsp;(fd&nbsp;number)<br/>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png) <br/>文件需要由调用者创建，并赋予适当的权限。 |
+| uri                   | string                                  | 是   | 视频输出URI：file://xx&nbsp;(fd&nbsp;number)<br/>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png) <br/>文件需要由调用者创建，并赋予适当的权限。 |
 
 
 ## AudioEncoder
@@ -2340,7 +2340,7 @@ videoRecorder.on('error', (error) => {      							// 设置'error'事件回调
 | profile         | [VideoRecorderProfile](#videorecorderprofile<sup>8+</sup>) | 是   | 视频录制的profile。                                          |
 | orientationHint | number                                                     | 否   | 录制视频的旋转角度。                                         |
 | location        | [Location](#location8)                                     | 否   | 录制视频的地理位置。                                         |
-| url             | string                                                     | 是   | 视频输出URL：file://1&nbsp;(fd&nbsp;number)<br/>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png) <br/>文件需要由调用者创建，并赋予适当的权限。 |
+| url             | string                                                     | 是   | 视频输出URL：file://xx&nbsp;(fd&nbsp;number)<br/>![zh-cn_image_0000001164217678](figures/zh-cn_image_url.png) <br/>文件需要由调用者创建，并赋予适当的权限。 |
 
 ## AudioSourceType<sup>8+</sup>