Audio - 《Taro 文档帮助手册教程》

sidebar_label: Audio
类型
示例代码
AudioProps

title: Audio

sidebar_label: Audio

音频。1.6.0版本开始，该组件不再维护。建议使用能力更强的 Taro.createInnerAudioContext 接口

支持情况： Audio - 图1 Audio - 图2 Audio - 图3 Audio - 图4

参考文档

类型

ComponentType<AudioProps>

示例代码

import Tabs from ‘@theme/Tabs’ import TabItem from ‘@theme/TabItem’

tsx
export default class PageView extends Component {
  constructor() {
    super(...arguments)
  }

  render() {
    return (
      <View className='components-page'>
        <Audio
          src='https://ws.stream.qqmusic.qq.com/M500001VfvsJ21xFqb.mp3?guid=ffffffff82def4af4b12b3cd9337d5e7&uin=346897220&vkey=6292F51E1E384E06DCBDC9AB7C49FD713D632D313AC4858BACB8DDD29067D3C601481D36E62053BF8DFEAF74C0A5CCFADD6471160CAF3E6A&fromtag=46'
          controls={true}
          autoplay={false}
          loop={false}
          muted={true}
          initialTime='30'
          id='video'
        />
      </View>
    )
  }
}

html
<template>
  <view class="components-page">
    <audio
      id="video"
      src="https://ws.stream.qqmusic.qq.com/M500001VfvsJ21xFqb.mp3?guid=ffffffff82def4af4b12b3cd9337d5e7&uin=346897220&vkey=6292F51E1E384E06DCBDC9AB7C49FD713D632D313AC4858BACB8DDD29067D3C601481D36E62053BF8DFEAF74C0A5CCFADD6471160CAF3E6A&fromtag=46"
      :controls="true"
      :autoplay="false"
      :loop="false"
      :muted="true"
    />
  </view>
</template>

AudioProps

参数	类型	默认值	必填	说明
id	`string`		否	audio 组件的唯一标识符
src	`string`		否	要播放音频的资源地址
loop	`boolean`	`false`	否	是否循环播放
muted	`boolean`	`false`	否	是否静音播放不推荐使用
controls	`boolean`	`false`	否	是否显示默认控件
poster	`string`		否	默认控件上的音频封面的图片资源地址，如果 controls 属性值为 false 则设置 poster 无效
name	`string`	`"未知音频"`	否	默认控件上的音频名字，如果 controls 属性值为 false 则设置 name 无效
author	`string`	`"未知作者"`	否	默认控件上的作者名字，如果 controls 属性值为 false 则设置 author 无效
onError	`CommonEventFunction<onErrorEventDetail>`		否	当发生错误时触发 error 事件，detail = {errMsg: MediaError.code}
onPlay	`CommonEventFunction`		否	当开始/继续播放时触发play事件
onPause	`CommonEventFunction`		否	当暂停播放时触发 pause 事件
onTimeUpdate	`CommonEventFunction<onTimeUpdateEventDetail>`		否	当播放进度改变时触发 timeupdate 事件，detail = {currentTime, duration}
onEnded	`CommonEventFunction`		否	当播放到末尾时触发 ended 事件
nativeProps	`Record<string, unknown>`		否	用于透传 `WebComponents` 上的属性到内部 H5 标签上

API 支持度

API	微信小程序	百度小程序	H5
AudioProps.id	✔️
AudioProps.src	✔️	✔️	✔️
AudioProps.loop	✔️	✔️	✔️
AudioProps.muted			✔️
AudioProps.controls	✔️	✔️	✔️
AudioProps.poster	✔️	✔️
AudioProps.name	✔️
AudioProps.author	✔️
AudioProps.onError	✔️	✔️	✔️
AudioProps.onPlay	✔️	✔️	✔️
AudioProps.onPause	✔️	✔️	✔️
AudioProps.onTimeUpdate	✔️	✔️	✔️
AudioProps.onEnded	✔️	✔️	✔️
AudioProps.nativeProps			✔️

onErrorEventDetail

参数	类型
errMsg	`keyof Code`

onTimeUpdateEventDetail

参数	类型	说明
currentTime	`number`	当前时间
duration	`number`	持续时间

MediaError

Code

参数	说明
1	获取资源被用户禁止
2	网络错误
3	解码错误
4	不合适资源