Q:音频播放场景,有没有API可以切换扬声器或听筒播放声音?
A:
方案一:AVCastPicker投播组件:
方案二:setDefaultOutputDevice:
如需在连接蓝牙耳机等外接设备时将音频输出切换到扬声器,可使用AudioSessionManager的setMediaOutputDevice接口设置媒体音频输出设备,该接口支持在蓝牙设备连接后指定输出设备为扬声器。可基于HarmonyOS 7.0(26.0.0) Beta1版本验收。
使用示例代码如下:
import { audio } from '@kit.AudioKit';
import { common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { AVCastPicker, avSession } from '@kit.AVSessionKit';
let audioRenderer: audio.AudioRenderer;
let audioStreamInfo: audio.AudioStreamInfo = {
samplingRate: audio.AudioSamplingRate.SAMPLE_RATE_8000, // 采样率。
channels: audio.AudioChannel.CHANNEL_1, // 通道。
sampleFormat: audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE, // 采样格式。
encodingType: audio.AudioEncodingType.ENCODING_TYPE_RAW // 编码格式。
};
let audioRendererInfo: audio.AudioRendererInfo = {
usage: audio.StreamUsage.STREAM_USAGE_VOICE_COMMUNICATION, // 音频流使用类型
rendererFlags: 0 // 音频渲染器标志。
};
let audioRendererOptions: audio.AudioRendererOptions = {
streamInfo: audioStreamInfo,
rendererInfo: audioRendererInfo
};
let audioManager = audio.getAudioManager(); // 需要先创建AudioManager实例。
let audioSessionManager = audioManager.getSessionManager(); // 再调用AudioManager的方法创建AudioSessionManager实例。
let strategy: audio.AudioSessionStrategy = {
concurrencyMode: audio.AudioConcurrencyMode.CONCURRENCY_PAUSE_OTHERS
};
let sessionAv: avSession.AVSession;
@Entry
@Component
export struct SwitchAudioDeviceDemo {
context = this.getUIContext().getHostContext() as common.UIAbilityContext;
audioData: Uint8Array = genTestPCM(); // 测试PCM数据,按需替换为其他音频数据源
writeOffset = 0;
@State renderIsSpeaker: boolean = false;
@State sessionIsSpeaker: boolean = false;
async aboutToAppear(): Promise<void> {
audioRenderer = await audio.createAudioRenderer(audioRendererOptions);
await this.init(); //初始化
audioSessionManager.activateAudioSession(strategy).then(() => { //激活audioSession
console.info('Succeeded in activating audio session.');
}).catch((err: BusinessError) => {
console.error(`Failed to activate audio session. Code: ${err.code}, message: ${err.message}`);
});
sessionAv = await avSession.createAVSession(this.context, 'voiptest', 'voice_call');
}
async aboutToDisappear(): Promise<void> {
await audioRenderer.release();
await sessionAv.destroy();
await audioSessionManager.deactivateAudioSession().then(() => {
console.info('Succeeded in deactivating audio session.');
}).catch((err: BusinessError) => {
console.error(`Failed to deactivate audio session. Code: ${err.code}, message: ${err.message}`);
});
}
build() {
Column({ space: 10 }) {
Button('播放音频数据')
.width('100%')
.onClick(async () => {
await audioRenderer.start();
});
Button('停止播放')
.width('100%')
.onClick(async () => {
console.info('renderer status' + audioRenderer.state);
this.stopAndFlush();
});
Row() {
Text('AudioRenderer切换播放设备:');
Toggle({ type: ToggleType.Switch, isOn: this.renderIsSpeaker })
.onChange((isOn: boolean) => {
this.renderIsSpeaker = isOn;
audioRenderer.setDefaultOutputDevice(isOn ? audio.DeviceType.SPEAKER :
audio.DeviceType.EARPIECE)
.then(() => {
console.info('AudioRenderer Succeeded in setting default output device.');
}).catch((err: BusinessError) => {
console.error(`AudioRenderer setDefaultOutputDevice Fail: ${err}`);
});
});
Text(`${this.renderIsSpeaker ? '扬声器' : '听筒'}`);
}
.width('100%')
.justifyContent(FlexAlign.Start);
Row() {
Text('AudioSession 切换播放设备:');
Toggle({ type: ToggleType.Switch, isOn: this.sessionIsSpeaker })
.onChange((isOn: boolean) => {
this.sessionIsSpeaker = isOn;
audioSessionManager.setDefaultOutputDevice(isOn ? audio.DeviceType.SPEAKER :
audio.DeviceType.EARPIECE)
.then(() => {
console.info('AudioSession Succeeded in setting default output device.');
}).catch((err: BusinessError) => {
console.error(`AudioSession setDefaultOutputDevice Fail: ${err}`);
});
});
Text(`${this.sessionIsSpeaker ? '扬声器' : '听筒'}`);
}
.width('100%')
.justifyContent(FlexAlign.Start);
AVCastPicker({}).width('50').height('50');
}
.padding(20)
.justifyContent(FlexAlign.Center)
.width('100%')
.height('100%');
}
async init() {
audioRenderer.on('writeData', (buffer: ArrayBuffer) => {
if (!this.audioData) {
return audio.AudioDataCallbackResult.INVALID;
}
let bufferView = new Uint8Array(buffer);
let writeLen = Math.min(buffer.byteLength, this.audioData.byteLength - this.writeOffset);
if (writeLen <= 0) {
this.writeOffset = 0;
console.info('Play Done');
return audio.AudioDataCallbackResult.INVALID;
}
bufferView.set(this.audioData.slice(this.writeOffset, this.writeOffset + writeLen));
this.writeOffset += writeLen;
return audio.AudioDataCallbackResult.VALID;
});
}
async stopAndFlush() {
console.info('renderer status' + audioRenderer.state);
audioRenderer.stop().then(() => {
console.error('Renderer stop ok.');
}).catch((err: BusinessError) => {
console.error('Renderer stop failed. ', err);
});
audioRenderer.flush().then(() => {
console.error('Renderer flush ok.');
}).catch((err: BusinessError) => {
console.error('renderer flush err. ' + err);
});
this.writeOffset = 0;
}
}
function genTestPCM(): Uint8Array {
const sampleRate = 8000;
const noteDuration = 0.5;
const amplitude = 0.35;
const freqMap: Record<number, number> = {
1: 523.25, // C5
2: 587.33, // D5
3: 659.25, // E5
4: 698.46, // F5
5: 783.99, // G5
6: 880.00, // A5
};
const melody = [
1, 1, 5, 5, 6, 6, 5, 0,
4, 4, 3, 3, 2, 2, 1, 0,
5, 5, 4, 4, 3, 3, 2, 0
];
const samplesPerNote = Math.floor(sampleRate * noteDuration); // 4000
const totalSamples = samplesPerNote * melody.length; // 96,000
const buffer = new ArrayBuffer(totalSamples * 2); // 192,000 bytes
const view = new DataView(buffer);
let idx = 0;
for (const note of melody) {
const freq = note ? freqMap[note] : 0;
for (let i = 0; i < samplesPerNote; i++) {
const t = i / sampleRate;
const wave = freq ? amplitude * Math.sin(2 * Math.PI * freq * t) : 0;
const sample = Math.round(wave * 32767);
const clamped = Math.max(-32768, Math.min(32767, sample));
view.setInt16(idx * 2, clamped, true);
idx++;
}
}
return new Uint8Array(buffer);
}