更新记录

1.0.0（2025-12-29）

支持短剧和电影播放

平台兼容性

uni-app(4.85)

其他

kozyax-video2025

简介 | كىرىش سۆز

kozyax-video2025 是一个功能强大的 uni-app 视频播放器组件，支持两种播放模式：全功能播放器(full)和短视频播放器(short)。

kozyax-video2025 بولسا كۈچلۈك ئىقتىدارلىق uni-app ۋىدىئو قويغۇچ زاپچىسى بولۇپ، ئىككى خىل قويۇش ھالىتىنى قوللايدۇ: تولۇق ئىقتىدارلىق قويغۇچ (full) ۋە قىسقا ۋىدىئو قويغۇچ (short).

安装 | ئورنىتىش

将 kozyax-video2025 文件夹复制到项目的 uni_modules 目录下即可。

kozyax-video2025 ھۆججەت قىسقۇچنى تۈرنىڭ uni_modules مۇندەرىجىسىگە كۆچۈرۈڭ.

基本使用 | ئاساسىي ئىشلىتىش

<template>
  <!-- 全功能播放器 | تولۇق ئىقتىدارلىق قويغۇچ -->
  <kozyax-video2025
    type="full"
    :src="videoUrl"
    :poster="posterUrl"
    :width="750"
    :height="450"
    @play="onPlay"
    @pause="onPause"
    @ended=""
    @timeupdate=""
  />

  <!-- 短视频播放器 | قىسقا ۋىدىئو قويغۇچ -->
  <kozyax-video2025
    type="short"
    :src="videoUrl"
    :poster="posterUrl"
    :height="screenHeight"
    @next="onNext"
    @prev="onPrev"
    @like="onLike"
  />
</template>

<script>
export default {
  data() {
    return {
      videoUrl: 'https://example.com/video.mp4',
      posterUrl: 'https://example.com/poster.jpg'
    }
  },
  methods: {
    onPlay() { console.log('播放 | قويۇلدى') },
    onPause() { console.log('暂停 | توختىدى') },
    () { console.log('结束 | تامام بولدى') },
    (e) { console.log('时间更新 | ۋاقىت يېڭىلاندى', e) },
    onNext() { console.log('下一个 | كېيىنكىسى') },
    onPrev() { console.log('上一个 | ئالدىنقىسى') },
    onLike() { console.log('点赞 | ياقتۇردى') }
  }
}
</script>

属性 Props | خاسلىقلار

通用属性 | ئورتاق خاسلىقلار

全功能播放器专用 (type="full") | تولۇق قويغۇچقا خاس

短视频播放器专用 (type="short") | قىسقا ۋىدىئو قويغۇچقا خاس

事件 Events | ۋەقەلەر

通用事件 | ئورتاق ۋەقەلەر

全功能播放器事件 (type="full") | تولۇق قويغۇچ ۋەقەلىرى

短视频播放器事件 (type="short") | قىسقا ۋىدىئو قويغۇچ ۋەقەلىرى

方法 Methods | ئۇسۇللار

通过 ref 调用组件方法：

ref ئارقىلىق زاپچاس ئۇسۇللىرىنى چاقىرىش:

// 获取组件引用 | زاپچاس پايدىلىنىشىنى ئېلىش
this.$refs.myVideo.play()
this.$refs.myVideo.pause()
this.$refs.myVideo.seek(60)
this.$refs.myVideo.changeUrl('https://new-url.mp4')

通用方法 | ئورتاق ئۇسۇللار

全功能播放器方法 (type="full") | تولۇق قويغۇچ ئۇسۇللىرى

短视频播放器方法 (type="short") | قىسقا ۋىدىئو قويغۇچ ئۇسۇللىرى

弹幕格式 | چالما فورماتى

danmuList: [
  {
    time: 5,           // 显示时间(秒) | كۆرسىتىش ۋاقتى (سېكۇنت)
    text: '弹幕内容',   // 弹幕文字 | چالما تېكىستى
    color: '#ffffff'   // 弹幕颜色 | چالما رەڭگى
  },
  {
    video_time: 10,    // 也支持 video_time | video_time نىمۇ قوللايدۇ
    text: '另一条弹幕',
    color: '#FF6969'
  }
]

注意事项 | دىققەت قىلىشقا تېگىشلىك

1. nvue 页面: 在 nvue 页面中使用时，确保组件正确引入。

   nvue بەت: nvue بەتتە ئىشلەتكەندە، زاپچاسنىڭ توغرا ئەكىرىلگەنلىكىنى جەزملەڭ.

2. 视频格式: 支持 mp4、m3u8 等常见格式。

   ۋىدىئو فورماتى: mp4، m3u8 قاتارلىق كۆپ ئۇچرايدىغان فورماتلارنى قوللايدۇ.

3. 全屏模式: 全屏功能在 APP 端效果最佳。

   تولۇق ئېكران ھالىتى: تولۇق ئېكران ئىقتىدارى APP تەرەپتە ئەڭ ياخشى ئىشلەيدۇ.

4. 弹幕功能: 弹幕在 nvue 和 vue 页面中使用不同的实现。

   چالما ئىقتىدارى: چالما nvue ۋە vue بەتلەردە ئوخشىمايدىغان ئەمەلگە ئاشۇرۇش ئىشلىتىدۇ.

版本 | نەشرى

v2025.1.0

作者 | ئاپتور

Kozyax Team

许可证 | ئىجازەتنامە

MIT License