ywl5320/wlmedia：Android&HarmonyOS Next 音视频播放器S

技术解读

以下内容由 GitRead 中文社区编辑团队基于项目 README 与官方资料整理，结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

ywl5320/wlmedia 深度技术分析

项目背景与痛点

随着移动设备和智能设备的普及，音视频内容消费日益增加。然而，实现多媒体播放功能的传统方法复杂且难以维护，不仅需要处理多种流媒体协议（如 HTTP、RTSP、RTP 和 RTMP），还需要支持各种音视频格式和加密。传统的播放器开发需要大量的代码和时间，配置复杂且难以调试。ywl5320/wlmedia 解决了这个痛点，提供一个高度灵活、功能丰富的音视频播放器 SDK，允许开发者以最少的代码实现复杂的多媒体播放功能。

核心技术揭秘

架构与设计思想

wlmedia 项目以其灵活的设计和强大的功能而著称。它的架构设计主要依赖于模块化和可扩展性原则。以下是一个简化的架构图，展示了其技术栈和数据流。

graph TD A[用户应用] --> B[PlaybackManager] B --> C[ResourceManager] C --> D[MediaSource] D --> E[Decoder] E --> F[Renderer] F --> G[SurfaceRenderer] H[MediaControl] --> B I[MediaObserver] --> B

PlaybackManager：这是整个 SDK 的驱动器，负责调度和管理各模块。它监控用户操作并响应相应的事件。例如，用户请求播放时，PlaybackManager 会触发一系列逻辑处理。
ResourceManager：管理各种逻辑资源。这包括媒体源（MediaSource）、解码器（Decoder）以及渲染器（Renderer）的实例化和销毁。
MediaSource：负责打开和读取不同类型的媒体流源。它可能需要支持多种流媒体协议（如 RTSP、RTP、RTMP）以及处理本地文件的流。
Decoder：对媒体流数据进行解码，可以是音频或视频。考虑到性能和兼容性问题，Adapter 机制允许动态切换软解码器或硬解码器。
Renderer：负责呈现视频和音频数据，它可以使用不同的渲染接口，如 Surface、TextureView 或 OpenGL。
SurfaceRenderer：专用的渲染接口，确保视频输出符合屏幕特性。
MediaControl：控制模块，负责传递播放控制事件（如暂停、停止、播放速度调节）。
MediaObserver：观察者模式的实现，用于接收和响应播放事件，如播放缓冲、错误通知等。

wlmedia 通过上述模块化的方式，不仅提升了代码的可重用性，更让开发者能够快速集成和扩展功能。这种设计使得开发者能够实现诸如循环播放、音轨或字幕切换、视频截图以及多实例播放等高级功能。

功能亮点与差异

在众多多媒体播放器SDK中，wlmedia 立足于独特的功能和高级体验。其显著特性包括：

多协议支持：支持多种流媒体协议（HTTP、HTTPS、RTSP、RTP、RTMP），使得其具有极高的通用性和兼容性。
源码级透明与扩展性：提供完整的源代码，不仅使得功能扩展变得简单直接，还允许开发者针对特定需求进行优化。
硬件加速支持：能够自动适配设备的硬件解码能力，提供卓越播放性能。
多实例播放示范：允许同时播放多个音频或视频流，适用于复杂的多媒体交互项目。
灵活播放控制：通过 MediaControl 提供广泛的播放控制，包括变速播放、字幕切换以及硬件配置调整。

这些独特设计不仅提升用户开发体验，而且优化实际应用中的性能表现，在同类竞品中具有显著优势。

应用场景与落地建议

这个 SDK 适合广泛的应用场景，包括但不限于智能手机、平板电脑、车载信息娱乐系统、智能电视以及其他相对简单的 IOT 设备。

开发时的注意事项：
- 确保调整Surface类型以匹配目标设备的渲染特性。
- 适当处理音频/视频硬件优化，确保兼容性。
- 为不同的流媒体协议准备预备方案，以提高播放的可靠性。
性能优化建议：
- 提前进行解码能力查询并配置合适的解码器, 减少运行时调整带来的延迟和卡顿。
- 考虑动态调整播放速率，以适应不同网速情况，防止长期缓冲。
扩展建议：
- 根据具体需求，自定义特定播放控制事件和渲染逻辑。
- 测试各种极端情况下的稳定性，比如多实例多个媒体源的并行播放。

综合评价

wlmedia 作为一款多媒体播放器 SDK，实现了内容广泛的播放协议支持与多维度的自定义控制能力。它的模块化设计和高度可扩展性保证其在不同场景下的广泛适用性。但需要注意的是，其庞大的功能可能导致包体积较大，对于资源受限设备来说，开发时需注意优化和调整。

核心优点：

多协议与文件格式支持，提升了适配能力和兼容性。
灵活且高度可扩展的架构，可适应开发者的多元场景需求。
完整的源代码，有利于解决功能扩展和深度优化。

核心缺点：

包体积较大，对于轻量级别的设备可能存在资源占用过高问题。
作为SDK的复杂度较高，初学者或简单用例的使用可能不够友好。

