更新记录

1.3.1（2023-06-02）

-增加了 newSeek 参数传递，父级界面可通过 :newSeek 传入参数， 使音频组件播放的音频时间戳 前进 / 后退 对应的秒数

1.3.0（2023-05-18）

• 增加 “已听完” 历史记录效果，当用户听完一首音频，左侧会显示相应效果，方便用户记录
• 增加 向外提供播放列表下标传值 lastSongIndex 、音频列表播放下标发生改变事件 playChangeIndex
• 该版本组件将使用 uni.getStorageSync 与 uni.setStorageSync 本地存储功能，用于存储 用户历史记录

1.2.2（2023-05-15）

• 修复 时 用户在 H5 使用组件最小化时 chunk-vendors.js 提示的小报错；(虽然不影响使用，但是还是有点强迫症)

平台兼容性

计划更新的内容

• [x] 歌曲列表播放
• [x] 歌曲倍速播放
• [x] 歌曲后台播放
• [x] 歌曲播放完成历史记录
• [x] 歌词列表同步播放 单独分离成独立组件 smm-lyricBar

组件介绍

基于 uni.createVideoContext() 创建的 video 实例

解决了网络请求得到的音频地址无法播放的问题，索性发布了；

思路是 使用了等待机制，当有数据后，才进行赋值操作； 所以 porp 不再对 video 传入空值

如若是异步得到的数据，不建议使用 :src、:name... 对播放器传值， 推荐任何情况下都使用 :srcList 进行对象数组传值；即使只是播放单个音频

参数传递

事件向外提供

使用演示

传入多个

<template>
    <view>
        <smm-audio :srcList='arrList'></smm-audio>
    </view>
</template>

<script>
export default {
    data() {
        return {
            arr: [{
                src: '音频真实地址',
                name: '音频名',
                singer: '作者名 & 系列名',
                imgSrc: '图片链接'
            },
            {
                src: '音频真实地址',
                name: '音频名',
                singer: '作者名 & 系列名',
                imgSrc: '图片链接'
            },
            {
                src: '音频真实地址',
                name: '音频名',
                singer: '作者名 & 系列名',
                imgSrc: '图片链接'
            }],
        };
    }
}
</script>

传入单个

<template>
    <view>
        <smm-audio 
        :src='songSrc' 
        :name="ongName"
        :singer="songSinger"
        :imgSrc="songImgSrc"
        ></smm-audio>
    </view>
</template>

<script>
export default {
    data() {
        return {
            songSrc: '音频真实地址',
            songName: '音频名',
            songSinger: '作者名 & 系列名',
            songImgSrc: '图片链接'
        };
    }
}
</script>

后台播放

组件会监听页面切换后台后自动调用 getBackgroundAudioManager 继续播放音频

但由于组件不能直接监听页面的切换后台事件，需要从页面向组件传入对应事件

<template>
    <view>
        <smm-audio :srcList='arrList'></smm-audio>
    </view>
</template>

<script>
export default {
    data() {
        return {
            srcList: [{
                src: '音频真实地址',
                name: '音频名',
                singer: '作者名 & 系列名',
                imgSrc: '图片链接'
            }]
        };
    },
    onShow: function () {
        console.log('App Show')
        uni.$emit('onShow');
    },
    onHide: function () {
        console.log('App Hide')
        uni.$emit('onHide');
    }
}
</script>

实现下次启动自动跳转到上次播放的音频

<template>
  <view>
    <smm-audio :srcList='arrList' :lastSongIndex='befoIndex' :directory="true" :dirHight="wh"
      @playChangeIndex='storageIndex'></smm-audio>
  </view>
</template>

<script>
export default {
  data() {
    return {
      arrList: [],
      wh: 0,
      nowTime: 0,
      // 上一个记录
      befoIndex: 0
    };
  },
  onLoad() {
    // 获取设备信息
    const info = uni.getSystemInfoSync();
    // 为当前 可用高度对应变量进行赋值
    this.wh = info.windowHeight - 100;
  },
  created() {
    this.getSongList();
  },
  methods: {
    getSongList() {
      uni.request({
        url: '网络请求接口',
        method: 'GET',
        success: ({
          data: res
        }) => {
          this.arrList = res.map(function (item, index) {
            let src = item.songUrl;
            // let name = item.songName;
            let name = `第 ${index + 1} 课`;
            let singer = '张老师特别课程';
            let imgSrc = 'xxx.jpg';
            // 封装成 播放器支持的对象
            return {
              src,
              name,
              singer,
              imgSrc
            }
          });
          // 获取本地存储的最后播放的音频内容
          const historyItem = JSON.parse(uni.getStorageSync('lastPlay') || '{}');
          // 如若没有 从头开始播放
          if (!historyItem) {
            return this.befoIndex = 0;
          }
          // 若有 对请求得到的数据进行比较 尝试获取下标
          const index = this.arrList.findIndex(e => e.src === historyItem.src);
          this.befoIndex = index === -1 ? 0 : index;
        }
      })
    },
  },
  // 组件中音频播放完成后的事件
  storageIndex(item) {
    // 为本地存储 lastPlay 下存储该条对象
    uni.setStorageSync('lastPlay', JSON.stringify(item));
  }
}
</script>