RTMP-Box-Preview

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

RTMP-Box-Preview

★ 9 Open GitHub ↗

RTMP Box Preview 是一款轻量级、高性能的 Android RTMP 服务器工具。它允许您将手机变身为流媒体服务器，接收来自 Xiaomi AI Glass、OBS、 FFmpeg 或运动相机的视频推流，并支持实时预览与本地录制。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# RTMP Box Preview

📱 软件简介  
RTMP Box Preview 是一款轻量级、高性能的 Android RTMP 服务器工具。它允许您将手机变身为流媒体服务器，接收来自 Xiaomi AI Glass、OBS、FFmpeg 或运动相机的视频推流，并支持实时预览与本地录制。

---

## 🚀 快速开始

### 启动服务
- 确保手机已连接 Wi-Fi（推荐）或开启热点。
- 点击底部的 “启动服务器” 按钮。

### 获取推流地址
- 顶部状态栏会显示当前的推流地址，格式通常为：`rtmp://192.168.x.x:1935/live/stream`。
- 点击地址右侧的 复制图标 即可复制到剪贴板。

### 开始推流
- 在推流端（如 Xiaomi AI Glass, OBS 等）填入上述地址，开始推流。

### 预览画面
- 推流成功后，开启 “预览” 开关，即可在手机屏幕上实时查看视频画面。

---

## 🎥 视频录制指南
本软件支持将接收到的视频流保存到本地相册。请在录制前根据需求选择合适的封装格式：

### 选项 A：FLV 格式（🛡️ 安全推荐）
- 适用场景：取证录像、长途记录、环境不稳定的长时间录制。
- 特点：采用流式写入技术。极度安全，即使录制过程中遭遇 App 闪退、手机断电或被系统强制杀后台，已录制的内容依然完好无损。
- 注意：部分系统相册可能无法直接预览，建议使用 VLC 或 MX Player 播放。

### 选项 B：MP4 格式（📤 分享推荐）
- 适用场景：短视频录制、需要快速分享给朋友。
- 特点：兼容性极佳，录制后可直接在系统相册查看，支持一键分享到微信、QQ 等平台。
- ⚠️ **风险警告**：抗风险能力差。MP4 必须正常点击“停止”才能生成文件索引。如果录制意外中断（如崩溃、断电），整个视频文件将损坏且无法修复。

---

## ❓ 常见问题 (Q&A)
### Q: 为什么推流连接失败？
A: 请检查推流设备（如 OBS、智能眼镜）是否与手机连接在同一个 Wi-Fi 网络或热点下，并确认 IP 地址输入无误。

### Q: 录制的视频保存在哪里？
A: 视频默认保存在手机内部存储的 `DCIM/RtmpVideo` 目录下。

### Q: 为什么录制的 FLV 视频无法播放？
A: FLV 是流媒体专用格式，大多数手机自带的系统播放器不支持该格式。请下载安装 VLC for Android、MX Player 或 IINA 等第三方全能播放器进行观看。

### Q: 为什么在系统相册里找不到录制的 FLV 视频？
A: 由于系统相册无法识别 FLV 格式，通常会自动将其隐藏（虽然文件真实存在）。
- 方法 1：使用 “文件管理” App，进入 `DCIM/RtmpVideo` 文件夹即可找到。
- 方法 2：打开 VLC 等第三方播放器，它们通常能扫描并显示出这些视频。

### Q: 为什么录制的 MP4 视频提示“文件损坏”或无法播放？
A: 这通常是因为录制过程意外中断（如：手机没电关机、App 崩溃或被强行划掉后台）导致的。
- 原因：MP4 格式必须在点击“停止”按钮后写入文件索引才能生效。如果没有正常结束，文件虽然占用了空间，但实质上已经彻底损坏且极难修复。
- 建议：对于不可重来的重要录制，请务必使用 FLV 格式，它不怕断电。

---