总结而言，ywl5320/wlmedia 是一款鲁棒性强、功能丰富的多媒体播放器 SDK，适合于各种复杂应用的开发。

🚀wlmedia🚀 English 中文

Android&HarmonyOS Next 音视频播放SDK，几句代码即可实现音视频播放功能~

使用简单，功能丰富，支持手机、车机系统、电视、电视盒子、手表等智能设备

源码可售，有意请联系：[email protected]

一功能&特点

二效果展示

Android

常规播放	透明视频	多Surface渲染	多实例播放	播放音频	音量分贝

HarmonyOS

常规播放	透明视频	多Surface渲染	多实例播放	播放音频	音量分贝

三性能对比

Android

VS exoplayer

设备：Xiaomi Redmi Note 7
资源：big_buck_bunny_cut.mp4

exoplayer	wlplayer(no opengl)	wlplayer(use opengl)	wlplayer 实时

四集成使用

4.1 Android

4.1.1 gradle

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}
    
dependencies {
        implementation 'com.github.ywl5320:wlmedia:4.2.0'
}

4.1.2 常用权限

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.INTERNET"/>

4.1.3 配置NDK编译平台

defaultConfig {
   ...
   ndk {
       abiFilter("armeabi-v7a")
       abiFilter("arm64-v8a")
       abiFilter("x86")
       abiFilter("x86_64")
       }
...
}

4.1.4 设置Surface

<-- WlSurfaceView 一般播放使用 -->
<com.ywl5320.wlmedia.widget.WlSurfaceView
    android:id="@+id/wlsurfaceview"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

<-- WlTextureView 需要做透明、移动、旋转等使用 -->
<com.ywl5320.wlmedia.widget.WlTextureView
    android:id="@+id/wltextureview"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

4.1.5 基础调用代码（更多功能见Demo）

// 1.创建播放器
WlPlayer wlPlayer = new WlPlayer();
wlPlayer.setOnMediaInfoListener(new WlOnMediaInfoListener() {
   @Override
   public void onPrepared() {
       // 异步准备好后回调，这里调用 wlplayer.start() 开始播放
       wlPlayer.start();
   }

   @Override
   public void onTimeInfo(double currentTime, double bufferTime) {
       // 时间进度回调 
   }

   @Override
   public void onComplete(WlCompleteType wlCompleteType, String s) {
       // 播放完成回调，根据 WlCompleteType 区分对应类型
       if (wlCompleteType == WlCompleteType.WL_COMPLETE_EOF) {
           // 正常播放完成
       } else if (wlCompleteType == WlCompleteType.WL_COMPLETE_ERROR) {
           // 播放出错，原因为：msg 字段
       } else if (wlCompleteType == WlCompleteType.WL_COMPLETE_HANDLE) {
           // 主动调用 wlPlayer.stop() 会回调此类型
       } else if (wlCompleteType == WlCompleteType.WL_COMPLETE_NEXT) {
           // 正在播放中，切换了新的数据源，会回调此类型
       } else if (wlCompleteType == WlCompleteType.WL_COMPLETE_TIMEOUT) {
           // 播放超时，会回调此接口
       } else if (wlCompleteType == WlCompleteType.WL_COMPLETE_LOOP) {
           // 循环播放中，每开始新的一次循环，会回调此接口
       }
   }

   @Override
   public void onLoad(WlLoadStatus loadStatus, int progress, long speed) {
       // 加载状态回调
       if (wlLoadStatus == WlLoadStatus.WL_LOADING_STATUS_START) {
           // 开始加载
       } else if (wlLoadStatus == WlLoadStatus.WL_LOADING_STATUS_PROGRESS) {
           // 加载进度
       } else if (wlLoadStatus == WlLoadStatus.WL_LOADING_STATUS_FINISH) {
           // 加载完成
       }
   }

   @Override
   public void onSeekFinish() {
       // seek 完成回调
   }

   @Override
   public void onFirstFrameRendered() {
       // 首帧渲染回调
   }
});

// 2.获取 WlSurfaceView 并绑定播放器
WlSurfaceView wlSurfaceView = findViewById(R.id.wlsurfaceview);
wlSurfaceView.setWlPlayer(wlPlayer);
// 可选
wlSurfaceView.setClearLastVideoFrame(false); // 设置不清屏
wlSurfaceView.setVideoScale(WlScaleType.WL_SCALE_FIT); // 设置缩放模式
wlSurfaceView.setVideoRotate(WlRotateType.WL_ROTATE_90); // 设置旋转角度
wlSurfaceView.setVideoMirror(WlMirrorType.WL_MIRROR_TOP_BOTTOM); // 设置镜像模式

// 3.设置数据源异步准备
wlPlayer.setSource(url);
wlPlayer.prepare();

4.2 HarmonyOS Next

4.2.1 导入SDK 仓库地址

ohpm i @ywl5320/libwlmedia

4.2.2 常用权限

#module.json5
"requestPermissions": [
    {
    "name": "ohos.permission.INTERNET"
    }
]

4.2.3 设置XComponentController

