音频池加载播放实例,音频池提供了系统声音的加载、播放、音量设置、循环设置、停止播放、资源卸载等功能。
SoundPool需要和@ohos.multimedia.media共同利用,需要先通过media.createSoundPool完成音频池实例的创建。
说明:
本模块首批接口从API version 10开始支持。后续版本的新增接口,接纳上角标单独标志接口的起始版本。
导入模块
- import media from '@ohos.multimedia.media';
- import audio from '@ohos.multimedia.audio';
复制代码 PlayParameters
表示音频池播放参数设置。
通过设置播放相干参数,来控制播放的音量,循环次数,播放优先级等参数。
系统本领: SystemCapability.Multimedia.Media.SoundPool
名称类型必填说明loop数否设置循环参数,0为循环一次,-1表示一直循环。rate数否设置音频播放的倍速,具体倍速范围参照AudioRendererRate。leftVolume数否设置左声道音量,设置范围(0~1)。rightVolume数否设置右声道音量。(当前不支持左右分别设置,将以左声道音量为准)。priority数否音频流播放的优先级,0为最低优先级,数值越大优先级越高,通过相互比力大小确定播放优先级。parallelPlayFlag布尔否是否和别的正在播放的音频并行播放的标识,true:不抢占音频核心和别的正在播放的音频并行播放,false:抢占核心打断别的正在播放的音频。
此接口为系统接口。 SoundPool
音频池提供了系统声音的加载、播放、音量设置、循环设置、停止播放、资源卸载等功能, 在调用SoundPool的接口前,需要先通过createSoundPool创建实例
load
load(uri: string, callback: AsyncCallback<number>): void
加载音频资源。利用callback方式异步获取资源ID,入参uri通过获取文件fd生成以"fd://"开头的文件形貌字符串。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明uri字符串是音频文件的加载路径形貌,一般以"fd://"开头的文件形貌。回调AsyncCallback<number>是异步音频资源加载返回的资源id,有效值大于0。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by callback.5400103I/O error. Return by callback.5400105Service died. Return by callback. 示例:
- import fs from '@ohos.file.fs';
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let uri:string = "";
- let file: fs.File;
- //获取fd的uri路径
- fs.open('/test_01.mp3', fs.OpenMode.READ_ONLY).then((file_: fs.File) => {
- file = file_;
- console.info("file fd: " + file.fd);
- uri = 'fd://' + (file.fd).toString()
- soundPool.load(uri, (error: BusinessError, soundId_: number) => {
- if (error) {
- console.info(`load soundPool Error: errCode is ${error.code}, errMessage is ${error.message}`)
- } else {
- console.info(`load soundPool Success` + JSON.stringify(soundId_))
- }
- });
- }); // '/test_01.mp3' 作为样例,使用时需要传入文件对应路径。
- }
- });
复制代码 load
load(uri: string): Promise<number>
加载音频资源。利用Promise方式异步获取资源ID,入参uri通过获取文件fd生成以"fd://"开头的文件形貌字符串。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明uri字符串是音频文件的加载路径形貌,一般以"fd://"开头的文件形貌。 返回值:
类型说明Promise<number>异步音频池资源的加载,返回资源的id,有效值大于0。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by promise.5400103I/O error. Return by promise.5400105Service died. Return by promise. 示例:
- import fs from '@ohos.file.fs';
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let uri:string = "";
- let soundID: number = 0;
- let file: fs.File;
- //获取fd的uri路径
- fs.open('/test_01.mp3', fs.OpenMode.READ_ONLY).then((file_: fs.File) => {
- file = file_;
- console.info("file fd: " + file.fd);
- uri = 'fd://' + (file.fd).toString()
- soundPool.load(uri).then((soundId: number) => {
- console.info('soundPool load uri success');
- soundID = soundId;
- }, (err: BusinessError) => {
- console.error('soundPool load failed and catch error is ' + err.message);
- });
- }); // '/test_01.mp3' 作为样例,使用时需要传入文件对应路径。
- }
- });
复制代码 load
load(fd: number, offset: number, length: number, callback: AsyncCallback<number>): void
加载音频资源。利用callback方式异步获取资源ID,入参可手动传入资源信息或通过读取应用内置资源自动获取。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明fdnumber是资源句柄,通过resourceManager.getRawFileDescriptor获取。offsetnumber是资源偏移量,需要基于预置资源的信息输入,非法值会造成音视频资源解析错误。lengthnumber是资源长度,需要基于预置资源的信息输入,非法值会造成音视频资源解析错误。callbackAsyncCallback<number>是获取回调的soundID,有效值大于0。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by callback.5400103I/O error. Return by callback.5400105Service died. Return by callback. 示例:
- import fs from '@ohos.file.fs';
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let file: fs.File;
- let soundID: number = 0;
- let fileSize: number = 1; //通过fs.stat()获取size值
- let uri: string = "";
- //获取fd的描述信息
- fs.open('/test_01.mp3', fs.OpenMode.READ_ONLY).then((file_: fs.File) => {
- file = file_;
- console.info("file fd: " + file.fd);
- uri = 'fd://' + (file.fd).toString()
- soundPool.load(file.fd, 0, fileSize, (error: BusinessError, soundId_: number) => {
- if (error) {
- console.info(`load soundPool Error: errCode is ${error.code}, errMessage is ${error.message}`)
- } else {
- soundID = soundId_;
- console.info('load success soundid:' + soundId_);
- }
- });
- }); // '/test_01.mp3' 作为样例,使用时需要传入文件对应路径。
- }
- });
复制代码 load
load(fd: number, offset: number, length: number): Promise<number>
加载音频资源。利用Promise方式异步获取资源ID,入参可手动传入资源信息或通过读取应用内置资源自动获取。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明fdnumber是资源句柄,通过resourceManager.getRawFileDescriptor获取。offsetnumber是资源偏移量,需要基于预置资源的信息输入,非法值会造成音视频资源解析错误。lengthnumber是资源长度,需要基于预置资源的信息输入,非法值会造成音视频资源解析错误。 返回值:
类型说明Promise<number>获取回调的soundID,有效值大于0。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by promise.5400103I/O error. Return by promise.5400105Service died. Return by promise. 示例:
- import fs from '@ohos.file.fs';
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let file: fs.File;
- let soundID: number = 0;
- let fileSize: number = 1; //通过fs.stat()获取size值
- let uri: string = "";
- //获取fd的描述信息
- fs.open('/test_01.mp3', fs.OpenMode.READ_ONLY).then((file_: fs.File) => {
- file = file_;
- console.info("file fd: " + file.fd);
- uri = 'fd://' + (file.fd).toString()
- soundPool.load(file.fd, 0, fileSize).then((soundId: number) => {
- console.info('load success');
- soundID = soundId;
- }, (err: BusinessError) => {
- console.error('soundpool load failed and catch error is ' + err.message);
- });
- });
- }
- });
复制代码 play
play(soundID: number, params: PlayParameters, callback: AsyncCallback<number>): void
播放音频资源。利用callback方式异步获取音频流streamID。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明soundIDnumber是资源ID,通过load方法获取。paramsPlayParameters是play播放相干参数的设置。callbackAsyncCallback<number>是获取回调的音频流ID,有效值大于0。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by callback.5400105Service died. Return by callback. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let soundID: number = 0;
- let streamID: number = 0;
- let playParameters: media.PlayParameters = {
- loop: 3, // 循环4次
- rate: audio.AudioRendererRate.RENDER_RATE_NORMAL, // 正常倍速
- leftVolume: 0.5, // range = 0.0-1.0
- rightVolume: 0.5, // range = 0.0-1.0
- priority: 0, // 最低优先级
- }
- soundPool.play(soundID, playParameters, (error: BusinessError, streamId: number) => {
- if (error) {
- console.info(`play sound Error: errCode is ${error.code}, errMessage is ${error.message}`)
- } else {
- streamID = streamId;
- console.info('play success soundid:' + streamId);
- }
- });
- }
- });
复制代码 play
play(soundID: number, callback: AsyncCallback<number>): void
播放音频资源。利用callback方式异步获取音频流streamID。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明soundIDnumber是资源ID,通过load方法获取。callbackAsyncCallback<number>是获取回调的音频流ID,有效值大于0。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by callback.5400105Service died. Return by callback. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let soundID: number = 0;
- let streamID: number = 0;
- soundPool.play(soundID, (error: BusinessError, streamId: number) => {
- if (error) {
- console.info(`play sound Error: errCode is ${error.code}, errMessage is ${error.message}`)
- } else {
- streamID = streamId;
- console.info('play success soundid:' + streamId);
- }
- });
- }
- });
复制代码 play
play(soundID: number, params?: PlayParameters): Promise<number>
播放音频资源。利用Promise方式异步获取音频流streamID。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明soundIDnumber是资源ID,通过load方法获取。paramsPlayParameters否play播放相干参数的设置。 返回值:
类型说明Promise<number>获取回调的音频流ID,有效值大于0。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by promise.5400105Service died. Return by promise. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let soundID: number = 0;
- let streamID: number = 0;
- let playParameters: media.PlayParameters = {
- loop: 3, // 循环4次
- rate: audio.AudioRendererRate.RENDER_RATE_NORMAL, // 正常倍速
- leftVolume: 0.5, // range = 0.0-1.0
- rightVolume: 0.5, // range = 0.0-1.0
- priority: 0, // 最低优先级
- }
- soundPool.play(soundID, playParameters).then((streamId: number) => {
- console.info('play success');
- streamID = streamId;
- },(err: BusinessError) => {
- console.error('soundpool play failed and catch error is ' + err.message);
- });
- }
- });
复制代码 stop
stop(streamID: number, callback: AsyncCallback<void>): void
停止播放音频资源。利用callback方式异步获取返回值。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明streamIDnumber是音频流ID,通过play方法获取。callbackAsyncCallback<void>是异步音频池stop的回调方法。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by callback.5400105Service died. Return by callback. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let streamID: number = 0;
- //先调用play方法给拿到对应的streamID
- soundPool.stop(streamID, (error: BusinessError) => {
- if (error) {
- console.info(`stop sound Error: errCode is ${error.code}, errMessage is ${error.message}`)
- } else {
- console.info('stop success');
- }
- })
- }
- });
复制代码 stop
stop(streamID: number): Promise<void>
停止streamID对应的音频播放。利用Promise方式异步获取返回值。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明streamID数是音频流ID,通过play方法获取。 返回值:
类型说明承诺<无效>返回值。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by promise.5400105Service died. Return by promise. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let streamID: number = 0;
- //先调用play方法给拿到对应的streamID
- soundPool.stop(streamID).then(() => {
- console.info('stop success');
- }, (err: BusinessError) => {
- console.error('soundpool load stop and catch error is ' + err.message);
- });
- }
- });
复制代码 setLoop
setLoop(streamID: number, loop: number, callback: AsyncCallback<void>): void;
设置循环模式。利用callback方式异步获取返回值。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明streamID数是音频流ID,通过play方法获取。loop数是设置循环的次数,0为默认1次,小于0为一直循环。callbackAsyncCallback<void>是异步setLoop的回调方法。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by callback.5400105Service died. Return by callback. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let streamID: number = 0;
- //先通过调用play方法获取到对应的streamID
- //设置循环2次
- soundPool.setLoop(streamID, 2, (error: BusinessError) => {
- if (error) {
- console.info(`setLoop soundPool Error: errCode is ${error.code}, errMessage is ${error.message}`)
- } else {
- console.info('setLoop success streamID:' + streamID);
- }
- });
- }
- });
复制代码 setLoop
setLoop(streamID: number, loop: number): Promise<void>
设置循环模式。利用Promise方式异步获取返回值。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明streamIDnumber是音频流ID,通过play方法获取。loopnumber是设置循环的次数,0为默认1次,小于0为一直循环。 返回值:
类型说明Promise<void>异步音频池setLoop方法的Promise返回值。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by promise.5400105Service died. Return by promise. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let streamID: number = 0;
- //先通过调用play方法获取到对应的streamID
- //设置循环1次
- soundPool.setLoop(streamID, 1).then(() => {
- console.info('setLoop success streamID:' + streamID);
- }).catch((err: BusinessError) => {
- console.error('soundpool setLoop failed and catch error is ' + err.message);
- });
- }
- });
复制代码 setPriority
setPriority(streamID: number, priority: number, callback: AsyncCallback<void>): void
设置音频流播放的优先级。利用callback方式异步获取返回值。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明streamIDnumber是音频流ID,通过play方法获取。prioritynumber是优先级,0表示最低优先级。callbackAsyncCallback<void>是异步音频池setPriority方法的回调方法。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by callback.5400105Service died. Return by callback. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let streamID: number = 0;
- // 先调用play方法获取到对应资源的streamID
- // 给对应的streamID资源设置优先级为1
- soundPool.setPriority(streamID, 1, (error: BusinessError) => {
- if (error) {
- console.info(`setPriority soundPool Error: errCode is ${error.code}, errMessage is ${error.message}`)
- } else {
- console.info('setPriority success streamID:' + streamID);
- }
- });
- }
- });
复制代码 setPriority
setPriority(streamID: number, priority: number): Promise<void>
设置音频流优先级。利用Promise方式异步获取返回值。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明streamID数是音频流ID,通过play方法获取。priority数是优先级,0表示最低优先级。 返回值:
类型说明承诺<无效>异步音频池setPriority的Promise返回值。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by promise.5400105Service died. Return by promise. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let streamID: number = 0;
- // 先调用play方法获取到对应资源的streamID
- // 给对应的streamID资源设置优先级为1
- soundPool.setPriority(streamID, 1).then(() => {
- console.info('setPriority success');
- }, (err: BusinessError) => {
- console.error('soundpool setPriority failed and catch error is ' + err.message);
- });
- }
- });
复制代码 setRate
setRate(streamID: number, rate: audio.AudioRendererRate, callback: AsyncCallback<void>): void
设置音频流播放速率。利用callback方式异步获取返回值。
说明: 该接口在4.0版本开放,功能实现受设备影响有所区别(当前RK3568开辟板支持倍速,其他设备暂不支持)。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明streamID数是音频流ID,通过play方法获取。rateaudio.AudioRendererRate是音频rate相干参数。回调AsyncCallback<void>是异步音频池setRate方法的回调方法。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by callback.5400105Service died. Return by callback. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let streamID: number = 0;
- let selectedAudioRendererRate: audio.AudioRendererRate = audio.AudioRendererRate.RENDER_RATE_NORMAL; // 默认正常速率
- // 先调用play方法获取到对应资源的streamID
- soundPool.setRate(streamID, selectedAudioRendererRate, (error: BusinessError) => {
- if (error) {
- console.info(`setRate soundPool Error: errCode is ${error.code}, errMessage is ${error.message}`)
- } else {
- console.info('setRate success streamID:' + streamID);
- }
- })
- }
- });
复制代码 setRate
setRate(streamID: number, rate: audio.AudioRendererRate): Promise<void>
设置音频流的播放速率。利用Promise方式异步获取返回值。
说明: 该接口在4.0版本开放,功能实现受设备影响有所区别(当前RK3568开辟板支持倍速,其他设备暂不支持)。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明streamIDnumber是音频流ID,通过play方法获取。rateaudio.AudioRendererRate是音频rate相干参数。 返回值:
类型说明Promise<void>异步音频池setRate方法的Promise返回值。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by promise.5400105Service died. Return by promise. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let streamID: number = 0;
- let selectedAudioRendererRate: audio.AudioRendererRate = audio.AudioRendererRate.RENDER_RATE_NORMAL; // 默认正常速率
- // 先调用play方法获取到对应资源的streamID
- soundPool.setRate(streamID, selectedAudioRendererRate).then(() => {
- console.info('setRate success');
- }, (err: BusinessError) => {
- console.error('soundpool setRate failed and catch error is ' + err.message);
- });
- }
- });
复制代码 setVolume
setVolume(streamID: number, leftVolume: number, rightVolume: number, callback: AsyncCallback<void>): void
设置音频流播放音量。利用callback方式异步获取返回值。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明streamIDnumber是音频流ID,通过play方法获取。leftVolumenumber是左声道音量,设置范围为0.0-1.0之间。rightVolumenumber是右声道音量,当前右声道设置无效,以左声道为准。callbackAsyncCallback<void>是异步音频池setVolume方法的回调方法。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by callback.5400105Service died. Return by callback. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let streamID: number = 0;
- // 先调用play方法获取到对应资源的streamID
- //设置音量为0.5
- soundPool.setVolume(streamID, 0.5, 0.5, (error: BusinessError) => {
- if (error) {
- console.info(`setVolume soundPool Error: errCode is ${error.code}, errMessage is ${error.message}`)
- } else {
- console.info('setVolume success streamID:' + streamID);
- }
- })
- }
- });
复制代码 setVolume
setVolume(streamID: number, leftVolume: number, rightVolume: number): Promise<void>
设置音频流的播放音量。利用Promise方式异步获取返回值。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明streamID数是音频流ID,通过play方法获取。leftVolume数是左声道音量,设置范围为0.0-1.0之间。rightVolume数是右声道音量,当前右声道设置无效,以左声道为准。 返回值:
类型说明承诺<无效>异步音频池setVolume方法的Promise返回值。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by promise.5400105Service died. Return by promise. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let streamID: number = 0;
- // 先调用play方法获取到对应资源的streamID
- soundPool.setVolume(streamID, 0.5, 0.5).then(() => {
- console.info('setVolume success');
- }, (err: BusinessError) => {
- console.error('soundpool setVolume failed and catch error is ' + err.message);
- });
- }
- });
复制代码 unload
unload(soundID: number, callback: AsyncCallback<void>): void
卸载音频资源。利用callback方式异步获取返回值。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明soundID数是资源ID,通过load方法获取。回调AsyncCallback<void>是异步音频池unload方法的回调方法。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by callback.5400103I/O error. Return by callback.5400105Service died. Return by callback. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let soundID: number = 0;
- // 先调用load方法获取到对应资源的soundID
- soundPool.unload(soundID, (error: BusinessError) => {
- if (error) {
- console.info(`unload soundPool Error: errCode is ${error.code}, errMessage is ${error.message}`)
- } else {
- console.info('unload success:');
- }
- })
- }
- });
复制代码 unload
unload(soundID: number): Promise<void>
卸载音频资源。利用Promise方式异步获取返回值。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明soundIDnumber是资源ID,通过load方法获取。 返回值:
类型说明Promise<void>异步音频池unload方法的Promise返回值。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400102Operation not allowed. Return by promise.5400103I/O error. Return by promise.5400105Service died. Return by promise. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- let soundID: number = 0;
- // 先调用load方法获取到对应资源的soundID
- soundPool.unload(soundID).then(() => {
- console.info('unload success');
- }, (err: BusinessError) => {
- console.error('soundpool unload failed and catch error is ' + err.message);
- });
- }
- });
复制代码 release
release(callback: AsyncCallback<void>): void
释放音频池实例。利用callback方式异步获取返回值。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明callbackAsyncCallback<void>是异步音频池release方法的回调方法。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400105Service died. Return by callback. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- soundPool.release((error: BusinessError) => {
- if (error) {
- console.info(`release soundPool Error: errCode is ${error.code}, errMessage is ${error.message}`)
- } else {
- console.info('release success');
- }
- })
- }
- });
复制代码 release
release(): Promise<void>
释放音频池实例。利用Promise方式异步获取返回值。
系统本领: SystemCapability.Multimedia.Media.SoundPool
返回值:
类型说明承诺<无效>异步音频池release方法的Promise返回值。 错误码:
以下错误码的详细介绍请参见媒体错误码。
错误码ID错误信息5400105Service died. Return by promise. 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- soundPool.release().then(() => {
- console.info('release success');
- }, (err: BusinessError) => {
- console.error('soundpool release failed and catch error is ' + err.message);
- });
- }
- });
复制代码 on('loadComplete')
on(type: 'loadComplete', callback: Callback<number>): void
音频池资源加载完成监听。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明类型字符串是支持的事件:'loadComplete',对应的ID加载完成会触发此回调。回调Callback<number>是对应资源加载完成的资源ID。 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- soundPool.on('loadComplete', (soundId: number) => {
- console.info('loadComplete success,soundId:' + soundId)
- })
- }
- });
复制代码 off('loadComplete')
off(type: 'loadComplete'): void
取消监听资源的加载完成。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明typestring是取消注册的事件:'loadComplete'。 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- soundPool.off('loadComplete')
- }
- });
复制代码 on('playFinished')
on(type: 'playFinished', callback: Callback<void>): void
音频池资源播放完成监听。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明typestring是支持的事件:'playFinished',音频流播放完成会触发此回调。callbackCallback<void>是异步'playFinished'的回调方法。 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- soundPool.on('playFinished', () => {
- console.info('playFinished success')
- });
- }
- });
复制代码 off('playFinished')
off(type: 'playFinished'): void
取消监听音频池资源播放完成。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明typestring是取消注册的事件:'playFinished'。 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- soundPool.off('playFinished')
- }
- });
复制代码 on('error')
on(type: 'error', callback: ErrorCallback): void
监听SoundPool的错误事件,该事件仅用于错误提示。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明typestring是错误事件回调类型,支持的事件:'error',用户操纵和系统都会触发此事件。callbackErrorCallback是错误事件回调方法:利用播放器的过程中发生错误,会提供错误码ID和错误信息。 SoundPool回调的错误分类可以分为以下几种:
错误码ID错误信息说明401Invalid Parameter:入参错误,表示调用无效。801Unsupport Capability:不支持该API本领,表示调用无效。5400101No Memory:内存不足。5400102Operation Not Allowed:当前状态机不支持此操纵,表示调用无效。5400103IO Error:I/O异常。5400105Service Died:播放进程殒命,音频池依赖的service端发生异常。 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- soundPool.on('error', (error: BusinessError) => {
- console.error('error happened,and error message is :' + error.message)
- console.error('error happened,and error code is :' + error.code)
- })
- }
- });
复制代码 off('error')
off(type: 'error'): void
取消监听音频池的错误事件。
系统本领: SystemCapability.Multimedia.Media.SoundPool
参数:
参数名类型必填说明类型字符串是错误事件回调类型,取消注册的事件:'error'。 示例:
- import { BusinessError } from '@ohos.base';
- //创建soundPool实例
- let soundPool: media.SoundPool;
- let audioRendererInfo: audio.AudioRendererInfo = {
- usage: audio.StreamUsage.STREAM_USAGE_MUSIC,
- rendererFlags: 1
- }
- media.createSoundPool(5, audioRendererInfo, (error: BusinessError, soundPool_: media.SoundPool) => {
- if (error) {
- console.info(`createSoundPool failed`)
- return;
- } else {
- soundPool = soundPool_;
- console.info(`createSoundPool success`)
- soundPool.off('error')
- }
- });
复制代码 最后
有许多小同伴不知道学习哪些鸿蒙开辟技术?不知道需要重点掌握哪些鸿蒙应用开辟知识点?而且学习时频仍踩坑,终极浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。
这份鸿蒙(HarmonyOS NEXT)资料包罗了鸿蒙开辟必掌握的核心知识要点,内容包罗了(ArkTS、ArkUI开辟组件、Stage模子、多端摆设、分布式应用开辟、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开辟、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。
希望这一份鸿蒙学习资料能够给各人带来帮助,有需要的小同伴自行领取,限时开源,先到先得~无套路领取!!
获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
鸿蒙(HarmonyOS NEXT)最新学习路线
- HarmonOS就业必备技能
- HarmonOS多媒体技术
有了路线图,怎么能没有学习资料呢,小编也准备了一份团结鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开辟入门教学视频,内容包罗:ArkTS、ArkUI、Web开辟、应用模子、资源分类…等知识点。
获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
《鸿蒙 (OpenHarmony)开辟入门教学视频》
《鸿蒙生态应用开辟V2.0白皮书》
《鸿蒙 (OpenHarmony)开辟基础到实战手册》
OpenHarmony北向、南向开辟情况搭建
《鸿蒙开辟基础》
- ArkTS语言
- 安装DevEco Studio
- 运用你的第一个ArkTS应用
- ArkUI声明式UI开辟
- .……
《鸿蒙开辟进阶》
- Stage模子入门
- 网络管理
- 数据管理
- 电话服务
- 分布式应用开辟
- 关照与窗口管理
- 多媒体技术
- 安全技能
- 任务管理
- WebGL
- 国际化开辟
- 应用测试
- DFX面向将来操持
- 鸿蒙系统移植和裁剪定制
- ……
《鸿蒙进阶实战》
- ArkTS实践
- UIAbility应用
- 网络案例
- ……
获取以上完整鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料
总结
总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机遇。只有积极应对变革,不断学习和提拔本身,他们才能在这个变革的期间中立于不败之地。
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。 |