更新记录

1.2.1(2023-06-13) 下载此版本

  • 修复了某些情况下,字幕不会跟着音频滚动的问题

1.2.0(2023-06-13) 下载此版本

  • 优化了字幕切换的判断逻辑,使其能在用户跳转到某时段能更 及时的 进行字幕对应的切换

1.1.0(2023-06-02) 下载此版本

  • 增加了 click 单击事件的传递
  • 增加了 SeekDataUp 手指滑动事件,并向外提供滑动的距离参数 px
查看更多

平台兼容性

Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
app-vue × × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × × × ×

计划更新的内容

  • [x] 基础功能 随时间戳滚动的字幕
  • [x] 自定义显示的字幕行数、样式
  • [x] 触摸滑动带动歌词与歌曲进度同步滚动

组件介绍

一个简单的字幕滚动组件, 目前是使用了相对定位绝对定位,组件会随着传入的时间用 top 值指定位置

该组件为歌词组件 适用于搭配 smm-audio 组件

注意传入的歌词数据格式应该为 (例子):

[
    { time: '0:00:05.22', ylc: '全名制作人大家好\r' },
    { time: '0:00:08.78', ylc: '我是练习时常两年半的个人练习生\r' },
     ... 
]

参数传递

参数 说明 默认值
lyricList 歌词列表,传入对应歌词数组对象 []
curTime 播放歌曲的时间戳 (单位:秒) 0
lineItem 歌词显示的行数 15
mask 幕布上下两侧是否使用遮罩 true
bgColor 幕布背景颜色 #66ccff
lyricWh 幕布区域整体高度 400

事件向外提供

参数 说明
dblclick 双击事件
SeekDataUp 触摸滑动事件 会返回滑动的距离 整数参数

使用演示

<template>
    <view class="content">
        <smm-lyricBar class="openItem" :lyricList='lyricList' :curTime='nowTime' :lyricWh='lyricWh' v-show="isOpen"
            @dblclick='dblclickFn'></smm-lyricBar>
        <smm-audio :srcList='arrList' :lastSongIndex='befoIndex' :directory="true" :dirHight="wh" @timeupdate='showLyric'
            @playChangeIndex='storageIndex' @openLyric='openLyricFn'></smm-audio>
    </view>
</template>

<script>
export default {
    data() {
        return {
            lyricList: [],
            arrList: [],
            wh: 0,
            nowTime: 0,
            // 上一个记录
            befoIndex: 0,
            lyricWh: 0,
            isOpen: false
        };
    },
    onLoad() {
        // 获取设备信息
        const info = uni.getSystemInfoSync();
        // 为当前 可用高度对应变量进行赋值
        this.wh = info.windowHeight - 100;
        this.lyricWh = info.windowHeight;
    },
    created() {
        this.getSongList();
    },
    watch: {
        isOpen(newVal) {
            if (newVal) {
                uni.showToast({
                    title: '双击可关闭字幕滚动',
                    icon: 'none'
                })
            }
        }
    },
    methods: {
        //....
        // 网络请求获取歌词数据
        GetLyricData(id) {
            uni.request({
                url: 'http://网络请求接口',
                method: 'GET',
                data: {
                    songId: id
                },
                success: ({
                    data: res
                }) => {
                    this.lyricList = res.data;
                }
            });
        },
        // 获取当前音乐播放的时间段 单位:秒
        showLyric(e) {
            const nowTime = Math.floor(e.detail.currentTime);
            this.nowTime = nowTime;
        }
}

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问