Skip to content

D
Docs

OpenHarmony / Docs
大约 1 年 前同步成功

通知 159
Star 292
Fork 28
D
Docs

体验新版 GitCode，发现更多精彩内容 >>

提交 290da771 编写于 作者: W wusongqing
浏览文件
操作

updated docs 

Signed-off-by: Nwusongqing <wusongqing@huawei.com>
上级 1797374e
隐藏空白更改
内联 并排
Showing with 73 addition and 146 deletion
en/application-dev/reference/apis/js-apis-media.md
浏览文件 @ 290da771
...@@ -88,21 +88,16 @@ Creates a **VideoPlayer** instance in asynchronous mode. This API uses a promise ...@@ -88,21 +88,16 @@ Creates a **VideoPlayer** instance in asynchronous mode. This API uses a promise
```js ```js
let videoPlayer let videoPlayer
function failureCallback(error) { media.createVideoPlayer().then((video) => {
console.info(`video failureCallback, error:${error.message}`); if (typeof(video) != 'undefined') {
}
function catchCallback(error) {
console.info(`video catchCallback, error:${error.message}`);
}
await media.createVideoPlayer.then((video) => {
if (typeof(video) != 'undefined') {
videoPlayer = video; videoPlayer = video;
console.info('video createVideoPlayer success'); console.info('video createVideoPlayer success');
} else { } else {
console.info('video createVideoPlayer fail'); console.info('video createVideoPlayer fail');
} }
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`video catchCallback, error:${error.message}`);
});
``` ```
## media.createAudioRecorder ## media.createAudioRecorder
...@@ -173,21 +168,16 @@ Creates a **VideoRecorder** instance in asynchronous mode. This API uses a promi ...@@ -173,21 +168,16 @@ Creates a **VideoRecorder** instance in asynchronous mode. This API uses a promi
```js ```js
let videoRecorder let videoRecorder
function failureCallback(error) { media.createVideoRecorder().then((video) => {
console.info(`video failureCallback, error:${error.message}`);
}
function catchCallback(error) {
console.info(`video catchCallback, error:${error.message}`);
}
await media.createVideoRecorder.then((video) => {
if (typeof(video) != 'undefined') { if (typeof(video) != 'undefined') {
videoRecorder = video; videoRecorder = video;
console.info('video createVideoRecorder success'); console.info('video createVideoRecorder success');
} else { } else {
console.info('video createVideoRecorder fail'); console.info('video createVideoRecorder fail');
} }
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`video catchCallback, error:${error.message}`);
});
``` ```
...@@ -482,20 +472,17 @@ function printfDescription(obj) { ...@@ -482,20 +472,17 @@ function printfDescription(obj) {
console.info('audio value is ' + property); console.info('audio value is ' + property);
} }
} }
function failureCallback(error) {
console.info(`audio failureCallback, error:${error.message}`);
}
function catchCallback(error) {
console.info(`audio catchCallback, error:${error.message}`);
}
await audioPlayer.getTrackDescription.then((arrlist) => { audioPlayer.getTrackDescription().then((arrlist) => {
if (typeof (arrlist) != 'undefined') { if (typeof (arrlist) != 'undefined') {
arrayDescription = arrlist; arrayDescription = arrlist;
} else { } else {
console.log('audio getTrackDescription fail'); console.log('audio getTrackDescription fail');
} }
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`audio catchCallback, error:${error.message}`);
});
for (let i = 0; i < arrayDescription.length; i++) { for (let i = 0; i < arrayDescription.length; i++) {
printfDescription(arrayDescription[i]); printfDescription(arrayDescription[i]);
} }
...@@ -586,12 +573,12 @@ audioPlayer.on('error', (error) => { // Set the 'error' event callback ...@@ -586,12 +573,12 @@ audioPlayer.on('error', (error) => { // Set the 'error' event callback
// Set the FD (local playback) of the video file selected by the user. // Set the FD (local playback) of the video file selected by the user.
let fdPath = 'fd://' let fdPath = 'fd://'
let path = 'data/accounts/account_0/appdata/ohos.xxx.xxx.xxx/01.mp3'; let path = 'data/accounts/account_0/appdata/ohos.xxx.xxx.xxx/01.mp3';
await fileIO.open(path).then(fdNumber) => { fileIO.open(path).then(fdNumber) => {
fdPath = fdPath + '' + fdNumber; fdPath = fdPath + '' + fdNumber;
console.info('open fd sucess fd is' + fdPath); console.info('open fd sucess fd is' + fdPath);
}, (err) => { }, (err) => {
console.info('open fd failed err is' + err); console.info('open fd failed err is' + err);
}),catch((err) => { }).catch((err) => {
console.info('open fd failed err is' + err); console.info('open fd failed err is' + err);
}); });
audioPlayer.src = fdPath; // Set the src attribute and trigger the 'dataLoad' event callback. audioPlayer.src = fdPath; // Set the src attribute and trigger the 'dataLoad' event callback.
...@@ -735,15 +722,11 @@ Sets **SurfaceId**. This API uses a promise to return the result. ...@@ -735,15 +722,11 @@ Sets **SurfaceId**. This API uses a promise to return the result.
**Example** **Example**
```js ```js
function failureCallback(error) { videoPlayer.setDisplaySurface(surfaceId).then(() => {
console.info(`video failureCallback, error:${error.message}`);
}
function catchCallback(error) {
console.info(`video catchCallback, error:${error.message}`);
}
await videoPlayer.setDisplaySurface(surfaceId).then(() => {
console.info('setDisplaySurface success'); console.info('setDisplaySurface success');
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`video catchCallback, error:${error.message}`);
});
``` ```
### prepare<sup>8+</sup> ### prepare<sup>8+</sup>
...@@ -789,15 +772,11 @@ Prepares for video playback. This API uses a promise to return the result. ...@@ -789,15 +772,11 @@ Prepares for video playback. This API uses a promise to return the result.
**Example** **Example**
```js ```js
function failureCallback(error) { videoPlayer.prepare().then(() => {
console.info(`video failureCallback, error:${error.message}`);
}
function catchCallback(error) {
console.info(`video catchCallback, error:${error.message}`);
}
await videoPlayer.prepare().then(() => {
console.info('prepare success'); console.info('prepare success');
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`video catchCallback, error:${error.message}`);
});
``` ```
### play<sup>8+</sup> ### play<sup>8+</sup>
...@@ -843,15 +822,11 @@ Starts to play video resources. This API uses a promise to return the result. ...@@ -843,15 +822,11 @@ Starts to play video resources. This API uses a promise to return the result.
**Example** **Example**
```js ```js
function failureCallback(error) { videoPlayer.play().then(() => {
console.info(`video failureCallback, error:${error.message}`);
}
function catchCallback(error) {
console.info(`video catchCallback, error:${error.message}`);
}
await videoPlayer.play().then(() => {
console.info('play success'); console.info('play success');
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`video catchCallback, error:${error.message}`);
});
``` ```
### pause<sup>8+</sup> ### pause<sup>8+</sup>
...@@ -897,15 +872,11 @@ Pauses video playback. This API uses a promise to return the result. ...@@ -897,15 +872,11 @@ Pauses video playback. This API uses a promise to return the result.
**Example** **Example**
```js ```js
function failureCallback(error) { videoPlayer.pause().then(() => {
console.info(`video failureCallback, error:${error.message}`);
}
function catchCallback(error) {
console.info(`video catchCallback, error:${error.message}`);
}
await videoPlayer.pause().then(() => {
console.info('pause success'); console.info('pause success');
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`video catchCallback, error:${error.message}`);
});
``` ```
### stop<sup>8+</sup> ### stop<sup>8+</sup>
...@@ -951,15 +922,11 @@ Stops video playback. This API uses a promise to return the result. ...@@ -951,15 +922,11 @@ Stops video playback. This API uses a promise to return the result.
**Example** **Example**
```js ```js
function failureCallback(error) { videoPlayer.stop().then(() => {
console.info(`video failureCallback, error:${error.message}`);
}
function catchCallback(error) {
console.info(`video catchCallback, error:${error.message}`);
}
await videoPlayer.stop().then(() => {
console.info('stop success'); console.info('stop success');
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`video catchCallback, error:${error.message}`);
});
``` ```
### reset<sup>8+</sup> ### reset<sup>8+</sup>
...@@ -1005,15 +972,11 @@ Switches the video resource to be played. This API uses a promise to return the ...@@ -1005,15 +972,11 @@ Switches the video resource to be played. This API uses a promise to return the
**Example** **Example**
```js ```js
function failureCallback(error) { videoPlayer.reset().then(() => {
console.info(`video failureCallback, error:${error.message}`);
}
function catchCallback(error) {
console.info(`video catchCallback, error:${error.message}`);
}
await videoPlayer.reset().then(() => {
console.info('reset success'); console.info('reset success');
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`video catchCallback, error:${error.message}`);
});
``` ```
### seek<sup>8+</sup> ### seek<sup>8+</sup>
...@@ -1095,19 +1058,17 @@ Seeks to the specified playback position. If **mode** is not specified, the next ...@@ -1095,19 +1058,17 @@ Seeks to the specified playback position. If **mode** is not specified, the next
**Example** **Example**
```js ```js
function failureCallback(error) { videoPlayer.seek(seekTime).then((seekDoneTime) => { // seekDoneTime indicates the position after the seek operation is complete.
console.info(`video failureCallback, error:${error.message}`);
}
function catchCallback(error) {
console.info(`video catchCallback, error:${error.message}`);
}
await videoPlayer.seek(seekTime).then((seekDoneTime) => { // seekDoneTime indicates the position after the seek operation is complete.
console.info('seek success'); console.info('seek success');
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`video catchCallback, error:${error.message}`);
});
await videoPlayer.seek(seekTime, seekMode).then((seekDoneTime) => { videoPlayer.seek(seekTime, seekMode).then((seekDoneTime) => {
console.info('seek success'); console.info('seek success');
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`video catchCallback, error:${error.message}`);
});
``` ```
### setVolume<sup>8+</sup> ### setVolume<sup>8+</sup>
...@@ -1160,15 +1121,11 @@ Sets the volume. This API uses a promise to return the result. ...@@ -1160,15 +1121,11 @@ Sets the volume. This API uses a promise to return the result.
**Example** **Example**
```js ```js
function failureCallback(error) { videoPlayer.setVolume(vol).then() => {
console.info(`video failureCallback, error:${error.message}`);
}
function catchCallback(error) {
console.info(`video catchCallback, error:${error.message}`);
}
await videoPlayer.setVolume(vol).then() => {
console.info('setVolume success'); console.info('setVolume success');
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`video catchCallback, error:${error.message}`);
});
``` ```
### release<sup>8+</sup> ### release<sup>8+</sup>
...@@ -1214,15 +1171,11 @@ Releases the video playback resource. This API uses a promise to return the resu ...@@ -1214,15 +1171,11 @@ Releases the video playback resource. This API uses a promise to return the resu
**Example** **Example**
```js ```js
function failureCallback(error) { videoPlayer.release().then() => {
console.info(`video failureCallback, error:${error.message}`);
}
function catchCallback(error) {
console.info(`video catchCallback, error:${error.message}`);
}
await videoPlayer.release().then() => {
console.info('release success'); console.info('release success');
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`video catchCallback, error:${error.message}`);
});
``` ```
### getTrackDescription<sup>8+</sup> ### getTrackDescription<sup>8+</sup>
...@@ -1285,21 +1238,17 @@ function printfDescription(obj) { ...@@ -1285,21 +1238,17 @@ function printfDescription(obj) {
console.info('video value is ' + property); console.info('video value is ' + property);
} }
} }
function failureCallback(error) {
console.info(`video failureCallback, error:${error.message}`);
}
function catchCallback(error) {
console.info(`video catchCallback, error:${error.message}`);
}
let arrayDescription; let arrayDescription;
await videoPlayer.getTrackDescription().then((arrlist) => { videoPlayer.getTrackDescription().then((arrlist) => {
if (typeof (arrlist) != 'undefined') { if (typeof (arrlist) != 'undefined') {
arrayDescription = arrlist; arrayDescription = arrlist;
} else { } else {
console.log('video getTrackDescription fail'); console.log('video getTrackDescription fail');
} }
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`video catchCallback, error:${error.message}`);
});
for (let i = 0; i < arrayDescription.length; i++) { for (let i = 0; i < arrayDescription.length; i++) {
printfDescription(arrayDescription[i]); printfDescription(arrayDescription[i]);
} }
...@@ -1355,15 +1304,11 @@ Sets the video playback speed. This API uses a promise to return the result. ...@@ -1355,15 +1304,11 @@ Sets the video playback speed. This API uses a promise to return the result.
**Example** **Example**
```js ```js
function failureCallback(error) { videoPlayer.setSpeed(speed).then() => {
console.info(`video failureCallback, error:${error.message}`);
}
function catchCallback(error) {
console.info(`video catchCallback, error:${error.message}`);
}
await videoPlayer.setSpeed(speed).then() => {
console.info('setSpeed success'); console.info('setSpeed success');
}, failureCallback).catch(catchCallback); }).catch((error) => {
console.info(`video catchCallback, error:${error.message}`);
});
``` ```
### on('playbackCompleted')<sup>8+</sup> ### on('playbackCompleted')<sup>8+</sup>
...@@ -1973,23 +1918,19 @@ let videoConfig = { ...@@ -1973,23 +1918,19 @@ let videoConfig = {
// promise // promise
let videoRecorder = null; let videoRecorder = null;
await media.createVideoRecorder().then((recorder) => { media.createVideoRecorder().then((recorder) => {
if (typeof (recorder) != 'undefined') { if (typeof (recorder) != 'undefined') {
videoRecorder = recorder; videoRecorder = recorder;
console.info('createVideoRecorder success'); console.info('createVideoRecorder success');
} else { } else {
console.info('createVideoRecorder failed'); console.info('createVideoRecorder failed');
} }
}, (err) => {
console.info('error hanppend message is ' + err.message);
}).catch((err) => { }).catch((err) => {
console.info('catch err error message is ' + err.message); console.info('catch err error message is ' + err.message);
}); });
await videoRecorder.prepare(videoConfig).then(() => { videoRecorder.prepare(videoConfig).then(() => {
console.info('prepare success'); console.info('prepare success');
}, (err) => {
console.info('prepare failed and error is ' + err.message);
}).catch((err) => { }).catch((err) => {
console.info('prepare failed and catch error is ' + err.message); console.info('prepare failed and catch error is ' + err.message);
}); });
...@@ -2051,11 +1992,9 @@ This API can be called only after [prepare()](#videorecorder_prepare1) is called ...@@ -2051,11 +1992,9 @@ This API can be called only after [prepare()](#videorecorder_prepare1) is called
```js ```js
// promise // promise
let surfaceID = null; // Surface ID passed to the external system. let surfaceID = null; // Surface ID passed to the external system.
await videoRecorder.getInputSurface().then((surfaceId) => { videoRecorder.getInputSurface().then((surfaceId) => {
console.info('getInputSurface success'); console.info('getInputSurface success');
surfaceID = surfaceId; surfaceID = surfaceId;
}, (err) => {
console.info('getInputSurface failed and error is ' + err.message);
}).catch((err) => { }).catch((err) => {
console.info('getInputSurface failed and catch error is ' + err.message); console.info('getInputSurface failed and catch error is ' + err.message);
}); });
...@@ -2110,10 +2049,8 @@ This API can be called only after [prepare()](#videorecorder_prepare1) and [getI ...@@ -2110,10 +2049,8 @@ This API can be called only after [prepare()](#videorecorder_prepare1) and [getI
```js ```js
// promise // promise
await videoRecorder.start().then(() => { videoRecorder.start().then(() => {
console.info('start videorecorder success'); console.info('start videorecorder success');
}, (err) => {
console.info('start videorecorder failed and error is ' + err.message);
}).catch((err) => { }).catch((err) => {
console.info('start videorecorder failed and catch error is ' + err.message); console.info('start videorecorder failed and catch error is ' + err.message);
}); });
...@@ -2168,10 +2105,8 @@ This API can be called only after [start()](#videorecorder_start1) is called. Yo ...@@ -2168,10 +2105,8 @@ This API can be called only after [start()](#videorecorder_start1) is called. Yo
```js ```js
// promise // promise
await videoRecorder.pause().then(() => { videoRecorder.pause().then(() => {
console.info('pause videorecorder success'); console.info('pause videorecorder success');
}, (err) => {
console.info('pause videorecorder failed and error is ' + err.message);
}).catch((err) => { }).catch((err) => {
console.info('pause videorecorder failed and catch error is ' + err.message); console.info('pause videorecorder failed and catch error is ' + err.message);
}); });
...@@ -2222,10 +2157,8 @@ Resumes video recording in asynchronous mode. This API uses a promise to return ...@@ -2222,10 +2157,8 @@ Resumes video recording in asynchronous mode. This API uses a promise to return
```js ```js
// promise // promise
await videoRecorder.resume().then(() => { videoRecorder.resume().then(() => {
console.info('resume videorecorder success'); console.info('resume videorecorder success');
}, (err) => {
console.info('resume videorecorder failed and error is ' + err.message);
}).catch((err) => { }).catch((err) => {
console.info('resume videorecorder failed and catch error is ' + err.message); console.info('resume videorecorder failed and catch error is ' + err.message);
}); });
...@@ -2280,10 +2213,8 @@ To start another recording, you must call [prepare()](#videorecorder_prepare1) a ...@@ -2280,10 +2213,8 @@ To start another recording, you must call [prepare()](#videorecorder_prepare1) a
```js ```js
// promise // promise
await videoRecorder.stop().then(() => { videoRecorder.stop().then(() => {
console.info('stop videorecorder success'); console.info('stop videorecorder success');
}, (err) => {
console.info('stop videorecorder failed and error is ' + err.message);
}).catch((err) => { }).catch((err) => {
console.info('stop videorecorder failed and catch error is ' + err.message); console.info('stop videorecorder failed and catch error is ' + err.message);
}); });
...@@ -2334,10 +2265,8 @@ Releases the video recording resource in asynchronous mode. This API uses a prom ...@@ -2334,10 +2265,8 @@ Releases the video recording resource in asynchronous mode. This API uses a prom
```js ```js
// promise // promise
await videoRecorder.release().then(() => { videoRecorder.release().then(() => {
console.info('release videorecorder success'); console.info('release videorecorder success');
}, (err) => {
console.info('release videorecorder failed and error is ' + err.message);
}).catch((err) => { }).catch((err) => {
console.info('release videorecorder failed and catch error is ' + err.message); console.info('release videorecorder failed and catch error is ' + err.message);
}); });
...@@ -2392,10 +2321,8 @@ To start another recording, you must call [prepare()](#videorecorder_prepare1) a ...@@ -2392,10 +2321,8 @@ To start another recording, you must call [prepare()](#videorecorder_prepare1) a
```js ```js
// promise // promise
await videoRecorder.reset().then(() => { videoRecorder.reset().then(() => {
console.info('reset videorecorder success'); console.info('reset videorecorder success');
}, (err) => {
console.info('reset videorecorder failed and error is ' + err.message);
}).catch((err) => { }).catch((err) => {
console.info('reset videorecorder failed and catch error is ' + err.message); console.info('reset videorecorder failed and catch error is ' + err.message);
}); });
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或