title: Audio

sidebar_label: Audio

音频

属性

属性名 类型 默认值 说明
src String 要播放音频的资源地址
controls Boolean true 是否显示默认播放控件(播放/暂停按钮、播放进度、时间)
autoplay Boolean false 是否自动播放
poster String 音频封面的图片网络资源地址,如果 controls 属性值为 false 则设置 poster 无效
initialTime Number 指定音频初始播放位置
loop Boolean false 是否循环播放
muted Boolean false 是否静音播放
onPlay EventHandle 当开始/继续播放时触发 play 事件
onPause EventHandle 当暂停播放时触发 pause 事件
onEnded EventHandle 当播放到末尾时触发 ended 事件
onTimeUpdate EventHandle 播放进度变化时触发,触发频率 250ms 一次
onError EventHandle 音频播放出错时触发

各端支持度

属性 微信小程序 H5 ReactNative 百度小程序 支付宝小程序 字节跳动小程序
src x
controls x
autoplay x
poster x
initialTime x
loop x
muted x
onPlay x
onPause x
onEnded x
onTimeUpdate x
onError x
示例:
  1. import Taro, { Component } from '@tarojs/taro'
  2. import { View, Audio } from '@tarojs/components'
  3. export default class PageView extends Component {
  4. constructor() {
  5. super(...arguments)
  6. }
  7. render() {
  8. return (
  9. <View className='components-page'>
  10. <Audio
  11. src='https://ws.stream.qqmusic.qq.com/M500001VfvsJ21xFqb.mp3?guid=ffffffff82def4af4b12b3cd9337d5e7&uin=346897220&vkey=6292F51E1E384E06DCBDC9AB7C49FD713D632D313AC4858BACB8DDD29067D3C601481D36E62053BF8DFEAF74C0A5CCFADD6471160CAF3E6A&fromtag=46'
  12. controls={true}
  13. autoplay={false}
  14. loop={false}
  15. muted={true}
  16. initialTime='30'
  17. id='video'
  18. />
  19. </View>
  20. )
  21. }
  22. }