第16章_HarmonyOs开发图解之 音频

发布时间:2026/7/30 8:31:36
第16章_HarmonyOs开发图解之 音频 第16章 HarmonyOs开发图解之 音频HarmonyOS 学习系统 | 阶段三高级深耕期学习目标序号能力1理解音频采样的基本原理采样率、位深度、声道2掌握 AudioRenderer音频播放和 AudioCapturer音频采集的使用3能够使用 SoundPlayer 播放短音效核心图解内容讲解16.1 音频基础概念生活化类比音频采样就像电影胶片的帧声音是连续的声波就像连续的河流。我们无法记录整条河流所以每隔一小段距离取一个水样——这就是采样。采样率如 44100Hz就像每秒拍 44100 张照片的帧率帧率越高还原越精确。44100Hz 意味着每秒从声波中取 44100 个快照。人耳能听到 20Hz~20kHz 的声音根据奈奎斯特定理采样率至少要是最高频率的 2 倍所以 44100Hz 能完美还原 22.05kHz 以下的声音。PCM脉冲编码调制就是把这些快照转换成数字的过程。16.2 音频播放 AudioRendererAudioRenderer 是 HarmonyOS 音频播放的核心类支持流式播放模式边读边播和静态播放模式一次加载完整播放。// 初始化 AudioRendererAudioRendererInfoaudioRendererInfonewAudioRendererInfo.Builder().contentType(AudioRendererInfo.ContentType.CONTENT_TYPE_MUSIC).usage(AudioRendererInfo.StreamUsage.STREAM_USAGE_MUSIC).build();AudioRendereraudioRenderernewAudioRenderer(audioRendererInfo,PlayMode.MODE_STREAM);// 读取音频文件并播放在后台线程中执行getGlobalTaskDispatcher(TaskPriority.DEFAULT).asyncDispatch(()-{InputStreamisgetResourceManager().getResource(MediaTable.INPUT);byte[]datanewbyte[4096];while(is.available()0){intreadLenis.read(data);audioRenderer.write(data,0,readLen);}audioRenderer.release();});// 控制播放audioRenderer.start();audioRenderer.pause();audioRenderer.stop();16.3 音频采集 AudioCapturerAudioCapturer 用于从麦克风采集音频数据适合录音、语音识别等场景。// 初始化 AudioCapturerAudioCapturerInfocapturerInfonewAudioCapturerInfo.Builder().contentType(AudioCapturerInfo.ContentType.CONTENT_TYPE_SPEECH).usage(AudioCapturerInfo.StreamUsage.STREAM_USAGE_VOICE_COMMUNICATION).build();AudioCaptureraudioCapturernewAudioCapturer(capturerInfo);// 读取音频数据audioCapturer.start();byte[]buffernewbyte[4096];while(isRecording){intreadLenaudioCapturer.read(buffer,0,buffer.length);// 处理采集到的音频数据...}audioCapturer.release();16.4 短音效播放 SoundPlayerSoundPlayer 适合播放简短的音效如按钮点击声、通知声资源占用更少。// 加载短音资源SoundPlayersoundPlayernewSoundPlayer(context);intsoundIdsoundPlayer.createSound(ResourceTable.Media_button_click);// 播放soundPlayer.play(soundId);// 释放soundPlayer.release();代码速查卡API功能示例new AudioRenderer(info, mode)创建音频播放器new AudioRenderer(info, MODE_STREAM)write(byte[], offset, size)写入音频数据renderer.write(data, 0, len)start() / pause() / stop()控制播放状态renderer.start()new AudioCapturer(info)创建音频采集器new AudioCapturer(info)read(byte[], offset, size)读取音频数据capturer.read(buf, 0, buf.length)SoundPlayer.createSound(id)加载短音资源player.createSound(soundId)soundPlayer.play(soundId)播放短音player.play(soundId)getMinBufferSize(rate, fmt, mask)获取最小缓冲区大小AudioRenderer.getMinBufferSize(44100, ...)与 Android/iOS 对比特性HarmonyOSAndroidiOS音频播放AudioRendererAudioTrack / MediaPlayerAVAudioPlayer音频采集AudioCapturerAudioRecordAVAudioEngine短音效SoundPlayerSoundPoolAudioServicesPlaySystemSound音频焦点AudioManagerAudioManagerAVAudioSession采样率配置AudioRendererInfo 中设置AudioFormat.BuilderAVAudioFormat⚠️ 踩坑回忆录为什么播放出来的声音像滋滋电流声因为采样率不匹配我设置了 48000Hz 的 AudioRenderer但音频文件本身是 44100Hz 的结果播放出来就像快进的磁带——声音又快又尖。解决方案播放前先查询音频文件的实际采样率然后让 AudioRenderer 的采样率与之匹配。可以用AudioManager.getDevices()查询设备支持的格式和采样率。另外AudioRenderer用完必须release()否则音频焦点会被一直占用其他 App 就播放不了声音了。我曾在调试时忘记 release结果整个手机的音效系统都哑了重启才恢复。必做实操任务序号任务难度1实现一个简单的音频播放器支持播放/暂停/停止中2使用 AudioCapturer 录制音频并保存为 PCM 文件高3使用 SoundPlayer 为按钮添加点击音效低4查询设备支持的音频采样率和格式低5实现一个录音 回放的 Demo高学习检查清单能解释采样率、位深度、声道数的基本概念能使用 AudioRenderer 播放音频文件能使用 AudioCapturer 录制音频知道为什么 AudioRenderer 采样率必须与音频文件匹配能使用 SoundPlayer 播放短音效能在后台线程中执行音频读写操作知道为什么必须手动 release 音频资源理解 MODE_STREAM 和 MODE_STATIC 的区别进阶方向结合第 17 章媒体会话实现后台音乐播放并显示系统通知栏控制学习音频编解码AAC、MP3实现格式转换探索音频可视化将音频数据转换为频谱图必须手动 release 音频资源理解 MODE_STREAM 和 MODE_STATIC 的区别进阶方向结合第 17 章媒体会话实现后台音乐播放并显示系统通知栏控制学习音频编解码AAC、MP3实现格式转换探索音频可视化将音频数据转换为频谱图