小程序开放平台

文档中心
基础
界面
网络
数据缓存
媒体
图片
地图
视频
富文本
音频
xhs.createInnerAudioContext
InnerAudioContext
录音
位置
开放接口
设备
XHSML
性能
文件
画布

xhs.createInnerAudioContext

开发
>
JS API
>
媒体
>
音频
>
xhs.createInnerAudioContext
>
更新时间:2026-04-10 18:00:21

基础库 3.148.0 开始支持。

创建内部音频上下文 InnerAudioContext 对象,用于音频播放控制。

参数

属性
类型
默认值
必填
说明
useWebAudioImplementbooleanfalse强制使用 Web 实现(HTMLAudioElement)降级播放
useRenderAudioPlayerbooleanfalse使用渲染层播放器(逻辑层 ⇄ postMessage ⇄ 渲染层),适用于需要渲染层控制的场景

两个参数均不传时,默认使用 Native 播放器(推荐)。

返回值

InnerAudioContext

示例代码

// 默认 Native 播放(推荐)
const audioCtx = xhs.createInnerAudioContext()
audioCtx.src = 'https://example.com/audio.aac'
audioCtx.play()

// Web 降级播放
const audioCtx = xhs.createInnerAudioContext({ useWebAudioImplement: true })
该文档是否对您有帮助?