更新记录

1.0.0（2026-09-03）

• 初始化项目框架
• 支持 MP4/H265/FLV/HLS 多格式播放
• 支持 RTMP/HTTP-FLV/HLS 直播拉流
• H265 硬件解码（自动检测 + 软解回退）
• 直播自动重连（指数退避策略）
• 全屏/退出全屏
• 音量、亮度、倍速控制
• 画面适配模式（fit/fill/crop）
• 截图功能
• Android/iOS/HarmonyOS 三端兼容

平台兼容性

uni-app x(5.0)

d-video-player

uni-app x UTS 原生视频播放器插件

支持 H265 硬解、FLV/HLS/RTMP 直播拉流，提供完整的播放器 API，兼容 Android/iOS/HarmonyOS 三端。

特性

• MP4、H265、FLV、HLS 多格式支持
• 直播拉流：RTMP、HTTP-FLV、HLS
• H265 硬件解码（自动检测，软解回退）
• 自动重连（指数退避策略）
• 全屏/退出全屏
• 音量/亮度控制
• 倍速播放（0.25x-4.0x）
• 画面适配（fit/fill/crop）
• 截图（base64）
• 直播流切换到

安装

// manifest.json
{
  "uni_modules": {
    "d-video-player": {
      "version": "1.0.0"
    }
  }
}

快速开始

import { VideoPlayer } from '@/uni_modules/d-video-player'

const player = new VideoPlayer()

// 初始化
player.create({ width: 300, height: 200 })

// 加载点播
player.setSource({ url: 'https://example.com/video.mp4', type: 'auto' })
player.play()

// 加载直播
player.playLive({
  url: 'https://example.com/live.flv',
  protocol: 'auto',
  bufferDuration: 2000,
  reconnect: true,
  reconnectDelay: 3000,
  reconnectCount: 5
})

API

初始化

源配置

interface VideoSource {
  url: string
  type?: 'flv' | 'hls' | 'mp4' | 'rtmp' | 'auto'
  headers?: Record<string, string>
  startTime?: number
}

interface LiveSource {
  url: string
  protocol?: 'rtmp' | 'flv' | 'hls' | 'auto'
  headers?: Record<string, string>
  bufferDuration?: number        // 默认 2000ms
  minBufferDuration?: number     // 最小缓冲
  reconnect?: boolean             // 自动重连
  reconnectDelay?: number         // 重连间隔，默认 3000ms
  reconnectCount?: number         // 最大重连次数，默认 5
}

interface PlaybackConfig {
  autoplay?: boolean
  loop?: boolean
  muted?: boolean
  volume?: number
  playbackRate?: number
  isLive?: boolean
  enableH265?: boolean
  enableCache?: boolean
}

播放控制

状态查询

音视频控制

画面控制

全屏

事件

错误码

各平台限制

许可证

MIT