## 📋 关于软件与声明 (About & Disclaimer)
### ⚠️ 版权与用途声明
- 非开源软件：本软件为非开源软件，不提供源代码下载。
- 用途限制：本软件仅供个人开发、学习及合法的技术交流使用。
- 合法使用承诺：您在使用本软件时，必须承诺并保证遵守您所在国家或地区的所有适用法律法规。严禁将本软件用于任何非法用途，包括但不限于：
  - 侵犯他人隐私、肖像权或进行非法监控。
  - 传播暴力、淫秽、诽谤等违法或不良信息。
  - 干扰或破坏任何网络、设备或服务的正常运行。
  - 任何其他违反当地法律或法规的行为。
- 二次开发限制：未经开发者书面授权，严禁将本软件用于任何商业用途或进行二次分发、破解及逆向工程。

### 💝 这是一款免费软件
- 完全免费：RtmpBox Preview 是一款由我个人开发和维护的免费软件。你无需为使用其核心功能支付任何费用。
- 警惕“李鬼”：软件仅通过 GitHub 发布。如果你在任何其他网站、应用商店、论坛或网盘找到此软件，它们均为非官方、未授权且可能被篡改的版本。请勿下载，此类软件可能携带病毒、恶意代码（如挖矿程序）或窃取你的隐私数据。

---

## 📱 系统要求与兼容性 (Compatibility)
为了确保软件的稳定运行，请确认您的设备满足以下条件：
- 最低要求：Android 11 (API 30) 及以上。
- 推荐配置：支持 H.264 (AVC) 硬件编码的设备，以获得流畅的 1080P 录制体验。

### ✅ 已验证推流硬件 (Tested RTMP Source)
- 硬件：Xiaomi AI Glass (智能眼镜)
- 版本：版本：固件 V1.4.16.0新固件1.6.12.0 / 软件 v2.5.11新版3.1.27
- 状态：推流稳定，延迟低

### ✅ 已验证运行环境 (Server Host)
- 移植环境：Xiaomi 11 Lite (HyperOS 2.0.2.0 / Android 14) - 言十二科技移植版，完美运行
- 移植环境：Xiaomi 15 Ultra (HyperOS 3.0.6.0 / Android 16) - 兼容性良好
- 注：低于 Android 11 的系统可能无法安装或解析本软件。

---

## 🛡️ 极严免责声明 (Liability Disclaimer)
本软件按“原样”提供。开发者不对使用本软件产生的任何后果承担责任，包括但不限于：

- **数据丢失**：因软件崩溃、断电或选择 MP4 格式录制导致的文件损坏。
- **硬件损坏**：由于视频编解码和高速写入属于高负载任务，开发者对因使用本软件可能导致的任何硬件损伤（包括但不限于设备过热、电池损耗、屏幕老化、存储芯片寿命缩减等）概不负责。

请用户根据设备性能酌情使用，并自行承担所有风险。

---

## 🔒 隐私政策
本软件为纯本地应用。所有的视频数据流处理、预览及录制均在您的设备本地完成，不会上传至任何云端服务器，也不会收集您的任何个人隐私信息。

---

## 👨‍💻 开发与致谢
- 开发者：本程序由个人开发者 BAIMAXXIAOBAI 开发。
- 技术支持：项目开发过程中使用了 OpenAI ChatGPT 与 Google Gemini Pro 进行辅助编码与技术支持。

### 📦 核心技术致谢
本软件虽然不开源，但其构建基于以下优秀的开源技术与组件（遵循 Apache 2.0 等开源协议）：
- Kotlin: 本应用的主要编程语言，提供安全、简洁的开发体验。 (License: Apache 2.0)
- Jetpack Compose: Google 推出的现代 Android 原生 UI 工具包。 (License: Apache 2.0)
- Kotlin Coroutines (协程): 用于高效处理网络流媒体数据的异步并发任务。 (License: Apache 2.0)
- Material Design 3: 提供美观的现代化用户界面组件与动态配色支持。 (License: Apache 2.0)
- Android Jetpack: 包含 Lifecycle, ViewModel 等核心架构组件。 (License: Apache 2.0)

RTMP-Box-Preview

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README