小程序开放平台

文档中心
基础
路由
跳转
转发
界面
网络
支付
数据缓存
媒体
图片
地图
视频
富文本
相机
音频
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 })
该文档是否对您有帮助?