目录
目录README.md

跨平台实时视频直播播放器 (ArkUI-X + FFmpeg)

项目简介

本项目是一个基于 ArkUI-XArkTS 的跨平台实时视频直播应用,支持 Android / OpenHarmony / iOS 多端运行。
应用集成了 **IjkMediaPlayer (FFmpeg 内核)**,实现了 RTMP / RTSP 等流媒体协议的实时播放,结合 ArkUI-X 的跨平台 UI 能力,提供一致的用户体验。


功能特性

  • 跨平台支持:一次开发,支持多端运行(HarmonyOS、OpenHarmony、Android、iOS)。
  • 流媒体播放:支持 RTMP / RTSP / HTTP 等协议。
  • 基础播放控制
    • ▶️ 播放 / 暂停
    • ⏩ 倍速播放(1x / 1.5x / 2x)
    • ⏪ 拖动进度条跳转
  • 屏幕交互
    • 📱 全屏切换(横竖屏适配)
    • ✋ 手势控制:右侧上下滑动调节音量、左侧上下滑动调节亮度
  • 增强功能
    • 📸 截图并保存到相册
    • 🎥 视频录制并保存
    • 🔊 静音 / 恢复音量
  • UI 交互优化
    • ⏱️ 控制条自动隐藏(无操作时自动淡出)
    • HUD 提示(实时显示音量/亮度变化)

技术架构

  • 前端框架:ArkUI-X, ArkTS
  • 原生播放引擎:IjkMediaPlayer (基于 FFmpeg)
  • 跨端能力:XComponent + NAPI 与 Native 层交互
  • 多媒体处理:FFmpeg 解码、截图、录制

快速开始

环境准备

  1. 安装 DevEco Studio
  2. 配置 ArkUI-X 跨平台开发环境
  3. 使用lycium工具完成ffmpeg、openh264、openssl等库的编译,并将其放入src/main/cpp/third_party目录的相应位置

运行步骤

# 克隆仓库
git clone https://github.com/yourname/arkui-x-video-player.git

# 使用 DevEco Studio 打开项目
# 选择运行目标(OpenHarmony / Android / iOS)
# 编译并运行

使用说明

  • 播放视频:输入视频 URL(支持 http / rtmp / rtsp),点击播放。
  • 全屏切换:点击右下角全屏按钮,自动横屏。
  • 音量/亮度调节:上下滑动屏幕右/左侧区域。
  • 截图:点击截图按钮,保存到相册。
  • 录制:点击录制按钮,开始/停止录制。

📌 未来改进方向

  • 支持更多协议(HLS、DASH)
  • 增加弹幕功能
  • 优化弱网环境下的延迟与卡顿
  • UI 皮肤定制

致谢

关于
486.4 MB
邀请码
    Gitlink(确实开源)
  • 加入我们
  • 官网邮箱:gitlink@ccf.org.cn
  • QQ群
  • QQ群
  • 公众号
  • 公众号

©Copyright 2023 CCF 开源发展委员会
Powered by Trustie& IntelliDE 京ICP备13000930号