let wlPlayer: WlPlayer = new WlPlayer();
let wlComponentController: WlComponentController = new WlComponentController(this.wlPlayer);
...
XComponent({
        type: XComponentType.SURFACE,
        controller: this.wlComponentController
    })
    .width('100%')
    .height('100%')
...

4.2.4 基础调用代码（更多功能见Demo）

@Entry
@Component
struct Index{
    private wlPlayer: WlPlayer | null = null;
    private wlComponentController: WlComponentController | null = null;

    aboutToAppear(): void {
        this.wlPlayer = new WlPlayer();
        this.wlPlayer.setOnMediaInfoListener({
        onPrepared: (): void => {
            // 异步准备好后回调，这里调用 wlplayer.start() 开始播放
            this.wlPlayer?.start();
        },
        onTimeInfo: (currentTime: number, bufferTime: number): void => {
            // 时间进度回调 
        },
        onComplete: (wlCompleteType: WlCompleteType, msg: string): void => {
            if (wlCompleteType == WlCompleteType.WL_COMPLETE_EOF) {
                // 正常播放完成
            } else if (wlCompleteType == WlCompleteType.WL_COMPLETE_ERROR) {
                // 播放出错，原因为：msg 字段
            } else if (wlCompleteType == WlCompleteType.WL_COMPLETE_HANDLE) {
                // 主动调用 wlPlayer.stop() 会回调此类型
            } else if (wlCompleteType == WlCompleteType.WL_COMPLETE_NEXT) {
                // 正在播放中，切换了新的数据源，会回调此类型
            } else if (wlCompleteType == WlCompleteType.WL_COMPLETE_TIMEOUT) {
                // 播放超时，会回调此接口
            } else if (wlCompleteType == WlCompleteType.WL_COMPLETE_LOOP) {
                // 循环播放中，每开始新的一次循环，会回调此接口
            }
        },
        onLoadInfo: (loadStatus: WlLoadStatus, progress: number, speed: number): void => {
            // 加载状态回调
            if (wlLoadStatus == WlLoadStatus.WL_LOADING_STATUS_START) {
            // 开始加载
            } else if (wlLoadStatus == WlLoadStatus.WL_LOADING_STATUS_PROGRESS) {
            // 加载进度
            } else if (wlLoadStatus == WlLoadStatus.WL_LOADING_STATUS_FINISH) {
            // 加载完成
            }
        },
        onFirstFrameRendered: (): void => {
            // seek 完成回调
        },
        onSeekFinish: (): void => {
            // seek 完成回调
        },
        onAudioInterrupt: (type: WlAudioInterruptType, hint: WlAudioInterruptHint) => {
            // 音频打断，和系统一致
        }
        this.wlComponentController = new WlComponentController(this.wlPlayer);
        this.wlPlayer.setClearLastVideoFrame(this.wlComponentController.getUniqueNum(), false);
    }

    // 退出 销毁资源
    onBackPress(): boolean | void {
        this.wlPlayer?.release()
    }

    build() {
        Column() {
            XComponent({
          type: XComponentType.SURFACE,
          controller: this.wlComponentController
        })
          .onLoad((event) => {
            // 加载完成后就开始播放
            this.wlPlayer?.setSource(this.filesDir + "/huoying_cut.mkv");
            this.wlPlayer?.prepare();
          })
          .width('100%')
          .height('100%')
        }
    }
}

五免费和增值服务

WlMedia 是按应用根据 包名 定制的，分免费版和付费定制版

免费版

HarmonyOS Next鸿蒙平台免费
仅Android平台视频画面带有wlmedia水印，其余功能无限制

增值版

如要定制去水印，可付费根据包名定制打包，具体费用和规则请邮件联系：
- 邮箱：[email protected]

wlmedia

技术解读

ywl5320/wlmedia 深度技术分析

项目背景与痛点

核心技术揭秘

架构与设计思想

功能亮点与差异

应用场景与落地建议

综合评价

相关仓库

关于

简要分析

语言占比

Release

贡献者

🚀wlmedia🚀 English 中文

Android&HarmonyOS Next 音视频播放SDK，几句代码即可实现音视频播放功能~

使用简单，功能丰富，支持手机、车机系统、电视、电视盒子、手表等智能设备

源码可售，有意请联系：[email protected]

一 功能&特点

二 效果展示

Android

HarmonyOS

三 性能对比

Android

VS exoplayer

四 集成使用

4.1 Android

4.1.1 gradle

4.1.2 常用权限

4.1.3 配置NDK编译平台

4.1.4 设置Surface

4.1.5 基础调用代码（更多功能见Demo）

更多使用方式

4.2 HarmonyOS Next

4.2.1 导入SDK 仓库地址

4.2.2 常用权限

4.2.3 设置XComponentController

4.2.4 基础调用代码（更多功能见Demo）

更多使用方式

五 免费和增值服务

免费版

增值版

六 讨论群（1085618246）

七 核心三方库

Update By：ywl5320 2025-04-05

Create By：ywl5320 2019-12-16

评论

一功能&特点

二效果展示

三性能对比

四集成使用

五免费和增值服务

六讨论群（1085618246）

七核心三方库