Skip to content

D
Docs

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

通知 161
Star 293
Fork 28
D
Docs
“044fb0fb5a4539f3c040ac8a95c1a69bb27c3674”上不存在“python/paddle/git@gitcode.net:s920243400/PaddleDetection.git”
提交 8b66fd96 编写于 作者: Z zhangkai269
浏览文件
操作

js-api-avsession arkts整改 

Signed-off-by: Nzhangkai269 <zhangkai269@huawei.com>
上级 caa07250
隐藏空白更改
内联 并排
Showing with 1455 addition and 1088 deletion
zh-cn/application-dev/reference/apis/js-apis-avsession.md
浏览文件 @ 8b66fd96
...@@ -14,7 +14,7 @@ ...@@ -14,7 +14,7 @@
## 导入模块 ## 导入模块
```js ```ts
import avSession from '@ohos.multimedia.avsession'; import avSession from '@ohos.multimedia.avsession';
``` ```
...@@ -50,20 +50,20 @@ createAVSession(context: Context, tag: string, type: AVSessionType): Promise\<AV ...@@ -50,20 +50,20 @@ createAVSession(context: Context, tag: string, type: AVSessionType): Promise\<AV
**示例：** **示例：**
```js ```ts
import featureAbility from '@ohos.ability.featureAbility'; import { BusinessError } from '@ohos.base';
let currentAVSession; let currentAVSession: avSession.AVSession;
let tag = "createNewSession"; let tag = "createNewSession";
let context = featureAbility.getContext(); let context: Context = this.context;
let sessionId; //供后续函数入参使用 let sessionId: string; //供后续函数入参使用
avSession.createAVSession(context, tag, "audio").then((data) => { avSession.createAVSession(context, tag, "audio").then((data: avSession.AVSession) => {
currentAVSession = data; currentAVSession = data;
sessionId = currentAVSession.sessionId; sessionId = currentAVSession.sessionId;
console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`); console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -94,22 +94,22 @@ createAVSession(context: Context, tag: string, type: AVSessionType, callback: As ...@@ -94,22 +94,22 @@ createAVSession(context: Context, tag: string, type: AVSessionType, callback: As
**示例：** **示例：**
```js ```ts
import featureAbility from '@ohos.ability.featureAbility'; import { BusinessError } from '@ohos.base';
let currentAVSession; let currentAVSession: avSession.AVSession;
let tag = "createNewSession"; let tag = "createNewSession";
let context = featureAbility.getContext(); let context: Context = this.context;
let sessionId; //供后续函数入参使用 let sessionId: string; //供后续函数入参使用
avSession.createAVSession(context, tag, "audio", function (err, data) { avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) { if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
currentAVSession = data; currentAVSession = data;
sessionId = currentAVSession.sessionId; sessionId = currentAVSession.sessionId;
console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`); console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`);
} }
}); });
``` ```
...@@ -140,16 +140,18 @@ getAllSessionDescriptors(): Promise\<Array\<Readonly\<AVSessionDescriptor>>> ...@@ -140,16 +140,18 @@ getAllSessionDescriptors(): Promise\<Array\<Readonly\<AVSessionDescriptor>>>
**示例：** **示例：**
```js ```ts
avSession.getAllSessionDescriptors().then((descriptors) => { import { BusinessError } from '@ohos.base';
console.info(`getAllSessionDescriptors : SUCCESS : descriptors.length : ${descriptors.length}`);
if(descriptors.length > 0 ){ avSession.getAllSessionDescriptors().then((descriptors: avSession.AVSessionDescriptor) => {
console.info(`getAllSessionDescriptors : SUCCESS : descriptors[0].isActive : ${descriptors[0].isActive}`); console.info(`getAllSessionDescriptors : SUCCESS : descriptors.length : ${descriptors.length}`);
console.info(`GetAllSessionDescriptors : SUCCESS : descriptors[0].type : ${descriptors[0].type}`); if(descriptors.length > 0 ){
console.info(`GetAllSessionDescriptors : SUCCESS : descriptors[0].sessionTag : ${descriptors[0].sessionTag}`); console.info(`getAllSessionDescriptors : SUCCESS : descriptors[0].isActive : ${descriptors[0].isActive}`);
} console.info(`GetAllSessionDescriptors : SUCCESS : descriptors[0].type : ${descriptors[0].type}`);
}).catch((err) => { console.info(`GetAllSessionDescriptors : SUCCESS : descriptors[0].sessionTag : ${descriptors[0].sessionTag}`);
console.error(`GetAllSessionDescriptors BusinessError: code: ${err.code}, message: ${err.message}`); }
}).catch((err: BusinessError) => {
console.error(`GetAllSessionDescriptors BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -181,18 +183,20 @@ getAllSessionDescriptors(callback: AsyncCallback\<Array\<Readonly\<AVSessionDesc ...@@ -181,18 +183,20 @@ getAllSessionDescriptors(callback: AsyncCallback\<Array\<Readonly\<AVSessionDesc
**示例：** **示例：**
```js ```ts
avSession.getAllSessionDescriptors(function (err, descriptors) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`GetAllSessionDescriptors BusinessError: code: ${err.code}, message: ${err.message}`); avSession.getAllSessionDescriptors((err: BusinessError, descriptors: avSession.AVSessionDescriptor) => {
} else { if (err) {
console.info(`GetAllSessionDescriptors : SUCCESS : descriptors.length : ${descriptors.length}`); console.error(`GetAllSessionDescriptors BusinessError: code: ${err.code}, message: ${err.message}`);
if(descriptors.length > 0 ){ } else {
console.info(`getAllSessionDescriptors : SUCCESS : descriptors[0].isActive : ${descriptors[0].isActive}`); console.info(`GetAllSessionDescriptors : SUCCESS : descriptors.length : ${descriptors.length}`);
console.info(`getAllSessionDescriptors : SUCCESS : descriptors[0].type : ${descriptors[0].type}`); if(descriptors.length > 0 ){
console.info(`getAllSessionDescriptors : SUCCESS : descriptors[0].sessionTag : ${descriptors[0].sessionTag}`); console.info(`getAllSessionDescriptors : SUCCESS : descriptors[0].isActive : ${descriptors[0].isActive}`);
} console.info(`getAllSessionDescriptors : SUCCESS : descriptors[0].type : ${descriptors[0].type}`);
console.info(`getAllSessionDescriptors : SUCCESS : descriptors[0].sessionTag : ${descriptors[0].sessionTag}`);
} }
}
}); });
``` ```
...@@ -230,18 +234,20 @@ getHistoricalSessionDescriptors(maxSize?: number): Promise\<Array\<Readonly\<AVS ...@@ -230,18 +234,20 @@ getHistoricalSessionDescriptors(maxSize?: number): Promise\<Array\<Readonly\<AVS
**示例：** **示例：**
```js ```ts
avSession.getHistoricalSessionDescriptors().then((descriptors) => { import { BusinessError } from '@ohos.base';
console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors.length : ${descriptors.length}`);
if(descriptors.length > 0 ){ avSession.getHistoricalSessionDescriptors().then((descriptors: avSession.AVSessionDescriptor) => {
console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].isActive : ${descriptors[0].isActive}`); console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors.length : ${descriptors.length}`);
console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].type : ${descriptors[0].type}`); if(descriptors.length > 0 ){
console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].sessionTag : ${descriptors[0].sessionTag}`); console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].isActive : ${descriptors[0].isActive}`);
console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].sessionId : ${descriptors[0].sessionId}`); console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].type : ${descriptors[0].type}`);
console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].elementName.bundleName : ${descriptors[0].elementName.bundleName}`); console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].sessionTag : ${descriptors[0].sessionTag}`);
} console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].sessionId : ${descriptors[0].sessionId}`);
}).catch((err) => { console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].elementName.bundleName : ${descriptors[0].elementName.bundleName}`);
console.error(`getHistoricalSessionDescriptors BusinessError: code: ${err.code}, message: ${err.message}`); }
}).catch((err: BusinessError) => {
console.error(`getHistoricalSessionDescriptors BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -274,20 +280,22 @@ getHistoricalSessionDescriptors(maxSize: number, callback: AsyncCallback\<Array\ ...@@ -274,20 +280,22 @@ getHistoricalSessionDescriptors(maxSize: number, callback: AsyncCallback\<Array\
**示例：** **示例：**
```js ```ts
avSession.getHistoricalSessionDescriptors(1, function (err, descriptors) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`getHistoricalSessionDescriptors BusinessError: code: ${err.code}, message: ${err.message}`); avSession.getHistoricalSessionDescriptors(1, (err: BusinessError, descriptors: avSession.AVSessionDescriptor) => {
} else { if (err) {
console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors.length : ${descriptors.length}`); console.error(`getHistoricalSessionDescriptors BusinessError: code: ${err.code}, message: ${err.message}`);
if(descriptors.length > 0 ){ } else {
console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].isActive : ${descriptors[0].isActive}`); console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors.length : ${descriptors.length}`);
console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].type : ${descriptors[0].type}`); if(descriptors.length > 0 ){
console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].sessionTag : ${descriptors[0].sessionTag}`); console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].isActive : ${descriptors[0].isActive}`);
console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].sessionId : ${descriptors[0].sessionId}`); console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].type : ${descriptors[0].type}`);
console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].elementName.bundleName : ${descriptors[0].elementName.bundleName}`); console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].sessionTag : ${descriptors[0].sessionTag}`);
} console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].sessionId : ${descriptors[0].sessionId}`);
console.info(`getHistoricalSessionDescriptors : SUCCESS : descriptors[0].elementName.bundleName : ${descriptors[0].elementName.bundleName}`);
} }
}
}); });
``` ```
...@@ -326,30 +334,30 @@ createController(sessionId: string): Promise\<AVSessionController> ...@@ -326,30 +334,30 @@ createController(sessionId: string): Promise\<AVSessionController>
**示例：** **示例：**
```js ```ts
import featureAbility from '@ohos.ability.featureAbility'; import { BusinessError } from '@ohos.base';
let currentAVSession; let currentAVSession: avSession.AVSession;
let tag = "createNewSession"; let tag = "createNewSession";
let context = featureAbility.getContext(); let context: Context = this.context;
let sessionId; //供后续函数入参使用 let sessionId: string; //供后续函数入参使用
avSession.createAVSession(context, tag, "audio", function (err, data) { avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) { if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
currentAVSession = data; currentAVSession = data;
sessionId = currentAVSession.sessionId; sessionId = currentAVSession.sessionId;
console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`); console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`);
} }
}); });
let currentAVcontroller; let currentAVcontroller: avSession.AVSessionController;
avSession.createController(sessionId).then((avcontroller) => { avSession.createController(sessionId).then((avcontroller: avSession.AVSessionController) => {
currentAVcontroller = avcontroller; currentAVcontroller = avcontroller;
console.info('CreateController : SUCCESS '); console.info('CreateController : SUCCESS ');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`CreateController BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`CreateController BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -382,32 +390,32 @@ createController(sessionId: string, callback: AsyncCallback\<AVSessionController ...@@ -382,32 +390,32 @@ createController(sessionId: string, callback: AsyncCallback\<AVSessionController
**示例：** **示例：**
```js ```ts
import featureAbility from '@ohos.ability.featureAbility'; import { BusinessError } from '@ohos.base';
let currentAVSession; let currentAVSession: avSession.AVSession;
let tag = "createNewSession"; let tag = "createNewSession";
let context = featureAbility.getContext(); let context: Context = this.context;
let sessionId; //供后续函数入参使用 let sessionId: string; //供后续函数入参使用
avSession.createAVSession(context, tag, "audio", function (err, data) { avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) { if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
currentAVSession = data; currentAVSession = data;
sessionId = currentAVSession.sessionId; sessionId = currentAVSession.sessionId;
console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`); console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`);
} }
}); });
let currentAVcontroller; let currentAVcontroller: avSession.AVSessionController;
avSession.createController(sessionId, function (err, avcontroller) { avSession.createController(sessionId, (err: BusinessError, avcontroller: avSession.AVSessionController) => {
if (err) { if (err) {
console.error(`CreateController BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`CreateController BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
currentAVcontroller = avcontroller; currentAVcontroller = avcontroller;
console.info('CreateController : SUCCESS '); console.info('CreateController : SUCCESS ');
} }
}); });
``` ```
...@@ -449,23 +457,24 @@ castAudio(session: SessionToken | 'all', audioDevices: Array<audio.AudioDeviceDe ...@@ -449,23 +457,24 @@ castAudio(session: SessionToken | 'all', audioDevices: Array<audio.AudioDeviceDe
**示例：** **示例：**
```js ```ts
import audio from '@ohos.multimedia.audio'; import audio from '@ohos.multimedia.audio';
import { BusinessError } from '@ohos.base';
let audioManager = audio.getAudioManager(); let audioManager = audio.getAudioManager();
let audioRoutingManager = audioManager.getRoutingManager(); let audioRoutingManager = audioManager.getRoutingManager();
let audioDevices; let audioDevices: audio.AudioDeviceDescriptors;
await audioRoutingManager.getDevices(audio.DeviceFlag.OUTPUT_DEVICES_FLAG).then((data) => { audioRoutingManager.getDevices(audio.DeviceFlag.OUTPUT_DEVICES_FLAG).then((data) => {
audioDevices = data; audioDevices = data;
console.info(`Promise returned to indicate that the device list is obtained.`); console.info(`Promise returned to indicate that the device list is obtained.`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`GetDevices BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`GetDevices BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
avSession.castAudio('all', audioDevices).then(() => { avSession.castAudio('all', audioDevices).then(() => {
console.info(`CreateController : SUCCESS`); console.info(`CreateController : SUCCESS`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`CreateController BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`CreateController BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -502,25 +511,26 @@ castAudio(session: SessionToken | 'all', audioDevices: Array<audio.AudioDeviceDe ...@@ -502,25 +511,26 @@ castAudio(session: SessionToken | 'all', audioDevices: Array<audio.AudioDeviceDe
**示例：** **示例：**
```js ```ts
import audio from '@ohos.multimedia.audio'; import audio from '@ohos.multimedia.audio';
import { BusinessError } from '@ohos.base';
let audioManager = audio.getAudioManager(); let audioManager = audio.getAudioManager();
let audioRoutingManager = audioManager.getRoutingManager(); let audioRoutingManager = audioManager.getRoutingManager();
let audioDevices; let audioDevices: audio.AudioDeviceDescriptors;
await audioRoutingManager.getDevices(audio.DeviceFlag.OUTPUT_DEVICES_FLAG).then((data) => { audioRoutingManager.getDevices(audio.DeviceFlag.OUTPUT_DEVICES_FLAG).then((data) => {
audioDevices = data; audioDevices = data;
console.info(`Promise returned to indicate that the device list is obtained.`); console.info(`Promise returned to indicate that the device list is obtained.`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`GetDevices BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`GetDevices BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
avSession.castAudio('all', audioDevices, function (err) { avSession.castAudio('all', audioDevices, (err: BusinessError) => {
if (err) { if (err) {
console.error(`CastAudio BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`CastAudio BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
console.info(`CastAudio : SUCCESS `); console.info(`CastAudio : SUCCESS `);
} }
}); });
``` ```
...@@ -568,11 +578,11 @@ on(type: 'sessionCreate', callback: (session: AVSessionDescriptor) => void): voi ...@@ -568,11 +578,11 @@ on(type: 'sessionCreate', callback: (session: AVSessionDescriptor) => void): voi
**示例：** **示例：**
```js ```ts
avSession.on('sessionCreate', (descriptor) => { avSession.on('sessionCreate', (descriptor: avSession.AVSessionDescriptor) => {
console.info(`on sessionCreate : isActive : ${descriptor.isActive}`); console.info(`on sessionCreate : isActive : ${descriptor.isActive}`);
console.info(`on sessionCreate : type : ${descriptor.type}`); console.info(`on sessionCreate : type : ${descriptor.type}`);
console.info(`on sessionCreate : sessionTag : ${descriptor.sessionTag}`); console.info(`on sessionCreate : sessionTag : ${descriptor.sessionTag}`);
}); });
``` ```
...@@ -605,11 +615,11 @@ on(type: 'sessionDestroy', callback: (session: AVSessionDescriptor) => void): vo ...@@ -605,11 +615,11 @@ on(type: 'sessionDestroy', callback: (session: AVSessionDescriptor) => void): vo
**示例：** **示例：**
```js ```ts
avSession.on('sessionDestroy', (descriptor) => { avSession.on('sessionDestroy', (descriptor: avSession.AVSessionDescriptor) => {
console.info(`on sessionDestroy : isActive : ${descriptor.isActive}`); console.info(`on sessionDestroy : isActive : ${descriptor.isActive}`);
console.info(`on sessionDestroy : type : ${descriptor.type}`); console.info(`on sessionDestroy : type : ${descriptor.type}`);
console.info(`on sessionDestroy : sessionTag : ${descriptor.sessionTag}`); console.info(`on sessionDestroy : sessionTag : ${descriptor.sessionTag}`);
}); });
``` ```
...@@ -641,11 +651,11 @@ on(type: 'topSessionChange', callback: (session: AVSessionDescriptor) => void): ...@@ -641,11 +651,11 @@ on(type: 'topSessionChange', callback: (session: AVSessionDescriptor) => void):
**示例：** **示例：**
```js ```ts
avSession.on('topSessionChange', (descriptor) => { avSession.on('topSessionChange', (descriptor: avSession.AVSessionDescriptor) => {
console.info(`on topSessionChange : isActive : ${descriptor.isActive}`); console.info(`on topSessionChange : isActive : ${descriptor.isActive}`);
console.info(`on topSessionChange : type : ${descriptor.type}`); console.info(`on topSessionChange : type : ${descriptor.type}`);
console.info(`on topSessionChange : sessionTag : ${descriptor.sessionTag}`); console.info(`on topSessionChange : sessionTag : ${descriptor.sessionTag}`);
}); });
``` ```
...@@ -677,7 +687,7 @@ off(type: 'sessionCreate', callback?: (session: AVSessionDescriptor) => void): v ...@@ -677,7 +687,7 @@ off(type: 'sessionCreate', callback?: (session: AVSessionDescriptor) => void): v
**示例：** **示例：**
```js ```ts
avSession.off('sessionCreate'); avSession.off('sessionCreate');
``` ```
...@@ -709,7 +719,7 @@ off(type: 'sessionDestroy', callback?: (session: AVSessionDescriptor) => void): ...@@ -709,7 +719,7 @@ off(type: 'sessionDestroy', callback?: (session: AVSessionDescriptor) => void):
**示例：** **示例：**
```js ```ts
avSession.off('sessionDestroy'); avSession.off('sessionDestroy');
``` ```
...@@ -741,7 +751,7 @@ off(type: 'topSessionChange', callback?: (session: AVSessionDescriptor) => void) ...@@ -741,7 +751,7 @@ off(type: 'topSessionChange', callback?: (session: AVSessionDescriptor) => void)
**示例：** **示例：**
```js ```ts
avSession.off('topSessionChange'); avSession.off('topSessionChange');
``` ```
...@@ -771,9 +781,9 @@ on(type: 'sessionServiceDie', callback: () => void): void ...@@ -771,9 +781,9 @@ on(type: 'sessionServiceDie', callback: () => void): void
**示例：** **示例：**
```js ```ts
avSession.on('sessionServiceDie', () => { avSession.on('sessionServiceDie', () => {
console.info(`on sessionServiceDie : session is Died `); console.info(`on sessionServiceDie : session is Died `);
}); });
``` ```
...@@ -803,7 +813,7 @@ off(type: 'sessionServiceDie', callback?: () => void): void ...@@ -803,7 +813,7 @@ off(type: 'sessionServiceDie', callback?: () => void): void
**示例：** **示例：**
```js ```ts
avSession.off('sessionServiceDie'); avSession.off('sessionServiceDie');
``` ```
...@@ -836,16 +846,19 @@ sendSystemAVKeyEvent(event: KeyEvent, callback: AsyncCallback\<void>): void ...@@ -836,16 +846,19 @@ sendSystemAVKeyEvent(event: KeyEvent, callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
let keyItem = {code:0x49, pressedTime:2, deviceId:0}; import keyEvent from '@ohos.multimodalInput.keyEvent';
let event = {id:1, deviceId:0, actionTime:1, screenId:1, windowId:1, action:2, key:keyItem, unicodeChar:0, keys:[keyItem], ctrlKey:false, altKey:false, shiftKey:false, logoKey:false, fnKey:false, capsLock:false, numLock:false, scrollLock:false}; import { BusinessError } from '@ohos.base';
avSession.sendSystemAVKeyEvent(event, function (err) { let keyItem: keyEvent.Key = {code:0x49, pressedTime:2, deviceId:0};
if (err) { let event: keyEvent.KeyEvent = {id:1, deviceId:0, actionTime:1, screenId:1, windowId:1, action:2, key:keyItem, unicodeChar:0, keys:[keyItem], ctrlKey:false, altKey:false, shiftKey:false, logoKey:false, fnKey:false, capsLock:false, numLock:false, scrollLock:false};
console.error(`SendSystemAVKeyEvent BusinessError: code: ${err.code}, message: ${err.message}`);
} else { avSession.sendSystemAVKeyEvent(event, (err: BusinessError) => {
console.info(`SendSystemAVKeyEvent : SUCCESS `); if (err) {
} console.error(`SendSystemAVKeyEvent BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
console.info(`SendSystemAVKeyEvent : SUCCESS `);
}
}); });
``` ```
...@@ -883,15 +896,17 @@ sendSystemAVKeyEvent(event: KeyEvent): Promise\<void> ...@@ -883,15 +896,17 @@ sendSystemAVKeyEvent(event: KeyEvent): Promise\<void>
**示例：** **示例：**
```js ```ts
import keyEvent from '@ohos.multimodalInput.keyEvent';
import { BusinessError } from '@ohos.base';
let keyItem = {code:0x49, pressedTime:2, deviceId:0}; let keyItem: keyEvent.Key = {code:0x49, pressedTime:2, deviceId:0};
let event = {id:1, deviceId:0, actionTime:1, screenId:1, windowId:1, action:2, key:keyItem, unicodeChar:0, keys:[keyItem], ctrlKey:false, altKey:false, shiftKey:false, logoKey:false, fnKey:false, capsLock:false, numLock:false, scrollLock:false}; let event: keyEvent.KeyEvent = {id:1, deviceId:0, actionTime:1, screenId:1, windowId:1, action:2, key:keyItem, unicodeChar:0, keys:[keyItem], ctrlKey:false, altKey:false, shiftKey:false, logoKey:false, fnKey:false, capsLock:false, numLock:false, scrollLock:false};
avSession.sendSystemAVKeyEvent(event).then(() => { avSession.sendSystemAVKeyEvent(event).then(() => {
console.info(`SendSystemAVKeyEvent Successfully`); console.info(`SendSystemAVKeyEvent Successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`SendSystemAVKeyEvent BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SendSystemAVKeyEvent BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -925,7 +940,9 @@ sendSystemControlCommand(command: AVControlCommand, callback: AsyncCallback\<voi ...@@ -925,7 +940,9 @@ sendSystemControlCommand(command: AVControlCommand, callback: AsyncCallback\<voi
**示例：** **示例：**
```js ```ts
import avSession from '@ohos.multimedia.avsession';
let cmd : avSession.AVControlCommandType = 'play'; let cmd : avSession.AVControlCommandType = 'play';
// let cmd : avSession.AVControlCommandType = 'pause'; // let cmd : avSession.AVControlCommandType = 'pause';
// let cmd : avSession.AVControlCommandType = 'stop'; // let cmd : avSession.AVControlCommandType = 'stop';
...@@ -933,7 +950,7 @@ let cmd : avSession.AVControlCommandType = 'play'; ...@@ -933,7 +950,7 @@ let cmd : avSession.AVControlCommandType = 'play';
// let cmd : avSession.AVControlCommandType = 'playPrevious'; // let cmd : avSession.AVControlCommandType = 'playPrevious';
// let cmd : avSession.AVControlCommandType = 'fastForward'; // let cmd : avSession.AVControlCommandType = 'fastForward';
// let cmd : avSession.AVControlCommandType = 'rewind'; // let cmd : avSession.AVControlCommandType = 'rewind';
let avcommand = {command:cmd}; let avcommand: avSession.AVControlCommand = {command:cmd};
// let cmd : avSession.AVControlCommandType = 'seek'; // let cmd : avSession.AVControlCommandType = 'seek';
// let avcommand = {command:cmd, parameter:10}; // let avcommand = {command:cmd, parameter:10};
// let cmd : avSession.AVControlCommandType = 'setSpeed'; // let cmd : avSession.AVControlCommandType = 'setSpeed';
...@@ -942,12 +959,12 @@ let avcommand = {command:cmd}; ...@@ -942,12 +959,12 @@ let avcommand = {command:cmd};
// let avcommand = {command:cmd, parameter:avSession.LoopMode.LOOP_MODE_SINGLE}; // let avcommand = {command:cmd, parameter:avSession.LoopMode.LOOP_MODE_SINGLE};
// let cmd : avSession.AVControlCommandType = 'toggleFavorite'; // let cmd : avSession.AVControlCommandType = 'toggleFavorite';
// let avcommand = {command:cmd, parameter:"false"}; // let avcommand = {command:cmd, parameter:"false"};
avSession.sendSystemControlCommand(avcommand, function (err) { avSession.sendSystemControlCommand(avcommand, (err) => {
if (err) { if (err) {
console.error(`SendSystemControlCommand BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SendSystemControlCommand BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
console.info(`sendSystemControlCommand successfully`); console.info(`sendSystemControlCommand successfully`);
} }
}); });
``` ```
...@@ -986,7 +1003,10 @@ sendSystemControlCommand(command: AVControlCommand): Promise\<void> ...@@ -986,7 +1003,10 @@ sendSystemControlCommand(command: AVControlCommand): Promise\<void>
**示例：** **示例：**
```js ```ts
import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
let cmd : avSession.AVControlCommandType = 'play'; let cmd : avSession.AVControlCommandType = 'play';
// let cmd : avSession.AVControlCommandType = 'pause'; // let cmd : avSession.AVControlCommandType = 'pause';
// let cmd : avSession.AVControlCommandType = 'stop'; // let cmd : avSession.AVControlCommandType = 'stop';
...@@ -994,7 +1014,7 @@ let cmd : avSession.AVControlCommandType = 'play'; ...@@ -994,7 +1014,7 @@ let cmd : avSession.AVControlCommandType = 'play';
// let cmd : avSession.AVControlCommandType = 'playPrevious'; // let cmd : avSession.AVControlCommandType = 'playPrevious';
// let cmd : avSession.AVControlCommandType = 'fastForward'; // let cmd : avSession.AVControlCommandType = 'fastForward';
// let cmd : avSession.AVControlCommandType = 'rewind'; // let cmd : avSession.AVControlCommandType = 'rewind';
let avcommand = {command:cmd}; let avcommand: avSession.AVControlCommand = {command:cmd};
// let cmd : avSession.AVControlCommandType = 'seek'; // let cmd : avSession.AVControlCommandType = 'seek';
// let avcommand = {command:cmd, parameter:10}; // let avcommand = {command:cmd, parameter:10};
// let cmd : avSession.AVControlCommandType = 'setSpeed'; // let cmd : avSession.AVControlCommandType = 'setSpeed';
...@@ -1004,9 +1024,9 @@ let avcommand = {command:cmd}; ...@@ -1004,9 +1024,9 @@ let avcommand = {command:cmd};
// let cmd : avSession.AVControlCommandType = 'toggleFavorite'; // let cmd : avSession.AVControlCommandType = 'toggleFavorite';
// let avcommand = {command:cmd, parameter:"false"}; // let avcommand = {command:cmd, parameter:"false"};
avSession.sendSystemControlCommand(avcommand).then(() => { avSession.sendSystemControlCommand(avcommand).then(() => {
console.info(`SendSystemControlCommand successfully`); console.info(`SendSystemControlCommand successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`SendSystemControlCommand BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SendSystemControlCommand BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -1043,13 +1063,15 @@ startCastDeviceDiscovery(callback: AsyncCallback\<void>): void ...@@ -1043,13 +1063,15 @@ startCastDeviceDiscovery(callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
avSession.startCastDeviceDiscovery(function (err) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`startCastDeviceDiscovery BusinessError: code: ${err.code}, message: ${err.message}`); avSession.startCastDeviceDiscovery((err: BusinessError) => {
} else { if (err) {
console.info(`startCastDeviceDiscovery successfully`); console.error(`startCastDeviceDiscovery BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`startCastDeviceDiscovery successfully`);
}
}); });
``` ```
...@@ -1073,14 +1095,16 @@ startCastDeviceDiscovery(filter: number, callback: AsyncCallback\<void>): void ...@@ -1073,14 +1095,16 @@ startCastDeviceDiscovery(filter: number, callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
let filter = 2; let filter = 2;
avSession.startCastDeviceDiscovery(filter, function (err) { avSession.startCastDeviceDiscovery(filter, (err: BusinessError) => {
if (err) { if (err) {
console.error(`startCastDeviceDiscovery BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`startCastDeviceDiscovery BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
console.info(`startCastDeviceDiscovery successfully`); console.info(`startCastDeviceDiscovery successfully`);
} }
}); });
``` ```
...@@ -1107,12 +1131,14 @@ startCastDeviceDiscovery(filter?: number): Promise\<void> ...@@ -1107,12 +1131,14 @@ startCastDeviceDiscovery(filter?: number): Promise\<void>
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
let filter = 2; let filter = 2;
avSession.startCastDeviceDiscovery(filter).then(() => { avSession.startCastDeviceDiscovery(filter).then(() => {
console.info(`startCastDeviceDiscovery successfully`); console.info(`startCastDeviceDiscovery successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`startCastDeviceDiscovery BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`startCastDeviceDiscovery BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -1135,13 +1161,15 @@ stopCastDeviceDiscovery(callback: AsyncCallback\<void>): void ...@@ -1135,13 +1161,15 @@ stopCastDeviceDiscovery(callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
avSession.stopCastDeviceDiscovery(function (err) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`stopCastDeviceDiscovery BusinessError: code: ${err.code}, message: ${err.message}`); avSession.stopCastDeviceDiscovery((err: BusinessError) => {
} else { if (err) {
console.info(`stopCastDeviceDiscovery successfully`); console.error(`stopCastDeviceDiscovery BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`stopCastDeviceDiscovery successfully`);
}
}); });
``` ```
...@@ -1163,11 +1191,13 @@ stopCastDeviceDiscovery(): Promise\<void> ...@@ -1163,11 +1191,13 @@ stopCastDeviceDiscovery(): Promise\<void>
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
avSession.stopCastDeviceDiscovery().then(() => { avSession.stopCastDeviceDiscovery().then(() => {
console.info(`startCastDeviceDiscovery successfully`); console.info(`startCastDeviceDiscovery successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`startCastDeviceDiscovery BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`startCastDeviceDiscovery BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -1191,13 +1221,15 @@ setDiscoverable(enable: boolean, callback: AsyncCallback\<void>): void ...@@ -1191,13 +1221,15 @@ setDiscoverable(enable: boolean, callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
avSession.setDiscoverable(true, function (err) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`setDiscoverable BusinessError: code: ${err.code}, message: ${err.message}`); avSession.setDiscoverable(true, (err: BusinessError) => {
} else { if (err) {
console.info(`setDiscoverable successfully`); console.error(`setDiscoverable BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`setDiscoverable successfully`);
}
}); });
``` ```
...@@ -1225,11 +1257,13 @@ setDiscoverable(enable: boolean): Promise\<void> ...@@ -1225,11 +1257,13 @@ setDiscoverable(enable: boolean): Promise\<void>
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
avSession.setDiscoverable(true).then(() => { avSession.setDiscoverable(true).then(() => {
console.info(`setDiscoverable successfully`); console.info(`setDiscoverable successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`setDiscoverable BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`setDiscoverable BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -1259,11 +1293,11 @@ on(type: 'deviceAvailable', callback: (device: OutputDeviceInfo) => void): void ...@@ -1259,11 +1293,11 @@ on(type: 'deviceAvailable', callback: (device: OutputDeviceInfo) => void): void
**示例：** **示例：**
```js ```ts
let castDevice; let castDevice: avSession.OutputDeviceInfo;
avSession.on('deviceAvailable', (device) => { avSession.on('deviceAvailable', (device: avSession.OutputDeviceInfo) => {
castDevice = device; castDevice = device;
console.info(`on deviceAvailable : ${device} `); console.info(`on deviceAvailable : ${device} `);
}); });
``` ```
...@@ -1292,7 +1326,7 @@ off(type: 'deviceAvailable', callback?: (device: OutputDeviceInfo) => void): voi ...@@ -1292,7 +1326,7 @@ off(type: 'deviceAvailable', callback?: (device: OutputDeviceInfo) => void): voi
**示例：** **示例：**
```js ```ts
avSession.off('deviceAvailable'); avSession.off('deviceAvailable');
``` ```
...@@ -1325,32 +1359,32 @@ getAVCastController(sessionId: string, callback: AsyncCallback\<AVCastController ...@@ -1325,32 +1359,32 @@ getAVCastController(sessionId: string, callback: AsyncCallback\<AVCastController
**示例：** **示例：**
```js ```ts
import featureAbility from '@ohos.ability.featureAbility'; import { BusinessError } from '@ohos.base';
let currentAVSession; let currentAVSession: avSession.AVSession;
let tag = "createNewSession"; let tag = "createNewSession";
let context = featureAbility.getContext(); let context: Context = this.context;
let sessionId; //供后续函数入参使用 let sessionId: string; //供后续函数入参使用
avSession.createAVSession(context, tag, "audio", function (err, data) { avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) { if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
currentAVSession = data; currentAVSession = data;
sessionId = currentAVSession.sessionId; sessionId = currentAVSession.sessionId;
console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`); console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`);
} }
}); });
let aVCastController; let aVCastController: avSession.AVCastController;
avSession.getAVCastController(sessionId ,function (err, avcontroller) { avSession.getAVCastController(sessionId , (err: BusinessError, avcontroller: avSession.AVCastController) => {
if (err) { if (err) {
console.error(`getAVCastController BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`getAVCastController BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
aVCastController = avcontroller; aVCastController = avcontroller;
console.info('getAVCastController : SUCCESS '); console.info('getAVCastController : SUCCESS ');
} }
}); });
``` ```
...@@ -1388,30 +1422,30 @@ getAVCastController(sessionId: string): Promise\<AVCastController>; ...@@ -1388,30 +1422,30 @@ getAVCastController(sessionId: string): Promise\<AVCastController>;
**示例：** **示例：**
```js ```ts
import featureAbility from '@ohos.ability.featureAbility'; import { BusinessError } from '@ohos.base';
let currentAVSession; let currentAVSession: avSession.AVSession;
let tag = "createNewSession"; let tag = "createNewSession";
let context = featureAbility.getContext(); let context: Context = this.context;
let sessionId; //供后续函数入参使用 let sessionId: string; //供后续函数入参使用
avSession.createAVSession(context, tag, "audio", function (err, data) { avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) { if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
currentAVSession = data; currentAVSession = data;
sessionId = currentAVSession.sessionId; sessionId = currentAVSession.sessionId;
console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`); console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`);
} }
}); });
let aVCastController; let aVCastController: avSession.AVCastController;
avSession.getAVCastController(sessionId).then((avcontroller) => { avSession.getAVCastController(sessionId).then((avcontroller: avSession.AVCastController) => {
aVCastController = avcontroller; aVCastController = avcontroller;
console.info('getAVCastController : SUCCESS'); console.info('getAVCastController : SUCCESS');
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`getAVCastController BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`getAVCastController BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -1445,38 +1479,39 @@ startCasting(session: SessionToken, device: OutputDeviceInfo, callback: AsyncCal ...@@ -1445,38 +1479,39 @@ startCasting(session: SessionToken, device: OutputDeviceInfo, callback: AsyncCal
**示例：** **示例：**
```js ```ts
import featureAbility from '@ohos.ability.featureAbility'; import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
let currentAVSession; let currentAVSession: avSession.AVSession;
let tag = "createNewSession"; let tag = "createNewSession";
let context = featureAbility.getContext(); let context: Context = this.context;
let currSessionId; //供后续函数入参使用 let sessionId: string; //供后续函数入参使用
avSession.createAVSession(context, tag, "audio", function (err, data) { avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) { if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
currentAVSession = data; currentAVSession = data;
currSessionId = currentAVSession.sessionId; sessionId = currentAVSession.sessionId;
console.info(`CreateAVSession : SUCCESS : sessionId = ${currSessionId}`); console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`);
} }
}); });
let myToken = { let myToken: avSession.SessionToken = {
sessionId: currSessionId, sessionId: sessionId,
} }
let castDevice; let castDevice: avSession.OutputDeviceInfo;
avSession.on('deviceAvailable', (device) => { avSession.on('deviceAvailable', (device: avSession.OutputDeviceInfo) => {
castDevice = device; castDevice = device;
console.info(`on deviceAvailable : ${device} `); console.info(`on deviceAvailable : ${device} `);
}); });
avSession.startCasting(myToken, castDevice, function (err) { avSession.startCasting(myToken, castDevice, (err: BusinessError) => {
if (err) { if (err) {
console.error(`startCasting BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`startCasting BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
console.info(`startCasting successfully`); console.info(`startCasting successfully`);
} }
}); });
``` ```
...@@ -1515,36 +1550,37 @@ startCasting(session: SessionToken, device: OutputDeviceInfo): Promise\<void> ...@@ -1515,36 +1550,37 @@ startCasting(session: SessionToken, device: OutputDeviceInfo): Promise\<void>
**示例：** **示例：**
```js ```ts
import featureAbility from '@ohos.ability.featureAbility'; import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
let currentAVSession; let currentAVSession: avSession.AVSession;
let tag = "createNewSession"; let tag = "createNewSession";
let context = featureAbility.getContext(); let context: Context = this.context;
let currSessionId; //供后续函数入参使用 let sessionId: string; //供后续函数入参使用
avSession.createAVSession(context, tag, "audio", function (err, data) { avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) { if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
currentAVSession = data; currentAVSession = data;
currSessionId = currentAVSession.sessionId; sessionId = currentAVSession.sessionId;
console.info(`CreateAVSession : SUCCESS : sessionId = ${currSessionId}`); console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`);
} }
}); });
let myToken = { let myToken: avSession.SessionToken = {
sessionId: currSessionId, sessionId: sessionId,
} }
let castDevice; let castDevice: avSession.OutputDeviceInfo;
avSession.on('deviceAvailable', (device) => { avSession.on('deviceAvailable', (device: avSession.OutputDeviceInfo) => {
castDevice = device; castDevice = device;
console.info(`on deviceAvailable : ${device} `); console.info(`on deviceAvailable : ${device} `);
}); });
avSession.startCasting(myToken, castDevice).then(() => { avSession.startCasting(myToken, castDevice).then(() => {
console.info(`startCasting successfully`); console.info(`startCasting successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`startCasting BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`startCasting BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -1574,33 +1610,34 @@ stopCasting(session: SessionToken, callback: AsyncCallback\<void>): void ...@@ -1574,33 +1610,34 @@ stopCasting(session: SessionToken, callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
import featureAbility from '@ohos.ability.featureAbility'; import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
let currentAVSession; let currentAVSession: avSession.AVSession;
let tag = "createNewSession"; let tag = "createNewSession";
let context = featureAbility.getContext(); let context: Context = this.context;
let currSessionId; //供后续函数入参使用 let sessionId: string; //供后续函数入参使用
avSession.createAVSession(context, tag, "audio", function (err, data) { avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) { if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
currentAVSession = data; currentAVSession = data;
currSessionId = currentAVSession.sessionId; sessionId = currentAVSession.sessionId;
console.info(`CreateAVSession : SUCCESS : sessionId = ${currSessionId}`); console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`);
} }
}); });
let myToken = { let myToken: avSession.SessionToken = {
sessionId: currSessionId, sessionId: sessionId,
} }
avSession.stopCasting(myToken, function (err) { avSession.stopCasting(myToken, (err: BusinessError) => {
if (err) { if (err) {
console.error(`stopCasting BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`stopCasting BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
console.info(`stopCasting successfully`); console.info(`stopCasting successfully`);
} }
}); });
``` ```
...@@ -1635,32 +1672,34 @@ stopCasting(session: SessionToken): Promise\<void> ...@@ -1635,32 +1672,34 @@ stopCasting(session: SessionToken): Promise\<void>
**示例：** **示例：**
```js ```ts
import featureAbility from '@ohos.ability.featureAbility'; import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
let currentAVSession; let currentAVSession: avSession.AVSession;
let tag = "createNewSession"; let tag = "createNewSession";
let context = featureAbility.getContext(); let context: Context = this.context;
let currSessionId; //供后续函数入参使用 let sessionId: string; //供后续函数入参使用
avSession.createAVSession(context, tag, "audio", function (err, data) { avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) { if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
currentAVSession = data; currentAVSession = data;
currSessionId = currentAVSession.sessionId; sessionId = currentAVSession.sessionId;
console.info(`CreateAVSession : SUCCESS : sessionId = ${currSessionId}`); console.info(`CreateAVSession : SUCCESS : sessionId = ${sessionId}`);
} }
}); });
let myToken = { let myToken: avSession.SessionToken = {
sessionId: currSessionId, sessionId: sessionId,
} }
avSession.stopCasting(myToken).then(() => { avSession.stopCasting(myToken).then(() => {
console.info(`stopCasting successfully`); console.info(`stopCasting successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`stopCasting BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`stopCasting BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
## AVSessionType<sup>10+<sup> ## AVSessionType<sup>10+<sup>
...@@ -1688,9 +1727,9 @@ avSession.stopCasting(myToken).then(() => { ...@@ -1688,9 +1727,9 @@ avSession.stopCasting(myToken).then(() => {
**示例：** **示例：**
```js ```ts
let sessionId = currentAVSession.sessionId; let sessionId: string = currentAVSession.sessionId;
let sessionType = currentAVSession.sessionType; let sessionType: avSession.AVSessionType = currentAVSession.sessionType;
``` ```
### setAVMetadata<sup>10+</sup> ### setAVMetadata<sup>10+</sup>
...@@ -1723,27 +1762,30 @@ setAVMetadata(data: AVMetadata): Promise\<void> ...@@ -1723,27 +1762,30 @@ setAVMetadata(data: AVMetadata): Promise\<void>
**示例：** **示例：**
```js ```ts
let metadata = { import avSession from '@ohos.multimedia.avsession';
assetId: "121278", import { BusinessError } from '@ohos.base';
title: "lose yourself",
artist: "Eminem", let metadata: avSession.AVMetadata = {
author: "ST", assetId: "121278",
album: "Slim shady", title: "lose yourself",
writer: "ST", artist: "Eminem",
composer: "ST", author: "ST",
duration: 2222, album: "Slim shady",
mediaImage: "https://www.example.com/example.jpg", writer: "ST",
subtitle: "8 Mile", composer: "ST",
description: "Rap", duration: 2222,
lyric: "https://www.example.com/example.lrc", mediaImage: "https://www.example.com/example.jpg",
previousAssetId: "121277", subtitle: "8 Mile",
nextAssetId: "121279", description: "Rap",
lyric: "https://www.example.com/example.lrc",
previousAssetId: "121277",
nextAssetId: "121279",
}; };
currentAVSession.setAVMetadata(metadata).then(() => { currentAVSession.setAVMetadata(metadata).then(() => {
console.info(`SetAVMetadata successfully`); console.info(`SetAVMetadata successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`SetAVMetadata BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SetAVMetadata BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -1772,29 +1814,32 @@ setAVMetadata(data: AVMetadata, callback: AsyncCallback\<void>): void ...@@ -1772,29 +1814,32 @@ setAVMetadata(data: AVMetadata, callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
let metadata = { import avSession from '@ohos.multimedia.avsession';
assetId: "121278", import { BusinessError } from '@ohos.base';
title: "lose yourself",
artist: "Eminem", let metadata: avSession.AVMetadata = {
author: "ST", assetId: "121278",
album: "Slim shady", title: "lose yourself",
writer: "ST", artist: "Eminem",
composer: "ST", author: "ST",
duration: 2222, album: "Slim shady",
mediaImage: "https://www.example.com/example.jpg", writer: "ST",
subtitle: "8 Mile", composer: "ST",
description: "Rap", duration: 2222,
lyric: "https://www.example.com/example.lrc", mediaImage: "https://www.example.com/example.jpg",
previousAssetId: "121277", subtitle: "8 Mile",
nextAssetId: "121279", description: "Rap",
lyric: "https://www.example.com/example.lrc",
previousAssetId: "121277",
nextAssetId: "121279",
}; };
currentAVSession.setAVMetadata(metadata, function (err) { currentAVSession.setAVMetadata(metadata, (err: BusinessError) => {
if (err) { if (err) {
console.error(`SetAVMetadata BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SetAVMetadata BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
console.info(`SetAVMetadata successfully`); console.info(`SetAVMetadata successfully`);
} }
}); });
``` ```
...@@ -1828,19 +1873,22 @@ setAVPlaybackState(state: AVPlaybackState): Promise\<void> ...@@ -1828,19 +1873,22 @@ setAVPlaybackState(state: AVPlaybackState): Promise\<void>
**示例：** **示例：**
```js ```ts
let playbackState = { import avSession from '@ohos.multimedia.avsession';
state:avSession.PlaybackState.PLAYBACK_STATE_PLAY, import { BusinessError } from '@ohos.base';
speed: 1.0,
position:{elapsedTime:10, updateTime:(new Date()).getTime()}, let playbackState: avSession.AVPlaybackState = {
bufferedTime:1000, state:avSession.PlaybackState.PLAYBACK_STATE_PLAY,
loopMode:avSession.LoopMode.LOOP_MODE_SINGLE, speed: 1.0,
isFavorite:true, position:{elapsedTime:10, updateTime:(new Date()).getTime()},
bufferedTime:1000,
loopMode:avSession.LoopMode.LOOP_MODE_SINGLE,
isFavorite:true,
}; };
currentAVSession.setAVPlaybackState(playbackState).then(() => { currentAVSession.setAVPlaybackState(playbackState).then(() => {
console.info(`SetAVPlaybackState successfully`); console.info(`SetAVPlaybackState successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.info(`SetAVPlaybackState BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`SetAVPlaybackState BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -1869,21 +1917,24 @@ setAVPlaybackState(state: AVPlaybackState, callback: AsyncCallback\<void>): void ...@@ -1869,21 +1917,24 @@ setAVPlaybackState(state: AVPlaybackState, callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
let PlaybackState = { import avSession from '@ohos.multimedia.avsession';
state:avSession.PlaybackState.PLAYBACK_STATE_PLAY, import { BusinessError } from '@ohos.base';
speed: 1.0,
position:{elapsedTime:10, updateTime:(new Date()).getTime()}, let PlaybackState: avSession.AVPlaybackState = {
bufferedTime:1000, state:avSession.PlaybackState.PLAYBACK_STATE_PLAY,
loopMode:avSession.LoopMode.LOOP_MODE_SINGLE, speed: 1.0,
isFavorite:true, position:{elapsedTime:10, updateTime:(new Date()).getTime()},
bufferedTime:1000,
loopMode:avSession.LoopMode.LOOP_MODE_SINGLE,
isFavorite:true,
}; };
currentAVSession.setAVPlaybackState(PlaybackState, function (err) { currentAVSession.setAVPlaybackState(PlaybackState, (err: BusinessError) => {
if (err) { if (err) {
console.info(`SetAVPlaybackState BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`SetAVPlaybackState BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
console.info(`SetAVPlaybackState successfully`); console.info(`SetAVPlaybackState successfully`);
} }
}); });
``` ```
...@@ -1917,43 +1968,44 @@ setLaunchAbility(ability: WantAgent): Promise\<void> ...@@ -1917,43 +1968,44 @@ setLaunchAbility(ability: WantAgent): Promise\<void>
**示例：** **示例：**
```js ```ts
import wantAgent from '@ohos.app.ability.wantAgent'; import wantAgent from '@ohos.app.ability.wantAgent';
import { BusinessError } from '@ohos.base';
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: wantAgent.WantAgentInfo = {
wants: [ wants: [
{
deviceId: "deviceId",
bundleName: "com.example.myapplication",
abilityName: "EntryAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{ {
deviceId: "deviceId", mykey0: 2222,
bundleName: "com.example.myapplication", mykey1: [1, 2, 3],
abilityName: "EntryAbility", mykey2: "[1, 2, 3]",
action: "action1", mykey3: "ssssssssssssssssssssssssss",
entities: ["entity1"], mykey4: [false, true, false],
type: "MIMETYPE", mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
uri: "key={true,true,false}", mykey6: true,
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
} }
], }
operationType: wantAgent.OperationType.START_ABILITIES, ],
requestCode: 0, operationType: wantAgent.OperationType.START_ABILITIES,
wantAgentFlags:[wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] requestCode: 0,
wantAgentFlags:[wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
} }
wantAgent.getWantAgent(wantAgentInfo).then((agent) => { wantAgent.getWantAgent(wantAgentInfo).then((agent) => {
currentAVSession.setLaunchAbility(agent).then(() => { currentAVSession.setLaunchAbility(agent).then(() => {
console.info(`SetLaunchAbility successfully`); console.info(`SetLaunchAbility successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`SetLaunchAbility BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SetLaunchAbility BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
}); });
``` ```
...@@ -1982,45 +2034,46 @@ setLaunchAbility(ability: WantAgent, callback: AsyncCallback\<void>): void ...@@ -1982,45 +2034,46 @@ setLaunchAbility(ability: WantAgent, callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
import wantAgent from '@ohos.app.ability.wantAgent'; import wantAgent from '@ohos.app.ability.wantAgent';
import { BusinessError } from '@ohos.base';
//WantAgentInfo对象 //WantAgentInfo对象
let wantAgentInfo = { let wantAgentInfo: wantAgent.WantAgentInfo = {
wants: [ wants: [
{
deviceId: "deviceId",
bundleName: "com.example.myapplication",
abilityName: "EntryAbility",
action: "action1",
entities: ["entity1"],
type: "MIMETYPE",
uri: "key={true,true,false}",
parameters:
{ {
deviceId: "deviceId", mykey0: 2222,
bundleName: "com.example.myapplication", mykey1: [1, 2, 3],
abilityName: "EntryAbility", mykey2: "[1, 2, 3]",
action: "action1", mykey3: "ssssssssssssssssssssssssss",
entities: ["entity1"], mykey4: [false, true, false],
type: "MIMETYPE", mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
uri: "key={true,true,false}", mykey6: true,
parameters:
{
mykey0: 2222,
mykey1: [1, 2, 3],
mykey2: "[1, 2, 3]",
mykey3: "ssssssssssssssssssssssssss",
mykey4: [false, true, false],
mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
mykey6: true,
}
} }
], }
operationType: wantAgent.OperationType.START_ABILITIES, ],
requestCode: 0, operationType: wantAgent.OperationType.START_ABILITIES,
wantAgentFlags:[wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG] requestCode: 0,
wantAgentFlags:[wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
} }
wantAgent.getWantAgent(wantAgentInfo).then((agent) => { wantAgent.getWantAgent(wantAgentInfo).then((agent) => {
currentAVSession.setLaunchAbility(agent, function (err) { currentAVSession.setLaunchAbility(agent, (err: BusinessError) => {
if (err) { if (err) {
console.error(`SetLaunchAbility BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SetLaunchAbility BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
console.info(`SetLaunchAbility successfully`); console.info(`SetLaunchAbility successfully`);
} }
}); });
}); });
``` ```
...@@ -2058,13 +2111,27 @@ dispatchSessionEvent(event: string, args: {[key: string]: Object}): Promise\<voi ...@@ -2058,13 +2111,27 @@ dispatchSessionEvent(event: string, args: {[key: string]: Object}): Promise\<voi
**示例：** **示例：**
```js ```ts
import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
let currentAVSession: avSession.AVSession;
let tag = "createNewSession";
let context: Context = this.context;
avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
currentAVSession = data;
}
});
let eventName = "dynamic_lyric"; let eventName = "dynamic_lyric";
let args = {
lyric : "This is lyric" currentAVSession.dispatchSessionEvent(eventName, {lyric : "This is lyric"}).then(() => {
} console.info(`dispatchSessionEvent successfully`);
currentAVSession.dispatchSessionEvent(eventName, args).catch((err) => { }).catch((err: BusinessError) => {
console.info(`dispatchSessionEvent BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`dispatchSessionEvent BusinessError: code: ${err.code}, message: ${err.message}`);
}) })
``` ```
...@@ -2097,15 +2164,26 @@ dispatchSessionEvent(event: string, args: {[key: string]: Object}, callback: Asy ...@@ -2097,15 +2164,26 @@ dispatchSessionEvent(event: string, args: {[key: string]: Object}, callback: Asy
**示例：** **示例：**
```js ```ts
import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
let currentAVSession: avSession.AVSession;
let tag = "createNewSession";
let context: Context = this.context;
avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
currentAVSession = data;
}
});
let eventName = "dynamic_lyric"; let eventName = "dynamic_lyric";
let args = { currentAVSession.dispatchSessionEvent(eventName, {lyric : "This is lyric"}, (err: BusinessError) => {
lyric : "This is lyric" if(err) {
} console.error(`dispatchSessionEvent BusinessError: code: ${err.code}, message: ${err.message}`);
currentAVSession.dispatchSessionEvent(eventName, args, (err) => { }
if(err) {
console.error(`dispatchSessionEvent BusinessError: code: ${err.code}, message: ${err.message}`);
}
}) })
``` ```
...@@ -2139,44 +2217,49 @@ setAVQueueItems(items: Array\<AVQueueItem>): Promise\<void> ...@@ -2139,44 +2217,49 @@ setAVQueueItems(items: Array\<AVQueueItem>): Promise\<void>
**示例：** **示例：**
```js ```ts
import image from '@ohos.multimedia.image'; import image from '@ohos.multimedia.image';
import resourceManager from '@ohos.resourceManager'; import resourceManager from '@ohos.resourceManager';
import { BusinessError } from '@ohos.base';
import avSession from '@ohos.multimedia.avsession';
let value : Uint8Array = await resourceManager.getRawFileContent('IMAGE_URI'); let value: Uint8Array = resourceManager.getRawFileContent('IMAGE_URI');
let imageSource : imageImageSource = image.createImageSource(value.buffer); let imageSource: image.ImageSource = image.createImageSource(value.buffer);
let imagePixel : image.PixelMap = await imageSource.createPixelMap({desiredSize:{width: 150, height: 150}}); let imagePixel: image.PixelMap;
let queueItemDescription_1 = { imageSource.createPixelMap({desiredSize:{width: 150, height: 150}}).then((data) => {
mediaId: '001', imagePixel = data;
title: 'music_name', }).catch((err: BusinessError) => {
subtitle: 'music_sub_name', console.error(`createPixelMap BusinessError: code: ${err.code}, message: ${err.message}`);
description: 'music_description', })
icon : imagePixel, let queueItemDescription_1: avSession.AVMediaDescription = {
iconUri: 'http://www.icon.uri.com', assetId: '001',
extras: {'extras':'any'} title: 'music_name',
subtitle: 'music_sub_name',
description: 'music_description',
mediaImage : imagePixel,
extras: {extras:'any'}
}; };
let queueItem_1 = { let queueItem_1: avSession.AVQueueItem = {
itemId: 1, itemId: 1,
description: queueItemDescription_1 description: queueItemDescription_1
}; };
let queueItemDescription_2 = { let queueItemDescription_2: avSession.AVMediaDescription = {
mediaId: '002', assetId: '002',
title: 'music_name', title: 'music_name',
subtitle: 'music_sub_name', subtitle: 'music_sub_name',
description: 'music_description', description: 'music_description',
icon: imagePixel, mediaImage: imagePixel,
iconUri: 'http://www.xxx.com', extras: {extras:'any'}
extras: {'extras':'any'}
}; };
let queueItem_2 = { let queueItem_2: avSession.AVQueueItem = {
itemId: 2, itemId: 2,
description: queueItemDescription_2 description: queueItemDescription_2
}; };
let queueItemsArray = [queueItem_1, queueItem_2]; let queueItemsArray: avSession.AVQueueItem[] = [queueItem_1, queueItem_2];
currentAVSession.setAVQueueItems(queueItemsArray).then(() => { currentAVSession.setAVQueueItems(queueItemsArray).then(() => {
console.info(`SetAVQueueItems successfully`); console.info(`SetAVQueueItems successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`SetAVQueueItems BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SetAVQueueItems BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -2205,46 +2288,51 @@ setAVQueueItems(items: Array\<AVQueueItem>, callback: AsyncCallback\<void>): voi ...@@ -2205,46 +2288,51 @@ setAVQueueItems(items: Array\<AVQueueItem>, callback: AsyncCallback\<void>): voi
**示例：** **示例：**
```js ```ts
import image from '@ohos.multimedia.image'; import image from '@ohos.multimedia.image';
import resourceManager from '@ohos.resourceManager'; import resourceManager from '@ohos.resourceManager';
import { BusinessError } from '@ohos.base';
import avSession from '@ohos.multimedia.avsession';
let value : Uint8Array = await resourceManager.getRawFileContent('IMAGE_URI'); let value: Uint8Array = resourceManager.getRawFileContent('IMAGE_URI');
let imageSource : imageImageSource = image.createImageSource(value.buffer); let imageSource: image.ImageSource = image.createImageSource(value.buffer);
let imagePixel : image.PixelMap = await imageSource.createPixelMap({desiredSize:{width: 150, height: 150}}); let imagePixel: image.PixelMap;
let queueItemDescription_1 = { imageSource.createPixelMap({desiredSize:{width: 150, height: 150}}).then((data) => {
mediaId: '001', imagePixel = data;
title: 'music_name', }).catch((err: BusinessError) => {
subtitle: 'music_sub_name', console.error(`createPixelMap BusinessError: code: ${err.code}, message: ${err.message}`);
description: 'music_description', })
icon: imagePixel, let queueItemDescription_1: avSession.AVMediaDescription = {
iconUri: 'http://www.icon.uri.com', assetId: '001',
extras: {'extras':'any'} title: 'music_name',
subtitle: 'music_sub_name',
description: 'music_description',
mediaImage : imagePixel,
extras: {extras:'any'}
}; };
let queueItem_1 = { let queueItem_1: avSession.AVQueueItem = {
itemId: 1, itemId: 1,
description: queueItemDescription_1 description: queueItemDescription_1
}; };
let queueItemDescription_2 = { let queueItemDescription_2: avSession.AVMediaDescription = {
mediaId: '002', assetId: '002',
title: 'music_name', title: 'music_name',
subtitle: 'music_sub_name', subtitle: 'music_sub_name',
description: 'music_description', description: 'music_description',
icon: imagePixel, mediaImage: imagePixel,
iconUri: 'http://www.icon.uri.com', extras: {extras:'any'}
extras: {'extras':'any'}
}; };
let queueItem_2 = { let queueItem_2: avSession.AVQueueItem = {
itemId: 2, itemId: 2,
description: queueItemDescription_2 description: queueItemDescription_2
}; };
let queueItemsArray = [queueItem_1, queueItem_2]; let queueItemsArray: avSession.AVQueueItem[] = [queueItem_1, queueItem_2];
currentAVSession.setAVQueueItems(queueItemsArray, function (err) { currentAVSession.setAVQueueItems(queueItemsArray, (err: BusinessError) => {
if (err) { if (err) {
console.error(`SetAVQueueItems BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SetAVQueueItems BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
console.info(`SetAVQueueItems successfully`); console.info(`SetAVQueueItems successfully`);
} }
}); });
``` ```
...@@ -2278,12 +2366,14 @@ setAVQueueTitle(title: string): Promise\<void> ...@@ -2278,12 +2366,14 @@ setAVQueueTitle(title: string): Promise\<void>
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
let queueTitle = 'QUEUE_TITLE'; let queueTitle = 'QUEUE_TITLE';
currentAVSession.setAVQueueTitle(queueTitle).then(() => { currentAVSession.setAVQueueTitle(queueTitle).then(() => {
console.info(`SetAVQueueTitle successfully`); console.info(`SetAVQueueTitle successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`SetAVQueueTitle BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SetAVQueueTitle BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -2312,14 +2402,16 @@ setAVQueueTitle(title: string, callback: AsyncCallback\<void>): void ...@@ -2312,14 +2402,16 @@ setAVQueueTitle(title: string, callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
let queueTitle = 'QUEUE_TITLE'; let queueTitle = 'QUEUE_TITLE';
currentAVSession.setAVQueueTitle(queueTitle, function (err) { currentAVSession.setAVQueueTitle(queueTitle, (err: BusinessError) => {
if (err) { if (err) {
console.info(`SetAVQueueTitle BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`SetAVQueueTitle BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
console.error(`SetAVQueueTitle successfully`); console.error(`SetAVQueueTitle successfully`);
} }
}); });
``` ```
...@@ -2356,12 +2448,23 @@ setExtras(extras: {[key: string]: Object}): Promise\<void> ...@@ -2356,12 +2448,23 @@ setExtras(extras: {[key: string]: Object}): Promise\<void>
**示例：** **示例：**
```js ```ts
let extras = { import avSession from '@ohos.multimedia.avsession';
extras : "This is custom media packet" import { BusinessError } from '@ohos.base';
}
currentAVSession.setExtras(extras).catch((err) => { let currentAVSession: avSession.AVSession;
console.info(`setExtras BusinessError: code: ${err.code}, message: ${err.message}`); let tag = "createNewSession";
let context: Context = this.context;
avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
currentAVSession = data;
}
});
currentAVSession.setExtras({"extras" : "This is custom media packet"}).catch((err: BusinessError) => {
console.info(`setExtras BusinessError: code: ${err.code}, message: ${err.message}`);
}) })
``` ```
...@@ -2393,14 +2496,25 @@ setExtras(extras: {[key: string]: Object}, callback: AsyncCallback\<void>): void ...@@ -2393,14 +2496,25 @@ setExtras(extras: {[key: string]: Object}, callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
let extras = { import avSession from '@ohos.multimedia.avsession';
extras : "This is custom media packet" import { BusinessError } from '@ohos.base';
}
currentAVSession.setExtras(extras, (err) => { let currentAVSession: avSession.AVSession;
if(err) { let tag = "createNewSession";
console.error(`setExtras BusinessError: code: ${err.code}, message: ${err.message}`); let context: Context = this.context;
}
avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
currentAVSession = data;
}
});
currentAVSession.setExtras({"extras" : "This is custom media packet"}, (err: BusinessError) => {
if(err) {
console.error(`setExtras BusinessError: code: ${err.code}, message: ${err.message}`);
}
}) })
``` ```
...@@ -2428,13 +2542,15 @@ getController(): Promise\<AVSessionController> ...@@ -2428,13 +2542,15 @@ getController(): Promise\<AVSessionController>
**示例：** **示例：**
```js ```ts
let avsessionController; import { BusinessError } from '@ohos.base';
currentAVSession.getController().then((avcontroller) => {
avsessionController = avcontroller; let avsessionController: avSession.AVSessionController;
console.info(`GetController : SUCCESS : sessionid : ${avsessionController.sessionId}`); currentAVSession.getController().then((avcontroller: avSession.AVSessionController) => {
}).catch((err) => { avsessionController = avcontroller;
console.error(`GetController BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`GetController : SUCCESS : sessionid : ${avsessionController.sessionId}`);
}).catch((err: BusinessError) => {
console.error(`GetController BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -2462,15 +2578,17 @@ getController(callback: AsyncCallback\<AVSessionController>): void ...@@ -2462,15 +2578,17 @@ getController(callback: AsyncCallback\<AVSessionController>): void
**示例：** **示例：**
```js ```ts
let avsessionController; import { BusinessError } from '@ohos.base';
currentAVSession.getController(function (err, avcontroller) {
if (err) { let avsessionController: avSession.AVSessionController;
console.error(`GetController BusinessError: code: ${err.code}, message: ${err.message}`); currentAVSession.getController((err: BusinessError, avcontroller: avSession.AVSessionController) => {
} else { if (err) {
avsessionController = avcontroller; console.error(`GetController BusinessError: code: ${err.code}, message: ${err.message}`);
console.info(`GetController : SUCCESS : sessionid : ${avsessionController.sessionId}`); } else {
} avsessionController = avcontroller;
console.info(`GetController : SUCCESS : sessionid : ${avsessionController.sessionId}`);
}
}); });
``` ```
...@@ -2498,13 +2616,15 @@ getAVCastController(callback: AsyncCallback\<AVCastController>): void ...@@ -2498,13 +2616,15 @@ getAVCastController(callback: AsyncCallback\<AVCastController>): void
**示例：** **示例：**
```js ```ts
let aVCastController; import { BusinessError } from '@ohos.base';
currentAVSession.getAVCastController().then((avcontroller) => {
aVCastController = avcontroller; let aVCastController: avSession.AVCastController;
console.info(`getAVCastController : SUCCESS : sessionid : ${aVCastController.sessionId}`); currentAVSession.getAVCastController().then((avcontroller: avSession.AVCastController) => {
}).catch((err) => { aVCastController = avcontroller;
console.error(`getAVCastController BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`getAVCastController : SUCCESS : sessionid : ${aVCastController.sessionId}`);
}).catch((err: BusinessError) => {
console.error(`getAVCastController BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -2532,15 +2652,17 @@ getAVCastController(): Promise\<AVCastController>; ...@@ -2532,15 +2652,17 @@ getAVCastController(): Promise\<AVCastController>;
**示例：** **示例：**
```js ```ts
let aVCastController; import { BusinessError } from '@ohos.base';
currentAVSession.getAVCastController(function (err, avcontroller) {
if (err) { let aVCastController: avSession.AVCastController;
console.error(`getAVCastController BusinessError: code: ${err.code}, message: ${err.message}`); currentAVSession.getAVCastController((err: BusinessError, avcontroller: avSession.AVCastController) => {
} else { if (err) {
aVCastController = avcontroller; console.error(`getAVCastController BusinessError: code: ${err.code}, message: ${err.message}`);
console.info(`getAVCastController : SUCCESS : sessionid : ${aVCastController.sessionId}`); } else {
} aVCastController = avcontroller;
console.info(`getAVCastController : SUCCESS : sessionid : ${aVCastController.sessionId}`);
}
}); });
``` ```
...@@ -2569,12 +2691,14 @@ getOutputDevice(): Promise\<OutputDeviceInfo> ...@@ -2569,12 +2691,14 @@ getOutputDevice(): Promise\<OutputDeviceInfo>
**示例：** **示例：**
```js ```ts
currentAVSession.getOutputDevice().then((outputDeviceInfo) => { import { BusinessError } from '@ohos.base';
console.info(`GetOutputDevice : SUCCESS : isRemote : ${outputDeviceInfo.isRemote}`);
}).catch((err) => { currentAVSession.getOutputDevice().then((outputDeviceInfo: avSession.OutputDeviceInfo) => {
console.error(`GetOutputDevice BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`GetOutputDevice : SUCCESS : isRemote : ${outputDeviceInfo.isRemote}`);
}); }).catch((err: BusinessError) => {
console.error(`GetOutputDevice BusinessError: code: ${err.code}, message: ${err.message}`);
})
``` ```
### getOutputDevice<sup>10+</sup> ### getOutputDevice<sup>10+</sup>
...@@ -2602,13 +2726,15 @@ getOutputDevice(callback: AsyncCallback\<OutputDeviceInfo>): void ...@@ -2602,13 +2726,15 @@ getOutputDevice(callback: AsyncCallback\<OutputDeviceInfo>): void
**示例：** **示例：**
```js ```ts
currentAVSession.getOutputDevice(function (err, outputDeviceInfo) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`GetOutputDevice BusinessError: code: ${err.code}, message: ${err.message}`); currentAVSession.getOutputDevice((err: BusinessError, outputDeviceInfo: avSession.OutputDeviceInfo) => {
} else { if (err) {
console.info(`GetOutputDevice : SUCCESS : isRemote : ${outputDeviceInfo.isRemote}`); console.error(`GetOutputDevice BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`GetOutputDevice : SUCCESS : isRemote : ${outputDeviceInfo.isRemote}`);
}
}); });
``` ```
...@@ -2636,11 +2762,13 @@ activate(): Promise\<void> ...@@ -2636,11 +2762,13 @@ activate(): Promise\<void>
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
currentAVSession.activate().then(() => { currentAVSession.activate().then(() => {
console.info(`Activate : SUCCESS `); console.info(`Activate : SUCCESS `);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`Activate BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`Activate BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -2668,13 +2796,15 @@ activate(callback: AsyncCallback\<void>): void ...@@ -2668,13 +2796,15 @@ activate(callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
currentAVSession.activate(function (err) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`Activate BusinessError: code: ${err.code}, message: ${err.message}`); currentAVSession.activate((err: BusinessError) => {
} else { if (err) {
console.info(`Activate : SUCCESS `); console.error(`Activate BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`Activate : SUCCESS `);
}
}); });
``` ```
...@@ -2702,11 +2832,13 @@ deactivate(): Promise\<void> ...@@ -2702,11 +2832,13 @@ deactivate(): Promise\<void>
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
currentAVSession.deactivate().then(() => { currentAVSession.deactivate().then(() => {
console.info(`Deactivate : SUCCESS `); console.info(`Deactivate : SUCCESS `);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`Deactivate BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`Deactivate BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -2736,13 +2868,15 @@ deactivate(callback: AsyncCallback\<void>): void ...@@ -2736,13 +2868,15 @@ deactivate(callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
currentAVSession.deactivate(function (err) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`Deactivate BusinessError: code: ${err.code}, message: ${err.message}`); currentAVSession.deactivate((err: BusinessError) => {
} else { if (err) {
console.info(`Deactivate : SUCCESS `); console.error(`Deactivate BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`Deactivate : SUCCESS `);
}
}); });
``` ```
...@@ -2770,11 +2904,13 @@ destroy(): Promise\<void> ...@@ -2770,11 +2904,13 @@ destroy(): Promise\<void>
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
currentAVSession.destroy().then(() => { currentAVSession.destroy().then(() => {
console.info(`Destroy : SUCCESS `); console.info(`Destroy : SUCCESS `);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`Destroy BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`Destroy BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -2802,13 +2938,15 @@ destroy(callback: AsyncCallback\<void>): void ...@@ -2802,13 +2938,15 @@ destroy(callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
currentAVSession.destroy(function (err) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`Destroy BusinessError: code: ${err.code}, message: ${err.message}`); currentAVSession.destroy((err: BusinessError) => {
} else { if (err) {
console.info(`Destroy : SUCCESS `); console.error(`Destroy BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`Destroy : SUCCESS `);
}
}); });
``` ```
...@@ -2837,9 +2975,9 @@ on(type: 'play', callback: () => void): void ...@@ -2837,9 +2975,9 @@ on(type: 'play', callback: () => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.on('play', () => { currentAVSession.on('play', () => {
console.info(`on play entry`); console.info(`on play entry`);
}); });
``` ```
...@@ -2868,9 +3006,9 @@ on(type: 'pause', callback: () => void): void ...@@ -2868,9 +3006,9 @@ on(type: 'pause', callback: () => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.on('pause', () => { currentAVSession.on('pause', () => {
console.info(`on pause entry`); console.info(`on pause entry`);
}); });
``` ```
...@@ -2899,9 +3037,9 @@ on(type:'stop', callback: () => void): void ...@@ -2899,9 +3037,9 @@ on(type:'stop', callback: () => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.on('stop', () => { currentAVSession.on('stop', () => {
console.info(`on stop entry`); console.info(`on stop entry`);
}); });
``` ```
...@@ -2930,9 +3068,9 @@ on(type:'playNext', callback: () => void): void ...@@ -2930,9 +3068,9 @@ on(type:'playNext', callback: () => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.on('playNext', () => { currentAVSession.on('playNext', () => {
console.info(`on playNext entry`); console.info(`on playNext entry`);
}); });
``` ```
...@@ -2961,9 +3099,9 @@ on(type:'playPrevious', callback: () => void): void ...@@ -2961,9 +3099,9 @@ on(type:'playPrevious', callback: () => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.on('playPrevious', () => { currentAVSession.on('playPrevious', () => {
console.info(`on playPrevious entry`); console.info(`on playPrevious entry`);
}); });
``` ```
...@@ -2992,9 +3130,9 @@ on(type: 'fastForward', callback: () => void): void ...@@ -2992,9 +3130,9 @@ on(type: 'fastForward', callback: () => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.on('fastForward', () => { currentAVSession.on('fastForward', () => {
console.info(`on fastForward entry`); console.info(`on fastForward entry`);
}); });
``` ```
...@@ -3023,9 +3161,9 @@ on(type:'rewind', callback: () => void): void ...@@ -3023,9 +3161,9 @@ on(type:'rewind', callback: () => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.on('rewind', () => { currentAVSession.on('rewind', () => {
console.info(`on rewind entry`); console.info(`on rewind entry`);
}); });
``` ```
...@@ -3054,9 +3192,9 @@ on(type: 'seek', callback: (time: number) => void): void ...@@ -3054,9 +3192,9 @@ on(type: 'seek', callback: (time: number) => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.on('seek', (time) => { currentAVSession.on('seek', (time: number) => {
console.info(`on seek entry time : ${time}`); console.info(`on seek entry time : ${time}`);
}); });
``` ```
...@@ -3085,9 +3223,9 @@ on(type: 'setSpeed', callback: (speed: number) => void): void ...@@ -3085,9 +3223,9 @@ on(type: 'setSpeed', callback: (speed: number) => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.on('setSpeed', (speed) => { currentAVSession.on('setSpeed', (speed: number) => {
console.info(`on setSpeed speed : ${speed}`); console.info(`on setSpeed speed : ${speed}`);
}); });
``` ```
...@@ -3116,9 +3254,9 @@ on(type: 'setLoopMode', callback: (mode: LoopMode) => void): void ...@@ -3116,9 +3254,9 @@ on(type: 'setLoopMode', callback: (mode: LoopMode) => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.on('setLoopMode', (mode) => { currentAVSession.on('setLoopMode', (mode: avSession.LoopMode) => {
console.info(`on setLoopMode mode : ${mode}`); console.info(`on setLoopMode mode : ${mode}`);
}); });
``` ```
...@@ -3147,9 +3285,9 @@ on(type: 'toggleFavorite', callback: (assetId: string) => void): void ...@@ -3147,9 +3285,9 @@ on(type: 'toggleFavorite', callback: (assetId: string) => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.on('toggleFavorite', (assetId) => { currentAVSession.on('toggleFavorite', (assetId: string) => {
console.info(`on toggleFavorite mode : ${assetId}`); console.info(`on toggleFavorite mode : ${assetId}`);
}); });
``` ```
...@@ -3178,9 +3316,9 @@ on(type: 'skipToQueueItem', callback: (itemId: number) => void): void ...@@ -3178,9 +3316,9 @@ on(type: 'skipToQueueItem', callback: (itemId: number) => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.on('skipToQueueItem', (itemId) => { currentAVSession.on('skipToQueueItem', (itemId: number) => {
console.info(`on skipToQueueItem id : ${itemId}`); console.info(`on skipToQueueItem id : ${itemId}`);
}); });
``` ```
...@@ -3209,10 +3347,13 @@ on(type: 'handleKeyEvent', callback: (event: KeyEvent) => void): void ...@@ -3209,10 +3347,13 @@ on(type: 'handleKeyEvent', callback: (event: KeyEvent) => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.on('handleKeyEvent', (event) => { import keyEvent from '@ohos.multimodalInput.keyEvent';
console.info(`on handleKeyEvent event : ${event}`);
currentAVSession.on('handleKeyEvent', (event: keyEvent.KeyEvent) => {
console.info(`on handleKeyEvent event : ${event}`);
}); });
``` ```
### on('outputDeviceChange')<sup>10+</sup> ### on('outputDeviceChange')<sup>10+</sup>
...@@ -3240,9 +3381,9 @@ on(type: 'outputDeviceChange', callback: (state: ConnectionState, device: Output ...@@ -3240,9 +3381,9 @@ on(type: 'outputDeviceChange', callback: (state: ConnectionState, device: Output
**示例：** **示例：**
```js ```ts
currentAVSession.on('outputDeviceChange', (state, device) => { currentAVSession.on('outputDeviceChange', (state: avSession.ConnectionState, device: avSession.OutputDeviceInfo) => {
console.info(`on outputDeviceChange device : ${device}`); console.info(`on outputDeviceChange device : ${device}`);
}); });
``` ```
...@@ -3271,9 +3412,22 @@ on(type: 'commonCommand', callback: (command: string, args: {[key: string]: Obje ...@@ -3271,9 +3412,22 @@ on(type: 'commonCommand', callback: (command: string, args: {[key: string]: Obje
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
import avSession from '@ohos.multimedia.avsession';
let currentAVSession: avSession.AVSession;
let tag = "createNewSession";
let context: Context = this.context;
avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
currentAVSession = data;
}
});
currentAVSession.on('commonCommand', (commonCommand, args) => { currentAVSession.on('commonCommand', (commonCommand, args) => {
console.info(`OnCommonCommand, the command is ${commonCommand}, args: ${JSON.stringify(args)}`); console.info(`OnCommonCommand, the command is ${commonCommand}, args: ${JSON.stringify(args)}`);
}); });
``` ```
...@@ -3302,7 +3456,7 @@ off(type: 'play', callback?: () => void): void ...@@ -3302,7 +3456,7 @@ off(type: 'play', callback?: () => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.off('play'); currentAVSession.off('play');
``` ```
...@@ -3331,7 +3485,7 @@ off(type: 'pause', callback?: () => void): void ...@@ -3331,7 +3485,7 @@ off(type: 'pause', callback?: () => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.off('pause'); currentAVSession.off('pause');
``` ```
...@@ -3360,7 +3514,7 @@ off(type: 'stop', callback?: () => void): void ...@@ -3360,7 +3514,7 @@ off(type: 'stop', callback?: () => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.off('stop'); currentAVSession.off('stop');
``` ```
...@@ -3389,7 +3543,7 @@ off(type: 'playNext', callback?: () => void): void ...@@ -3389,7 +3543,7 @@ off(type: 'playNext', callback?: () => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.off('playNext'); currentAVSession.off('playNext');
``` ```
...@@ -3418,7 +3572,7 @@ off(type: 'playPrevious', callback?: () => void): void ...@@ -3418,7 +3572,7 @@ off(type: 'playPrevious', callback?: () => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.off('playPrevious'); currentAVSession.off('playPrevious');
``` ```
...@@ -3447,7 +3601,7 @@ off(type: 'fastForward', callback?: () => void): void ...@@ -3447,7 +3601,7 @@ off(type: 'fastForward', callback?: () => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.off('fastForward'); currentAVSession.off('fastForward');
``` ```
...@@ -3476,7 +3630,7 @@ off(type: 'rewind', callback?: () => void): void ...@@ -3476,7 +3630,7 @@ off(type: 'rewind', callback?: () => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.off('rewind'); currentAVSession.off('rewind');
``` ```
...@@ -3505,7 +3659,7 @@ off(type: 'seek', callback?: (time: number) => void): void ...@@ -3505,7 +3659,7 @@ off(type: 'seek', callback?: (time: number) => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.off('seek'); currentAVSession.off('seek');
``` ```
...@@ -3534,7 +3688,7 @@ off(type: 'setSpeed', callback?: (speed: number) => void): void ...@@ -3534,7 +3688,7 @@ off(type: 'setSpeed', callback?: (speed: number) => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.off('setSpeed'); currentAVSession.off('setSpeed');
``` ```
...@@ -3563,7 +3717,7 @@ off(type: 'setLoopMode', callback?: (mode: LoopMode) => void): void ...@@ -3563,7 +3717,7 @@ off(type: 'setLoopMode', callback?: (mode: LoopMode) => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.off('setLoopMode'); currentAVSession.off('setLoopMode');
``` ```
...@@ -3592,7 +3746,7 @@ off(type: 'toggleFavorite', callback?: (assetId: string) => void): void ...@@ -3592,7 +3746,7 @@ off(type: 'toggleFavorite', callback?: (assetId: string) => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.off('toggleFavorite'); currentAVSession.off('toggleFavorite');
``` ```
...@@ -3621,7 +3775,7 @@ off(type: 'skipToQueueItem', callback?: (itemId: number) => void): void ...@@ -3621,7 +3775,7 @@ off(type: 'skipToQueueItem', callback?: (itemId: number) => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.off('skipToQueueItem'); currentAVSession.off('skipToQueueItem');
``` ```
...@@ -3650,7 +3804,7 @@ off(type: 'handleKeyEvent', callback?: (event: KeyEvent) => void): void ...@@ -3650,7 +3804,7 @@ off(type: 'handleKeyEvent', callback?: (event: KeyEvent) => void): void
**示例：** **示例：**
```js ```ts
currentAVSession.off('handleKeyEvent'); currentAVSession.off('handleKeyEvent');
``` ```
...@@ -3679,7 +3833,7 @@ off(type: 'outputDeviceChange', callback?: (state: ConnectionState, device: Outp ...@@ -3679,7 +3833,7 @@ off(type: 'outputDeviceChange', callback?: (state: ConnectionState, device: Outp
**示例：** **示例：**
```js ```ts
currentAVSession.off('outputDeviceChange'); currentAVSession.off('outputDeviceChange');
``` ```
...@@ -3709,7 +3863,7 @@ off(type: 'commonCommand', callback?: (command: string, args: {[key:string]: Obj ...@@ -3709,7 +3863,7 @@ off(type: 'commonCommand', callback?: (command: string, args: {[key:string]: Obj
**示例：** **示例：**
```js ```ts
currentAVSession.off('commonCommand'); currentAVSession.off('commonCommand');
``` ```
...@@ -3736,13 +3890,15 @@ stopCasting(callback: AsyncCallback\<void>): void ...@@ -3736,13 +3890,15 @@ stopCasting(callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
currentAVSession.stopCasting(function (err) { import { BusinessError } from '@ohos.base';
if (err) {
console.info(`stopCasting BusinessError: code: ${err.code}, message: ${err.message}`); currentAVSession.stopCasting((err: BusinessError) => {
} else { if (err) {
console.info(`stopCasting successfully`); console.info(`stopCasting BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`stopCasting successfully`);
}
}); });
``` ```
...@@ -3769,11 +3925,13 @@ stopCasting(): Promise\<void> ...@@ -3769,11 +3925,13 @@ stopCasting(): Promise\<void>
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
currentAVSession.stopCasting().then(() => { currentAVSession.stopCasting().then(() => {
console.info(`stopCasting successfully`); console.info(`stopCasting successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.info(`stopCasting BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`stopCasting BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -3837,9 +3995,9 @@ setDisplaySurface(surfaceId: string): Promise\<void> ...@@ -3837,9 +3995,9 @@ setDisplaySurface(surfaceId: string): Promise\<void>
| 6600109 | The remote connection is not established. | | 6600109 | The remote connection is not established. |
**示例：** **示例：**
```js ```ts
aVCastController.setDisplaySurface().then(() => { aVCastController.setDisplaySurface().then(() => {
console.info(`setDisplaySurface : SUCCESS :`); console.info(`setDisplaySurface : SUCCESS`);
}); });
``` ```
...@@ -3867,13 +4025,15 @@ setDisplaySurface(surfaceId: string, callback: AsyncCallback\<void>): void ...@@ -3867,13 +4025,15 @@ setDisplaySurface(surfaceId: string, callback: AsyncCallback\<void>): void
| 6600109 | The remote connection is not established. | | 6600109 | The remote connection is not established. |
**示例：** **示例：**
```js ```ts
aVCastController.setDisplaySurface(function (err, value) { import { BusinessError } from '@ohos.base';
if (err) {
console.info(`setDisplaySurface BusinessError: code: ${err.code}, message: ${err.message}`); aVCastController.setDisplaySurface((err: BusinessError) => {
} else { if (err) {
console.info(`setDisplaySurface : SUCCESS : state : ${value}`); console.info(`setDisplaySurface BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`setDisplaySurface : SUCCESS`);
}
}); });
``` ```
...@@ -3900,13 +4060,15 @@ getAVPlaybackState(callback: AsyncCallback\<AVPlaybackState>): void ...@@ -3900,13 +4060,15 @@ getAVPlaybackState(callback: AsyncCallback\<AVPlaybackState>): void
**示例：** **示例：**
```js ```ts
aVCastController.getAVPlaybackState(function (err, state) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`getAVPlaybackState BusinessError: code: ${err.code}, message: ${err.message}`); aVCastController.getAVPlaybackState((err: BusinessError, state: avSession.AVPlaybackState) => {
} else { if (err) {
console.info(`getAVPlaybackState : SUCCESS`); console.error(`getAVPlaybackState BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`getAVPlaybackState : SUCCESS`);
}
}); });
``` ```
...@@ -3933,11 +4095,13 @@ getAVPlaybackState(): Promise\<AVPlaybackState>; ...@@ -3933,11 +4095,13 @@ getAVPlaybackState(): Promise\<AVPlaybackState>;
**示例：** **示例：**
```js ```ts
aVCastController.getAVPlaybackState().then((state) => { import { BusinessError } from '@ohos.base';
console.info(`getAVPlaybackState : SUCCESS :`);
}).catch((err) => { aVCastController.getAVPlaybackState().then((state: avSession.AVPlaybackState) => {
console.error(`getAVPlaybackState BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`getAVPlaybackState : SUCCESS`);
}).catch((err: BusinessError) => {
console.error(`getAVPlaybackState BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -3973,8 +4137,11 @@ sendControlCommand(command: AVCastControlCommand): Promise\<void> ...@@ -3973,8 +4137,11 @@ sendControlCommand(command: AVCastControlCommand): Promise\<void>
**示例：** **示例：**
```js ```ts
let avCommand = {command:'play'}; import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
let avCommand: avSession.AVCastControlCommand = {command:'play'};
// let avCommand = {command:'pause'}; // let avCommand = {command:'pause'};
// let avCommand = {command:'stop'}; // let avCommand = {command:'stop'};
// let avCommand = {command:'playNext'}; // let avCommand = {command:'playNext'};
...@@ -3983,9 +4150,9 @@ let avCommand = {command:'play'}; ...@@ -3983,9 +4150,9 @@ let avCommand = {command:'play'};
// let avCommand = {command:'rewind'}; // let avCommand = {command:'rewind'};
// let avCommand = {command:'seek', parameter:10}; // let avCommand = {command:'seek', parameter:10};
aVCastController.sendControlCommand(avCommand).then(() => { aVCastController.sendControlCommand(avCommand).then(() => {
console.info(`SendControlCommand successfully`); console.info(`SendControlCommand successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`SendControlCommand BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SendControlCommand BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -4016,8 +4183,11 @@ sendControlCommand(command: AVCastControlCommand, callback: AsyncCallback\<void> ...@@ -4016,8 +4183,11 @@ sendControlCommand(command: AVCastControlCommand, callback: AsyncCallback\<void>
**示例：** **示例：**
```js ```ts
let avCommand = {command:'play'}; import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
let avCommand: avSession.AVCastControlCommand = {command:'play'};
// let avCommand = {command:'pause'}; // let avCommand = {command:'pause'};
// let avCommand = {command:'stop'}; // let avCommand = {command:'stop'};
// let avCommand = {command:'playNext'}; // let avCommand = {command:'playNext'};
...@@ -4025,12 +4195,12 @@ let avCommand = {command:'play'}; ...@@ -4025,12 +4195,12 @@ let avCommand = {command:'play'};
// let avCommand = {command:'fastForward'}; // let avCommand = {command:'fastForward'};
// let avCommand = {command:'rewind'}; // let avCommand = {command:'rewind'};
// let avCommand = {command:'seek', parameter:10}; // let avCommand = {command:'seek', parameter:10};
aVCastController.sendControlCommand(avCommand, function (err) { aVCastController.sendControlCommand(avCommand, (err: BusinessError) => {
if (err) { if (err) {
console.error(`SendControlCommand BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SendControlCommand BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
console.info(`SendControlCommand successfully`); console.info(`SendControlCommand successfully`);
} }
}); });
``` ```
...@@ -4047,7 +4217,7 @@ prepare(item: AVQueueItem, callback: AsyncCallback\<void>): void ...@@ -4047,7 +4217,7 @@ prepare(item: AVQueueItem, callback: AsyncCallback\<void>): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------------- | ---- | ------------------------------ | | ------- | ------------------------------------- | ---- | ------------------------------ |
| item | [AVQueueItem](#avqueueitem10) | 是 | 播放列表中单项的相关属性。 | | item | [AVQueueItem](#avqueueitem10) | 是 | 播放列表中单项的相关属性。 |
| callback | AsyncCallback\<void> | 是 | 回调函数。当命令发送成功，err为undefined，否则返回错误对象。 | callback | AsyncCallback\<void> | 是 | 回调函数。当命令发送成功，err为undefined，否则返回错误对象。 |
**错误码：** **错误码：**
以下错误码的详细介绍请参见[媒体会话管理错误码](../errorcodes/errorcode-avsession.md)。 以下错误码的详细介绍请参见[媒体会话管理错误码](../errorcodes/errorcode-avsession.md)。
...@@ -4058,13 +4228,15 @@ prepare(item: AVQueueItem, callback: AsyncCallback\<void>): void ...@@ -4058,13 +4228,15 @@ prepare(item: AVQueueItem, callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
// 设置播放参数，开始播放 // 设置播放参数，开始播放
var playItem = { let playItem: avSession.AVQueueItem = {
itemId: 0, itemId: 0,
description: { description: {
mediaId: '12345', assetId: '12345',
mediaName: 'song1',
mediaType: 'AUDIO', mediaType: 'AUDIO',
mediaUri: 'http://resource1_address', mediaUri: 'http://resource1_address',
mediaSize: 12345, mediaSize: 12345,
...@@ -4074,13 +4246,16 @@ var playItem = { ...@@ -4074,13 +4246,16 @@ var playItem = {
albumTitle: 'song1_title', albumTitle: 'song1_title',
albumCoverUri: "http://resource1_album_address", albumCoverUri: "http://resource1_album_address",
lyricUri: "http://resource1_lyric_address", lyricUri: "http://resource1_lyric_address",
iconUri: "http://resource1_icon_address",
appName: 'MyMusic' appName: 'MyMusic'
} }
}; };
// 准备播放，这个不会触发真正的播放，会进行加载和缓冲 // 准备播放，这个不会触发真正的播放，会进行加载和缓冲
aVCastController.prepare(playItem, () => { aVCastController.prepare(playItem, (err: BusinessError) => {
console.info('prepare done'); if (err) {
console.error(`prepare BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
console.info(`prepare successfully`);
}
}); });
``` ```
...@@ -4116,29 +4291,32 @@ prepare(item: AVQueueItem): Promise\<void> ...@@ -4116,29 +4291,32 @@ prepare(item: AVQueueItem): Promise\<void>
**示例：** **示例：**
```js ```ts
import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
// 设置播放参数，开始播放 // 设置播放参数，开始播放
var playItem = { let playItem: avSession.AVQueueItem = {
itemId: 0, itemId: 0,
description: { description: {
mediaId: '12345', assetId: '12345',
mediaName: 'song1', mediaType: 'AUDIO',
mediaType: 'AUDIO', mediaUri: 'http://resource1_address',
mediaUri: 'http://resource1_address', mediaSize: 12345,
mediaSize: 12345, startPosition: 0,
startPosition: 0, duration: 0,
duration: 0, artist: 'mysong',
artist: 'mysong', albumTitle: 'song1_title',
albumTitle: 'song1_title', albumCoverUri: "http://resource1_album_address",
albumCoverUri: "http://resource1_album_address", lyricUri: "http://resource1_lyric_address",
lyricUri: "http://resource1_lyric_address", appName: 'MyMusic'
iconUri: "http://resource1_icon_address", }
appName: 'MyMusic'
}
}; };
// 准备播放，这个不会触发真正的播放，会进行加载和缓冲 // 准备播放，这个不会触发真正的播放，会进行加载和缓冲
aVCastController.prepare(playItem, () => { aVCastController.prepare(playItem).then(() => {
console.info('prepare done'); console.info(`prepare successfully`);
}).catch((err: BusinessError) => {
console.error(`prepare BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -4155,7 +4333,7 @@ start(item: AVQueueItem, callback: AsyncCallback\<void>): void ...@@ -4155,7 +4333,7 @@ start(item: AVQueueItem, callback: AsyncCallback\<void>): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------------- | ---- | ------------------------------ | | ------- | ------------------------------------- | ---- | ------------------------------ |
| item | [AVQueueItem](#avqueueitem10) | 是 | 播放列表中单项的相关属性。 | | item | [AVQueueItem](#avqueueitem10) | 是 | 播放列表中单项的相关属性。 |
| callback | AsyncCallback\<void> | 是 | 回调函数。当命令发送成功，err为undefined，否则返回错误对象。 | callback | AsyncCallback\<void> | 是 | 回调函数。当命令发送成功，err为undefined，否则返回错误对象。 |
**错误码：** **错误码：**
以下错误码的详细介绍请参见[媒体会话管理错误码](../errorcodes/errorcode-avsession.md)。 以下错误码的详细介绍请参见[媒体会话管理错误码](../errorcodes/errorcode-avsession.md)。
...@@ -4166,30 +4344,35 @@ start(item: AVQueueItem, callback: AsyncCallback\<void>): void ...@@ -4166,30 +4344,35 @@ start(item: AVQueueItem, callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
// 设置播放参数，开始播放 // 设置播放参数，开始播放
var playItem = { let playItem: avSession.AVQueueItem = {
itemId: 0, itemId: 0,
description: { description: {
mediaId: '12345', assetId: '12345',
mediaName: 'song1', mediaType: 'AUDIO',
mediaType: 'AUDIO', mediaUri: 'http://resource1_address',
mediaUri: 'http://resource1_address', mediaSize: 12345,
mediaSize: 12345, startPosition: 0,
startPosition: 0, duration: 0,
duration: 0, artist: 'mysong',
artist: 'mysong', albumTitle: 'song1_title',
albumTitle: 'song1_title', albumCoverUri: "http://resource1_album_address",
albumCoverUri: "http://resource1_album_address", lyricUri: "http://resource1_lyric_address",
lyricUri: "http://resource1_lyric_address", appName: 'MyMusic'
iconUri: "http://resource1_icon_address", }
appName: 'MyMusic'
}
}; };
// 启动播放 // 启动播放
aVCastController.start(playItem, () => { aVCastController.start(playItem, (err: BusinessError) => {
console.info('play done'); if (err) {
console.error(`start BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
console.info(`start successfully`);
}
}); });
``` ```
...@@ -4224,13 +4407,15 @@ start(item: AVQueueItem): Promise\<void> ...@@ -4224,13 +4407,15 @@ start(item: AVQueueItem): Promise\<void>
**示例：** **示例：**
```js ```ts
import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
// 设置播放参数，开始播放 // 设置播放参数，开始播放
var playItem = { let playItem: avSession.AVQueueItem = {
itemId: 0, itemId: 0,
description: { description: {
mediaId: '12345', assetId: '12345',
mediaName: 'song1',
mediaType: 'AUDIO', mediaType: 'AUDIO',
mediaUri: 'http://resource1_address', mediaUri: 'http://resource1_address',
mediaSize: 12345, mediaSize: 12345,
...@@ -4240,15 +4425,14 @@ description: { ...@@ -4240,15 +4425,14 @@ description: {
albumTitle: 'song1_title', albumTitle: 'song1_title',
albumCoverUri: "http://resource1_album_address", albumCoverUri: "http://resource1_album_address",
lyricUri: "http://resource1_lyric_address", lyricUri: "http://resource1_lyric_address",
iconUri: "http://resource1_icon_address",
appName: 'MyMusic' appName: 'MyMusic'
} }
}; };
// 启动播放 // 启动播放
aVCastController.start(playItem).then(() => { aVCastController.start(playItem).then(() => {
console.info(`start successfully`); console.info(`start successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.info(`start BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`start BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -4275,13 +4459,15 @@ getCurrentItem(callback: AsyncCallback\<AVQueueItem>): void ...@@ -4275,13 +4459,15 @@ getCurrentItem(callback: AsyncCallback\<AVQueueItem>): void
**示例：** **示例：**
```js ```ts
aVCastController.getCurrentItem(function (err, value) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`getCurrentItem BusinessError: code: ${err.code}, message: ${err.message}`); aVCastController.getCurrentItem((err: BusinessError, value: avSession.AVQueueItem) => {
} else { if (err) {
console.info(`getCurrentItem successfully`); console.error(`getCurrentItem BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`getCurrentItem successfully`);
}
}); });
``` ```
...@@ -4308,12 +4494,15 @@ getCurrentItem(): Promise\<AVQueueItem> ...@@ -4308,12 +4494,15 @@ getCurrentItem(): Promise\<AVQueueItem>
**示例：** **示例：**
```js ```ts
aVCastController.getCurrentItem().then((AVQueueItem) => { import { BusinessError } from '@ohos.base';
console.info(`getCurrentItem successfully`);
}).catch((err) => { aVCastController.getCurrentItem().then((value: avSession.AVQueueItem) => {
console.error(`getCurrentItem BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`getCurrentItem successfully`);
}).catch((err: BusinessError) => {
console.error(`getCurrentItem BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
### on('playbackStateChange')<sup>10+</sup> ### on('playbackStateChange')<sup>10+</sup>
...@@ -4341,14 +4530,14 @@ on(type: 'playbackStateChange', filter: Array\<keyof AVPlaybackState> | 'all', c ...@@ -4341,14 +4530,14 @@ on(type: 'playbackStateChange', filter: Array\<keyof AVPlaybackState> | 'all', c
**示例：** **示例：**
```js ```ts
aVCastController.on('playbackStateChange', 'all', (playbackState) => { aVCastController.on('playbackStateChange', 'all', (playbackState: avSession.AVPlaybackState) => {
console.info(`on playbackStateChange state : ${playbackState.state}`); console.info(`on playbackStateChange state : ${playbackState.state}`);
}); });
let playbackFilter = ['state', 'speed', 'loopMode']; let playbackFilter = ['state', 'speed', 'loopMode'];
aVCastController.on('playbackStateChange', playbackFilter, (playbackState) => { aVCastController.on('playbackStateChange', playbackFilter, (playbackState: avSession.AVPlaybackState) => {
console.info(`on playbackStateChange state : ${playbackState.state}`); console.info(`on playbackStateChange state : ${playbackState.state}`);
}); });
``` ```
...@@ -4376,7 +4565,7 @@ off(type: 'playbackStateChange', callback?: (state: AVPlaybackState) => void): v ...@@ -4376,7 +4565,7 @@ off(type: 'playbackStateChange', callback?: (state: AVPlaybackState) => void): v
**示例：** **示例：**
```js ```ts
aVCastController.off('playbackStateChange'); aVCastController.off('playbackStateChange');
``` ```
...@@ -4404,9 +4593,9 @@ on(type: 'mediaItemChange', callback: Callback\<AVQueueItem>): void ...@@ -4404,9 +4593,9 @@ on(type: 'mediaItemChange', callback: Callback\<AVQueueItem>): void
**示例：** **示例：**
```js ```ts
aVCastController.on('mediaItemChange', (item) => { aVCastController.on('mediaItemChange', (item: avSession.AVQueueItem) => {
console.info(`on mediaItemChange state : ${item.itemId}`); console.info(`on mediaItemChange state : ${item.itemId}`);
}); });
``` ```
...@@ -4433,7 +4622,7 @@ off(type: 'mediaItemChange'): void ...@@ -4433,7 +4622,7 @@ off(type: 'mediaItemChange'): void
**示例：** **示例：**
```js ```ts
aVCastController.off('mediaItemChange'); aVCastController.off('mediaItemChange');
``` ```
...@@ -4461,9 +4650,9 @@ on(type: 'playNext', callback: Callback\<void>): void ...@@ -4461,9 +4650,9 @@ on(type: 'playNext', callback: Callback\<void>): void
**示例：** **示例：**
```js ```ts
aVCastController.on('playNext', () => { aVCastController.on('playNext', () => {
console.info(`on playNext`); console.info(`on playNext`);
}); });
``` ```
...@@ -4490,7 +4679,7 @@ off(type: 'playNext'): void ...@@ -4490,7 +4679,7 @@ off(type: 'playNext'): void
**示例：** **示例：**
```js ```ts
aVCastController.off('playNext'); aVCastController.off('playNext');
``` ```
...@@ -4518,9 +4707,9 @@ on(type: 'playPrevious', callback: Callback\<void>): void ...@@ -4518,9 +4707,9 @@ on(type: 'playPrevious', callback: Callback\<void>): void
**示例：** **示例：**
```js ```ts
aVCastController.on('playPrevious', () => { aVCastController.on('playPrevious', () => {
console.info(`on playPrevious`); console.info(`on playPrevious`);
}); });
``` ```
...@@ -4547,7 +4736,7 @@ off(type: 'playPrevious'): void ...@@ -4547,7 +4736,7 @@ off(type: 'playPrevious'): void
**示例：** **示例：**
```js ```ts
aVCastController.off('playPrevious'); aVCastController.off('playPrevious');
``` ```
...@@ -4575,9 +4764,9 @@ on(type: 'seekDone', callback: Callback\<number>): void ...@@ -4575,9 +4764,9 @@ on(type: 'seekDone', callback: Callback\<number>): void
**示例：** **示例：**
```js ```ts
aVCastController.on('seekDone', (pos) => { aVCastController.on('seekDone', (pos: number) => {
console.info(`on seekDone pos：${pos} `); console.info(`on seekDone pos：${pos} `);
}); });
``` ```
...@@ -4604,7 +4793,7 @@ off(type: 'seekDone'): void ...@@ -4604,7 +4793,7 @@ off(type: 'seekDone'): void
**示例：** **示例：**
```js ```ts
aVCastController.off('seekDone'); aVCastController.off('seekDone');
``` ```
...@@ -4626,10 +4815,10 @@ on(type: 'videoSizeChange', callback: (width:number, height:number) => void): vo ...@@ -4626,10 +4815,10 @@ on(type: 'videoSizeChange', callback: (width:number, height:number) => void): vo
**示例：** **示例：**
```js ```ts
aVCastController.on('videoSizeChange', (width, height) => { aVCastController.on('videoSizeChange', (width: number, height: number) => {
console.info(`width ：${width} `); console.info(`width ：${width} `);
console.info(`height：${height} `); console.info(`height：${height} `);
}); });
``` ```
...@@ -4650,7 +4839,7 @@ off(type: 'videoSizeChange'): void ...@@ -4650,7 +4839,7 @@ off(type: 'videoSizeChange'): void
**示例：** **示例：**
```js ```ts
aVCastController.off('videoSizeChange'); aVCastController.off('videoSizeChange');
``` ```
...@@ -4684,8 +4873,10 @@ on(type: 'error', callback: ErrorCallback): void ...@@ -4684,8 +4873,10 @@ on(type: 'error', callback: ErrorCallback): void
**示例：** **示例：**
```js ```ts
aVCastController.on('error', (error) => { import { BusinessError } from '@ohos.base'
aVCastController.on('error', (error: BusinessError) => {
console.error('error happened,and error message is :' + error.message) console.error('error happened,and error message is :' + error.message)
console.error('error happened,and error code is :' + error.code) console.error('error happened,and error code is :' + error.code)
}) })
...@@ -4720,7 +4911,7 @@ off(type: 'error'): void ...@@ -4720,7 +4911,7 @@ off(type: 'error'): void
**示例：** **示例：**
```js ```ts
aVCastController.off('error') aVCastController.off('error')
``` ```
...@@ -4942,12 +5133,14 @@ aVCastController.off('error') ...@@ -4942,12 +5133,14 @@ aVCastController.off('error')
**示例：** **示例：**
```js ```ts
let AVSessionController; import { BusinessError } from '@ohos.base';
avSession.createController(currentAVSession.sessionId).then((controller) => {
AVSessionController = controller; let AVSessionController: avSession.AVSessionController;
}).catch((err) => { avSession.createController(currentAVSession.sessionId).then((controller: avSession.AVSessionController) => {
console.error(`CreateController BusinessError: code: ${err.code}, message: ${err.message}`); AVSessionController = controller;
}).catch((err: BusinessError) => {
console.error(`CreateController BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -4976,13 +5169,15 @@ getAVPlaybackState(callback: AsyncCallback\<AVPlaybackState>): void ...@@ -4976,13 +5169,15 @@ getAVPlaybackState(callback: AsyncCallback\<AVPlaybackState>): void
**示例：** **示例：**
```js ```ts
avsessionController.getAVPlaybackState(function (err, state) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`getAVPlaybackState BusinessError: code: ${err.code}, message: ${err.message}`); avsessionController.getAVPlaybackState((err: BusinessError, state: avSession.AVPlaybackState) => {
} else { if (err) {
console.info(`getAVPlaybackState : SUCCESS`); console.error(`getAVPlaybackState BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`getAVPlaybackState : SUCCESS`);
}
}); });
``` ```
...@@ -5011,11 +5206,13 @@ getAVPlaybackState(): Promise\<AVPlaybackState>; ...@@ -5011,11 +5206,13 @@ getAVPlaybackState(): Promise\<AVPlaybackState>;
**示例：** **示例：**
```js ```ts
avsessionController.getAVPlaybackState().then((state) => { import { BusinessError } from '@ohos.base';
console.info(`getAVPlaybackState : SUCCESS :`);
}).catch((err) => { avsessionController.getAVPlaybackState().then((state: avSession.AVPlaybackState) => {
console.error(`getAVPlaybackState BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`getAVPlaybackState : SUCCESS`);
}).catch((err: BusinessError) => {
console.error(`getAVPlaybackState BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -5043,11 +5240,13 @@ getAVMetadata(): Promise\<AVMetadata> ...@@ -5043,11 +5240,13 @@ getAVMetadata(): Promise\<AVMetadata>
| 6600103 | The session controller does not exist. | | 6600103 | The session controller does not exist. |
**示例：** **示例：**
```js ```ts
avsessionController.getAVMetadata().then((metadata) => { import { BusinessError } from '@ohos.base';
console.info(`GetAVMetadata : SUCCESS : assetId : ${metadata.assetId}`);
}).catch((err) => { avsessionController.getAVMetadata().then((metadata: avSession.AVMetadata) => {
console.error(`GetAVMetadata BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`GetAVMetadata : SUCCESS : assetId : ${metadata.assetId}`);
}).catch((err: BusinessError) => {
console.error(`GetAVMetadata BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -5075,13 +5274,15 @@ getAVMetadata(callback: AsyncCallback\<AVMetadata>): void ...@@ -5075,13 +5274,15 @@ getAVMetadata(callback: AsyncCallback\<AVMetadata>): void
| 6600103 | The session controller does not exist. | | 6600103 | The session controller does not exist. |
**示例：** **示例：**
```js ```ts
avsessionController.getAVMetadata(function (err, metadata) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`GetAVMetadata BusinessError: code: ${err.code}, message: ${err.message}`); avsessionController.getAVMetadata((err: BusinessError, metadata: avSession.AVMetadata) => {
} else { if (err) {
console.info(`GetAVMetadata : SUCCESS : assetId : ${metadata.assetId}`); console.error(`GetAVMetadata BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`GetAVMetadata : SUCCESS : assetId : ${metadata.assetId}`);
}
}); });
``` ```
...@@ -5109,11 +5310,13 @@ getAVQueueTitle(): Promise\<string> ...@@ -5109,11 +5310,13 @@ getAVQueueTitle(): Promise\<string>
| 6600103 | The session controller does not exist. | | 6600103 | The session controller does not exist. |
**示例：** **示例：**
```js ```ts
avsessionController.getAVQueueTitle().then((title) => { import { BusinessError } from '@ohos.base';
console.info(`GetAVQueueTitle : SUCCESS : title : ${title}`);
}).catch((err) => { avsessionController.getAVQueueTitle().then((title: string) => {
console.error(`GetAVQueueTitle BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`GetAVQueueTitle : SUCCESS : title : ${title}`);
}).catch((err: BusinessError) => {
console.error(`GetAVQueueTitle BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -5141,13 +5344,15 @@ getAVQueueTitle(callback: AsyncCallback\<string>): void ...@@ -5141,13 +5344,15 @@ getAVQueueTitle(callback: AsyncCallback\<string>): void
| 6600103 | The session controller does not exist. | | 6600103 | The session controller does not exist. |
**示例：** **示例：**
```js ```ts
avsessionController.getAVQueueTitle(function (err, title) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`GetAVQueueTitle BusinessError: code: ${err.code}, message: ${err.message}`); avsessionController.getAVQueueTitle((err: BusinessError, title: string) => {
} else { if (err) {
console.info(`GetAVQueueTitle : SUCCESS : title : ${title}`); console.error(`GetAVQueueTitle BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`GetAVQueueTitle : SUCCESS : title : ${title}`);
}
}); });
``` ```
...@@ -5175,11 +5380,13 @@ getAVQueueItems(): Promise\<Array\<AVQueueItem>> ...@@ -5175,11 +5380,13 @@ getAVQueueItems(): Promise\<Array\<AVQueueItem>>
| 6600103 | The session controller does not exist. | | 6600103 | The session controller does not exist. |
**示例：** **示例：**
```js ```ts
avsessionController.getAVQueueItems().then((items) => { import { BusinessError } from '@ohos.base';
console.info(`GetAVQueueItems : SUCCESS : length : ${items.length}`);
}).catch((err) => { avsessionController.getAVQueueItems().then((items: avSession.AVQueueItem[]) => {
console.error(`GetAVQueueItems BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`GetAVQueueItems : SUCCESS : length : ${items.length}`);
}).catch((err: BusinessError) => {
console.error(`GetAVQueueItems BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -5207,13 +5414,15 @@ getAVQueueItems(callback: AsyncCallback\<Array\<AVQueueItem>>): void ...@@ -5207,13 +5414,15 @@ getAVQueueItems(callback: AsyncCallback\<Array\<AVQueueItem>>): void
| 6600103 | The session controller does not exist. | | 6600103 | The session controller does not exist. |
**示例：** **示例：**
```js ```ts
avsessionController.getAVQueueItems(function (err, items) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`GetAVQueueItems BusinessError: code: ${err.code}, message: ${err.message}`); avsessionController.getAVQueueItems((err: BusinessError, items: avSession.AVQueueItem[]) => {
} else { if (err) {
console.info(`GetAVQueueItems : SUCCESS : length : ${items.length}`); console.error(`GetAVQueueItems BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`GetAVQueueItems : SUCCESS : length : ${items.length}`);
}
}); });
``` ```
...@@ -5248,12 +5457,14 @@ skipToQueueItem(itemId: number): Promise\<void> ...@@ -5248,12 +5457,14 @@ skipToQueueItem(itemId: number): Promise\<void>
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
let queueItemId = 0; let queueItemId = 0;
avsessionController.skipToQueueItem(queueItemId).then(() => { avsessionController.skipToQueueItem(queueItemId).then(() => {
console.info(`SkipToQueueItem successfully`); console.info(`SkipToQueueItem successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`SkipToQueueItem BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SkipToQueueItem BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -5283,14 +5494,16 @@ skipToQueueItem(itemId: number, callback: AsyncCallback\<void>): void ...@@ -5283,14 +5494,16 @@ skipToQueueItem(itemId: number, callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
let queueItemId = 0; let queueItemId = 0;
avsessionController.skipToQueueItem(queueItemId, function (err) { avsessionController.skipToQueueItem(queueItemId, (err: BusinessError) => {
if (err) { if (err) {
console.error(`SkipToQueueItem BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SkipToQueueItem BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
console.info(`SkipToQueueItem successfully`); console.info(`SkipToQueueItem successfully`);
} }
}); });
``` ```
...@@ -5318,11 +5531,13 @@ getOutputDevice(): Promise\<OutputDeviceInfo> ...@@ -5318,11 +5531,13 @@ getOutputDevice(): Promise\<OutputDeviceInfo>
| 600103 | The session controller does not exist. | | 600103 | The session controller does not exist. |
**示例：** **示例：**
```js ```ts
avsessionController.getOutputDevice().then((deviceInfo) => { import { BusinessError } from '@ohos.base';
console.info(`GetOutputDevice : SUCCESS : isRemote : ${deviceInfo.isRemote}`);
}).catch((err) => { avsessionController.getOutputDevice().then((deviceInfo: avSession.OutputDeviceInfo) => {
console.error(`GetOutputDevice BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`GetOutputDevice : SUCCESS`);
}).catch((err: BusinessError) => {
console.error(`GetOutputDevice BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -5350,13 +5565,15 @@ getOutputDevice(callback: AsyncCallback\<OutputDeviceInfo>): void ...@@ -5350,13 +5565,15 @@ getOutputDevice(callback: AsyncCallback\<OutputDeviceInfo>): void
**示例：** **示例：**
```js ```ts
avsessionController.getOutputDevice(function (err, deviceInfo) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`GetOutputDevice BusinessError: code: ${err.code}, message: ${err.message}`); avsessionController.getOutputDevice((err: BusinessError, deviceInfo: avSession.OutputDeviceInfo) => {
} else { if (err) {
console.info(`GetOutputDevice : SUCCESS : isRemote : ${deviceInfo.isRemote}`); console.error(`GetOutputDevice BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`GetOutputDevice : SUCCESS`);
}
}); });
``` ```
...@@ -5393,14 +5610,17 @@ sendAVKeyEvent(event: KeyEvent): Promise\<void> ...@@ -5393,14 +5610,17 @@ sendAVKeyEvent(event: KeyEvent): Promise\<void>
**示例：** **示例：**
```js ```ts
let keyItem = {code:0x49, pressedTime:2, deviceId:0}; import keyEvent from '@ohos.multimodalInput.keyEvent';
let event = {action:2, key:keyItem, keys:[keyItem]}; import { BusinessError } from '@ohos.base';
let keyItem: keyEvent.Key = {code:0x49, pressedTime:2, deviceId:0};
let event: keyEvent.KeyEvent = {id:1, deviceId:0, actionTime:1, screenId:1, windowId:1, action:2, key:keyItem, unicodeChar:0, keys:[keyItem], ctrlKey:false, altKey:false, shiftKey:false, logoKey:false, fnKey:false, capsLock:false, numLock:false, scrollLock:false};
avsessionController.sendAVKeyEvent(event).then(() => { avsessionController.sendAVKeyEvent(event).then(() => {
console.info(`SendAVKeyEvent Successfully`); console.info(`SendAVKeyEvent Successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`SendAVKeyEvent BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SendAVKeyEvent BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -5432,16 +5652,19 @@ sendAVKeyEvent(event: KeyEvent, callback: AsyncCallback\<void>): void ...@@ -5432,16 +5652,19 @@ sendAVKeyEvent(event: KeyEvent, callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
let keyItem = {code:0x49, pressedTime:2, deviceId:0}; import keyEvent from '@ohos.multimodalInput.keyEvent';
let event = {action:2, key:keyItem, keys:[keyItem]}; import { BusinessError } from '@ohos.base';
avsessionController.sendAVKeyEvent(event, function (err) { let keyItem: keyEvent.Key = {code:0x49, pressedTime:2, deviceId:0};
if (err) { let event: keyEvent.KeyEvent = {id:1, deviceId:0, actionTime:1, screenId:1, windowId:1, action:2, key:keyItem, unicodeChar:0, keys:[keyItem], ctrlKey:false, altKey:false, shiftKey:false, logoKey:false, fnKey:false, capsLock:false, numLock:false, scrollLock:false};
console.error(`SendAVKeyEvent BusinessError: code: ${err.code}, message: ${err.message}`);
} else { avsessionController.sendAVKeyEvent(event, (err: BusinessError) => {
console.info(`SendAVKeyEvent Successfully`); if (err) {
} console.error(`SendAVKeyEvent BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
console.info(`SendAVKeyEvent Successfully`);
}
}); });
``` ```
...@@ -5470,11 +5693,13 @@ getLaunchAbility(): Promise\<WantAgent> ...@@ -5470,11 +5693,13 @@ getLaunchAbility(): Promise\<WantAgent>
**示例：** **示例：**
```js ```ts
avsessionController.getLaunchAbility().then((agent) => { import { BusinessError } from '@ohos.base';
console.info(`GetLaunchAbility : SUCCESS : wantAgent : ${agent}`);
}).catch((err) => { avsessionController.getLaunchAbility().then((agent: object) => {
console.error(`GetLaunchAbility BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`GetLaunchAbility : SUCCESS : wantAgent : ${agent}`);
}).catch((err: BusinessError) => {
console.error(`GetLaunchAbility BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -5503,13 +5728,15 @@ getLaunchAbility(callback: AsyncCallback\<WantAgent>): void ...@@ -5503,13 +5728,15 @@ getLaunchAbility(callback: AsyncCallback\<WantAgent>): void
**示例：** **示例：**
```js ```ts
avsessionController.getLaunchAbility(function (err, agent) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`GetLaunchAbility BusinessError: code: ${err.code}, message: ${err.message}`); avsessionController.getLaunchAbility((err: BusinessError, agent: object) => {
} else { if (err) {
console.info(`GetLaunchAbility : SUCCESS : wantAgent : ${agent}`); console.error(`GetLaunchAbility BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`GetLaunchAbility : SUCCESS : wantAgent : ${agent}`);
}
}); });
``` ```
...@@ -5537,8 +5764,8 @@ getRealPlaybackPositionSync(): number ...@@ -5537,8 +5764,8 @@ getRealPlaybackPositionSync(): number
**示例：** **示例：**
```js ```ts
let time = avsessionController.getRealPlaybackPositionSync(); let time: number = avsessionController.getRealPlaybackPositionSync();
``` ```
### isActive<sup>10+</sup> ### isActive<sup>10+</sup>
...@@ -5566,11 +5793,13 @@ isActive(): Promise\<boolean> ...@@ -5566,11 +5793,13 @@ isActive(): Promise\<boolean>
**示例：** **示例：**
```js ```ts
avsessionController.isActive().then((isActive) => { import { BusinessError } from '@ohos.base';
console.info(`IsActive : SUCCESS : isactive : ${isActive}`);
}).catch((err) => { avsessionController.isActive().then((isActive: boolean) => {
console.error(`IsActive BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`IsActive : SUCCESS : isactive : ${isActive}`);
}).catch((err: BusinessError) => {
console.error(`IsActive BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -5599,13 +5828,15 @@ isActive(callback: AsyncCallback\<boolean>): void ...@@ -5599,13 +5828,15 @@ isActive(callback: AsyncCallback\<boolean>): void
**示例：** **示例：**
```js ```ts
avsessionController.isActive(function (err, isActive) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`IsActive BusinessError: code: ${err.code}, message: ${err.message}`); avsessionController.isActive((err: BusinessError, isActive: boolean) => {
} else { if (err) {
console.info(`IsActive : SUCCESS : isactive : ${isActive}`); console.error(`IsActive BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`IsActive : SUCCESS : isactive : ${isActive}`);
}
}); });
``` ```
...@@ -5633,11 +5864,13 @@ destroy(): Promise\<void> ...@@ -5633,11 +5864,13 @@ destroy(): Promise\<void>
**示例：** **示例：**
```js ```ts
import { BusinessError } from '@ohos.base';
avsessionController.destroy().then(() => { avsessionController.destroy().then(() => {
console.info(`Destroy : SUCCESS `); console.info(`Destroy : SUCCESS `);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`Destroy BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`Destroy BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -5665,13 +5898,15 @@ destroy(callback: AsyncCallback\<void>): void ...@@ -5665,13 +5898,15 @@ destroy(callback: AsyncCallback\<void>): void
**示例：** **示例：**
```js ```ts
avsessionController.destroy(function (err) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`Destroy BusinessError: code: ${err.code}, message: ${err.message}`); avsessionController.destroy((err: BusinessError) => {
} else { if (err) {
console.info(`Destroy : SUCCESS `); console.error(`Destroy BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`Destroy : SUCCESS `);
}
}); });
``` ```
...@@ -5700,11 +5935,13 @@ getValidCommands(): Promise\<Array\<AVControlCommandType>> ...@@ -5700,11 +5935,13 @@ getValidCommands(): Promise\<Array\<AVControlCommandType>>
**示例：** **示例：**
```js ```ts
avsessionController.getValidCommands.then((validCommands) => { import { BusinessError } from '@ohos.base';
console.info(`GetValidCommands : SUCCESS : size : ${validCommands.length}`);
}).catch((err) => { avsessionController.getValidCommands.then((validCommands: avSession.AVControlCommandType[]) => {
console.error(`GetValidCommands BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`GetValidCommands : SUCCESS : size : ${validCommands.length}`);
}).catch((err: BusinessError) => {
console.error(`GetValidCommands BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -5733,13 +5970,15 @@ getValidCommands(callback: AsyncCallback\<Array\<AVControlCommandType>>): void ...@@ -5733,13 +5970,15 @@ getValidCommands(callback: AsyncCallback\<Array\<AVControlCommandType>>): void
**示例：** **示例：**
```js ```ts
avsessionController.getValidCommands(function (err, validCommands) { import { BusinessError } from '@ohos.base';
if (err) {
console.error(`GetValidCommands BusinessError: code: ${err.code}, message: ${err.message}`); avsessionController.getValidCommands((err: BusinessError, validCommands: avSession.AVControlCommandType[]) => {
} else { if (err) {
console.info(`GetValidCommands : SUCCESS : size : ${validCommands.length}`); console.error(`GetValidCommands BusinessError: code: ${err.code}, message: ${err.message}`);
} } else {
console.info(`GetValidCommands : SUCCESS : size : ${validCommands.length}`);
}
}); });
``` ```
...@@ -5781,8 +6020,11 @@ sendControlCommand(command: AVControlCommand): Promise\<void> ...@@ -5781,8 +6020,11 @@ sendControlCommand(command: AVControlCommand): Promise\<void>
**示例：** **示例：**
```js ```ts
let avCommand = {command:'play'}; import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
let avCommand: avSession.AVControlCommand = {command:'play'};
// let avCommand = {command:'pause'}; // let avCommand = {command:'pause'};
// let avCommand = {command:'stop'}; // let avCommand = {command:'stop'};
// let avCommand = {command:'playNext'}; // let avCommand = {command:'playNext'};
...@@ -5794,9 +6036,9 @@ let avCommand = {command:'play'}; ...@@ -5794,9 +6036,9 @@ let avCommand = {command:'play'};
// let avCommand = {command:'setLoopMode', parameter:avSession.LoopMode.LOOP_MODE_SINGLE}; // let avCommand = {command:'setLoopMode', parameter:avSession.LoopMode.LOOP_MODE_SINGLE};
// let avCommand = {command:'toggleFavorite', parameter:"false"}; // let avCommand = {command:'toggleFavorite', parameter:"false"};
avsessionController.sendControlCommand(avCommand).then(() => { avsessionController.sendControlCommand(avCommand).then(() => {
console.info(`SendControlCommand successfully`); console.info(`SendControlCommand successfully`);
}).catch((err) => { }).catch((err: BusinessError) => {
console.error(`SendControlCommand BusinessError: code: ${err.code}, message: ${err.message}`); console.error(`SendControlCommand BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -5833,8 +6075,11 @@ sendControlCommand(command: AVControlCommand, callback: AsyncCallback\<void>): v ...@@ -5833,8 +6075,11 @@ sendControlCommand(command: AVControlCommand, callback: AsyncCallback\<void>): v
**示例：** **示例：**
```js ```ts
let avCommand = {command:'play'}; import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
let avCommand: avSession.AVControlCommand = {command:'play'};
// let avCommand = {command:'pause'}; // let avCommand = {command:'pause'};
// let avCommand = {command:'stop'}; // let avCommand = {command:'stop'};
// let avCommand = {command:'playNext'}; // let avCommand = {command:'playNext'};
...@@ -5845,12 +6090,12 @@ let avCommand = {command:'play'}; ...@@ -5845,12 +6090,12 @@ let avCommand = {command:'play'};
// let avCommand = {command:'setSpeed', parameter:2.6}; // let avCommand = {command:'setSpeed', parameter:2.6};
// let avCommand = {command:'setLoopMode', parameter:avSession.LoopMode.LOOP_MODE_SINGLE}; // let avCommand = {command:'setLoopMode', parameter:avSession.LoopMode.LOOP_MODE_SINGLE};
// let avCommand = {command:'toggleFavorite', parameter:"false"}; // let avCommand = {command:'toggleFavorite', parameter:"false"};
avsessionController.sendControlCommand(avCommand, function (err) { avsessionController.sendControlCommand(avCommand, (err: BusinessError) => {
if (err) { if (err) {
console.info(`SendControlCommand BusinessError: code: ${err.code}, message: ${err.message}`); console.info(`SendControlCommand BusinessError: code: ${err.code}, message: ${err.message}`);
} else { } else {
console.error(`SendControlCommand successfully`); console.error(`SendControlCommand successfully`);
} }
}); });
``` ```
...@@ -5892,13 +6137,33 @@ sendCommonCommand(command: string, args: {[key: string]: Object}): Promise\<void ...@@ -5892,13 +6137,33 @@ sendCommonCommand(command: string, args: {[key: string]: Object}): Promise\<void
**示例：** **示例：**
```js ```ts
import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
let avSessionController: avSession.AVSessionController;
let currentAVSession: avSession.AVSession;
let tag = "createNewSession";
let context: Context = this.context;
avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
currentAVSession = data;
}
});
avSession.createController(currentAVSession.sessionId).then((controller: avSession.AVSessionController) => {
avSessionController = controller;
}).catch((err: BusinessError) => {
console.error(`CreateController BusinessError: code: ${err.code}, message: ${err.message}`);
});
let commandName = "my_command"; let commandName = "my_command";
let args = { avSessionController.sendCommonCommand(commandName, {command : "This is my command"}).then(() => {
command : "This is my command" console.info(`SendCommonCommand successfully`);
} }).catch((err: BusinessError) => {
avsessionController.sendCommonCommand(commandName, args).catch((err) => { console.info(`SendCommonCommand BusinessError: code: ${err.code}, message: ${err.message}`);
console.info(`SendCommonCommand BusinessError: code: ${err.code}, message: ${err.message}`);
}) })
``` ```
...@@ -5935,15 +6200,32 @@ sendCommonCommand(command: string, args: {[key: string]: Object}, callback: Asyn ...@@ -5935,15 +6200,32 @@ sendCommonCommand(command: string, args: {[key: string]: Object}, callback: Asyn
**示例：** **示例：**
```js ```ts
import avSession from '@ohos.multimedia.avsession';
import { BusinessError } from '@ohos.base';
let avSessionController: avSession.AVSessionController;
let currentAVSession: avSession.AVSession;
let tag = "createNewSession";
let context: Context = this.context;
avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
currentAVSession = data;
}
});
avSession.createController(currentAVSession.sessionId).then((controller: avSession.AVSessionController) => {
avSessionController = controller;
}).catch((err: BusinessError) => {
console.error(`CreateController BusinessError: code: ${err.code}, message: ${err.message}`);
});
let commandName = "my_command"; let commandName = "my_command";
let args = { avSessionController.sendCommonCommand(commandName, {command : "This is my command"}, (err: BusinessError) => {
command : "This is my command" if(err) {
} console.info(`SendCommonCommand BusinessError: code: ${err.code}, message: ${err.message}`);
avsessionController.sendCommonCommand(commandName, args, (err) => { }
if(err) {
console.info(`SendCommonCommand BusinessError: code: ${err.code}, message: ${err.message}`);
}
}) })
``` ```
...@@ -5973,9 +6255,32 @@ getExtras(): Promise\<{[key: string]: Object}> ...@@ -5973,9 +6255,32 @@ getExtras(): Promise\<{[key: string]: Object}>
| 6600107 | Too many commands or events. | | 6600107 | Too many commands or events. |
**示例：** **示例：**
```js ```ts
let extras = await avsessionController.getExtras().catch((err) => { import avSession from '@ohos.multimedia.avsession';
console.info(`getExtras BusinessError: code: ${err.code}, message: ${err.message}`); import { BusinessError } from '@ohos.base';
let avSessionController: avSession.AVSessionController;
let currentAVSession: avSession.AVSession;
let tag = "createNewSession";
let context: Context = this.context;
avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
currentAVSession = data;
}
});
avSession.createController(currentAVSession.sessionId).then((controller: avSession.AVSessionController) => {
avSessionController = controller;
}).catch((err: BusinessError) => {
console.error(`CreateController BusinessError: code: ${err.code}, message: ${err.message}`);
});
avSessionController.getExtras().then((extras) => {
console.info(`getExtras : SUCCESS : ${extras}`);
}).catch((err: BusinessError) => {
console.info(`getExtras BusinessError: code: ${err.code}, message: ${err.message}`);
}); });
``` ```
...@@ -6005,13 +6310,34 @@ getExtras(callback: AsyncCallback\<{[key: string]: Object}>): void ...@@ -6005,13 +6310,34 @@ getExtras(callback: AsyncCallback\<{[key: string]: Object}>): void
| 6600107 | Too many commands or events. | | 6600107 | Too many commands or events. |
**示例：** **示例：**
```js ```ts
avsessionController.getExtras(function (err, extras) { import avSession from '@ohos.multimedia.avsession';
if (err) { import { BusinessError } from '@ohos.base';
console.error(`getExtras BusinessError: code: ${err.code}, message: ${err.message}`);
} else { let avSessionController: avSession.AVSessionController;
console.info(`getExtras : SUCCESS : assetId : ${extras}`); let currentAVSession: avSession.AVSession;
} let tag = "createNewSession";
let context: Context = this.context;
avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
currentAVSession = data;
}
});
avSession.createController(currentAVSession.sessionId).then((controller: avSession.AVSessionController) => {
avSessionController = controller;
}).catch((err: BusinessError) => {
console.error(`CreateController BusinessError: code: ${err.code}, message: ${err.message}`);
});
avSessionController.getExtras((err, extras) => {
if (err) {
console.error(`getExtras BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
console.info(`getExtras : SUCCESS : ${extras}`);
}
}); });
``` ```
...@@ -6041,15 +6367,15 @@ on(type: 'metadataChange', filter: Array\<keyof AVMetadata> | 'all', callback: ( ...@@ -6041,15 +6367,15 @@ on(type: 'metadataChange', filter: Array\<keyof AVMetadata> | 'all', callback: (
**示例：** **示例：**
```js ```ts
avsessionController.on('metadataChange', 'all', (metadata) => { avsessionController.on('metadataChange', 'all', (metadata: avSession.AVMetadata) => {
console.info(`on metadataChange assetId : ${metadata.assetId}`); console.info(`on metadataChange assetId : ${metadata.assetId}`);
}); });
let metaFilter = ['assetId', 'title', 'description']; avsessionController.on('metadataChange', ['assetId', 'title', 'description'], (metadata: avSession.AVMetadata) => {
avsessionController.on('metadataChange', metaFilter, (metadata) => { console.info(`on metadataChange assetId : ${metadata.assetId}`);
console.info(`on metadataChange assetId : ${metadata.assetId}`);
}); });
``` ```
### off('metadataChange')<sup>10+</sup> ### off('metadataChange')<sup>10+</sup>
...@@ -6077,7 +6403,7 @@ off(type: 'metadataChange', callback?: (data: AVMetadata) => void) ...@@ -6077,7 +6403,7 @@ off(type: 'metadataChange', callback?: (data: AVMetadata) => void)
**示例：** **示例：**
```js ```ts
avsessionController.off('metadataChange'); avsessionController.off('metadataChange');
``` ```
...@@ -6107,14 +6433,13 @@ on(type: 'playbackStateChange', filter: Array\<keyof AVPlaybackState> | 'all', c ...@@ -6107,14 +6433,13 @@ on(type: 'playbackStateChange', filter: Array\<keyof AVPlaybackState> | 'all', c
**示例：** **示例：**
```js ```ts
avsessionController.on('playbackStateChange', 'all', (playbackState) => { avsessionController.on('playbackStateChange', 'all', (playbackState: avSession.AVPlaybackState) => {
console.info(`on playbackStateChange state : ${playbackState.state}`); console.info(`on playbackStateChange state : ${playbackState.state}`);
}); });
let playbackFilter = ['state', 'speed', 'loopMode']; avsessionController.on('playbackStateChange', ['state', 'speed', 'loopMode'], (playbackState: avSession.AVPlaybackState) => {
avsessionController.on('playbackStateChange', playbackFilter, (playbackState) => { console.info(`on playbackStateChange state : ${playbackState.state}`);
console.info(`on playbackStateChange state : ${playbackState.state}`);
}); });
``` ```
...@@ -6143,7 +6468,7 @@ off(type: 'playbackStateChange', callback?: (state: AVPlaybackState) => void) ...@@ -6143,7 +6468,7 @@ off(type: 'playbackStateChange', callback?: (state: AVPlaybackState) => void)
**示例：** **示例：**
```js ```ts
avsessionController.off('playbackStateChange'); avsessionController.off('playbackStateChange');
``` ```
...@@ -6172,9 +6497,9 @@ on(type: 'sessionDestroy', callback: () => void) ...@@ -6172,9 +6497,9 @@ on(type: 'sessionDestroy', callback: () => void)
**示例：** **示例：**
```js ```ts
avsessionController.on('sessionDestroy', () => { avsessionController.on('sessionDestroy', () => {
console.info(`on sessionDestroy : SUCCESS `); console.info(`on sessionDestroy : SUCCESS `);
}); });
``` ```
...@@ -6203,7 +6528,7 @@ off(type: 'sessionDestroy', callback?: () => void) ...@@ -6203,7 +6528,7 @@ off(type: 'sessionDestroy', callback?: () => void)
**示例：** **示例：**
```js ```ts
avsessionController.off('sessionDestroy'); avsessionController.off('sessionDestroy');
``` ```
...@@ -6232,9 +6557,9 @@ on(type: 'activeStateChange', callback: (isActive: boolean) => void) ...@@ -6232,9 +6557,9 @@ on(type: 'activeStateChange', callback: (isActive: boolean) => void)
**示例：** **示例：**
```js ```ts
avsessionController.on('activeStateChange', (isActive) => { avsessionController.on('activeStateChange', (isActive: boolean) => {
console.info(`on activeStateChange : SUCCESS : isActive ${isActive}`); console.info(`on activeStateChange : SUCCESS : isActive ${isActive}`);
}); });
``` ```
...@@ -6263,7 +6588,7 @@ off(type: 'activeStateChange', callback?: (isActive: boolean) => void) ...@@ -6263,7 +6588,7 @@ off(type: 'activeStateChange', callback?: (isActive: boolean) => void)
**示例：** **示例：**
```js ```ts
avsessionController.off('activeStateChange'); avsessionController.off('activeStateChange');
``` ```
...@@ -6292,10 +6617,10 @@ on(type: 'validCommandChange', callback: (commands: Array\<AVControlCommandType> ...@@ -6292,10 +6617,10 @@ on(type: 'validCommandChange', callback: (commands: Array\<AVControlCommandType>
**示例：** **示例：**
```js ```ts
avsessionController.on('validCommandChange', (validCommands) => { avsessionController.on('validCommandChange', (validCommands: avSession.AVControlCommandType[]) => {
console.info(`validCommandChange : SUCCESS : size : ${validCommands.size}`); console.info(`validCommandChange : SUCCESS : size : ${validCommands.length}`);
console.info(`validCommandChange : SUCCESS : validCommands : ${validCommands.values()}`); console.info(`validCommandChange : SUCCESS : validCommands : ${validCommands.values()}`);
}); });
``` ```
...@@ -6324,7 +6649,7 @@ off(type: 'validCommandChange', callback?: (commands: Array\<AVControlCommandTyp ...@@ -6324,7 +6649,7 @@ off(type: 'validCommandChange', callback?: (commands: Array\<AVControlCommandTyp
**示例：** **示例：**
```js ```ts
avsessionController.off('validCommandChange'); avsessionController.off('validCommandChange');
``` ```
...@@ -6353,9 +6678,9 @@ on(type: 'outputDeviceChange', callback: (state: ConnectionState, device: Output ...@@ -6353,9 +6678,9 @@ on(type: 'outputDeviceChange', callback: (state: ConnectionState, device: Output
**示例：** **示例：**
```js ```ts
avsessionController.on('outputDeviceChange', (state, device) => { avsessionController.on('outputDeviceChange', (state: avSession.ConnectionState, device: avSession.OutputDeviceInfo) => {
console.info(`on outputDeviceChange state: ${state}, device : ${device}`); console.info(`on outputDeviceChange state: ${state}, device : ${device}`);
}); });
``` ```
...@@ -6384,7 +6709,7 @@ off(type: 'outputDeviceChange', callback?: (state: ConnectionState, device: Outp ...@@ -6384,7 +6709,7 @@ off(type: 'outputDeviceChange', callback?: (state: ConnectionState, device: Outp
**示例：** **示例：**
```js ```ts
avsessionController.off('outputDeviceChange'); avsessionController.off('outputDeviceChange');
``` ```
...@@ -6414,9 +6739,30 @@ on(type: 'sessionEvent', callback: (sessionEvent: string, args: {[key:string]: O ...@@ -6414,9 +6739,30 @@ on(type: 'sessionEvent', callback: (sessionEvent: string, args: {[key:string]: O
**示例：** **示例：**
```js ```ts
avsessionController.on('sessionEvent', (sessionEvent, args) => { import avSession from '@ohos.multimedia.avsession';
console.info(`OnSessionEvent, sessionEvent is ${sessionEvent}, args: ${JSON.stringify(args)}`); import { BusinessError } from '@ohos.base';
let avSessionController: avSession.AVSessionController;
let currentAVSession: avSession.AVSession;
let tag = "createNewSession";
let context: Context = this.context;
avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
currentAVSession = data;
}
});
avSession.createController(currentAVSession.sessionId).then((controller: avSession.AVSessionController) => {
avSessionController = controller;
}).catch((err: BusinessError) => {
console.error(`CreateController BusinessError: code: ${err.code}, message: ${err.message}`);
});
avSessionController.on('sessionEvent', (sessionEvent, args) => {
console.info(`OnSessionEvent, sessionEvent is ${sessionEvent}, args: ${JSON.stringify(args)}`);
}); });
``` ```
...@@ -6445,7 +6791,7 @@ off(type: 'sessionEvent', callback?: (sessionEvent: string, args: {[key:string]: ...@@ -6445,7 +6791,7 @@ off(type: 'sessionEvent', callback?: (sessionEvent: string, args: {[key:string]:
**示例：** **示例：**
```js ```ts
avsessionController.off('sessionEvent'); avsessionController.off('sessionEvent');
``` ```
...@@ -6474,9 +6820,9 @@ on(type: 'queueItemsChange', callback: (items: Array<[AVQueueItem](#avqueueitem1 ...@@ -6474,9 +6820,9 @@ on(type: 'queueItemsChange', callback: (items: Array<[AVQueueItem](#avqueueitem1
**示例：** **示例：**
```js ```ts
avsessionController.on('queueItemsChange', (items) => { avsessionController.on('queueItemsChange', (items: avSession.AVQueueItem[]) => {
console.info(`OnQueueItemsChange, items length is ${items.length}`); console.info(`OnQueueItemsChange, items length is ${items.length}`);
}); });
``` ```
...@@ -6505,7 +6851,7 @@ off(type: 'queueItemsChange', callback?: (items: Array<[AVQueueItem](#avqueueite ...@@ -6505,7 +6851,7 @@ off(type: 'queueItemsChange', callback?: (items: Array<[AVQueueItem](#avqueueite
**示例：** **示例：**
```js ```ts
avsessionController.off('queueItemsChange'); avsessionController.off('queueItemsChange');
``` ```
...@@ -6534,9 +6880,9 @@ on(type: 'queueTitleChange', callback: (title: string) => void): void ...@@ -6534,9 +6880,9 @@ on(type: 'queueTitleChange', callback: (title: string) => void): void
**示例：** **示例：**
```js ```ts
avsessionController.on('queueTitleChange', (title) => { avsessionController.on('queueTitleChange', (title: string) => {
console.info(`queueTitleChange, title is ${title}`); console.info(`queueTitleChange, title is ${title}`);
}); });
``` ```
...@@ -6565,7 +6911,7 @@ off(type: 'queueTitleChange', callback?: (title: string) => void): void ...@@ -6565,7 +6911,7 @@ off(type: 'queueTitleChange', callback?: (title: string) => void): void
**示例：** **示例：**
```js ```ts
avsessionController.off('queueTitleChange'); avsessionController.off('queueTitleChange');
``` ```
...@@ -6594,9 +6940,30 @@ on(type: 'extrasChange', callback: (extras: {[key:string]: Object}) => void): vo ...@@ -6594,9 +6940,30 @@ on(type: 'extrasChange', callback: (extras: {[key:string]: Object}) => void): vo
**示例：** **示例：**
```js ```ts
avsessionController.on('extrasChange', (extras) => { import avSession from '@ohos.multimedia.avsession';
console.info(`Caught extrasChange event,the new extra is: ${JSON.stringify(extras)}`); import { BusinessError } from '@ohos.base';
let avSessionController: avSession.AVSessionController;
let currentAVSession: avSession.AVSession;
let tag = "createNewSession";
let context: Context = this.context;
avSession.createAVSession(context, tag, "audio", (err: BusinessError, data: avSession.AVSession) => {
if (err) {
console.info(`CreateAVSession BusinessError: code: ${err.code}, message: ${err.message}`);
} else {
currentAVSession = data;
}
});
avSession.createController(currentAVSession.sessionId).then((controller: avSession.AVSessionController) => {
avSessionController = controller;
}).catch((err: BusinessError) => {
console.error(`CreateController BusinessError: code: ${err.code}, message: ${err.message}`);
});
avSessionController.on('extrasChange', (extras) => {
console.info(`Caught extrasChange event,the new extra is: ${JSON.stringify(extras)}`);
}); });
``` ```
...@@ -6625,7 +6992,7 @@ off(type: 'extrasChange', callback?: (extras: {[key:string]: Object}) => void): ...@@ -6625,7 +6992,7 @@ off(type: 'extrasChange', callback?: (extras: {[key:string]: Object}) => void):
**示例：** **示例：**
```js ```ts
avsessionController.off('extrasChange'); avsessionController.off('extrasChange');
``` ```
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或