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

项目简介

本项目是一个基于 ArkUI-X 和 ArkTS 的跨平台实时视频直播应用，支持 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 皮肤定制

---

致谢

• ArkUI-X
• FFmpeg
• IjkPlayer