CloudStream 无广告流媒体安装指南:装好扩展插件的完整上手流程
【免费下载链接】cloudstreamAndroid app for streaming and downloading media.项目地址: https://gitcode.com/GitHub_Trending/cl/cloudstream
CloudStream 是一款无广告的 Android 流媒体播放器,靠扩展插件系统接入各类内容源,手机与 Android TV 双端通用,按本文操作,大约 5 分钟就能装好并开始播放。
它到底能做什么
在动手之前,先花 30 秒搞清楚这东西的定位:
- 轻量且无广告:没有广告位,也没有任何追踪和统计代码,装完就是干净的播放体验
- 可扩展的插件系统:应用本身不带任何内容源,所有片源都来自你安装的扩展插件——这是它最核心的设计
- 手机 / Android TV 双端:同一套逻辑适配手机、平板和 TV 盒子,遥控器、触控屏都能用
- Chromecast 投屏:播放时可把画面投到电视,实现见 AndroidManifest.xml 中注册的 cast 框架配置
- 书签与观看记录:收藏和进度会记在本地,下次接着看
注意:首次装完应用是"空"的,必须安装扩展才有内容可播。插件机制的源码在 plugins/,更多背景看 README。
装之前先确认这三件事
安装前检查清单,三样都满足再往下走:
- 系统版本:Android 6.0(API 23)及以上。项目构建配置中的最低支持版本定义在 gradle/libs.versions.toml
- 未知来源权限:CloudStream 不在应用商店上架,安装前需要在"设置 → 安全"里允许对应来源安装应用
- 存储空间:预留至少 100MB;之后还要给下载的视频留足空间
跟着做,两步装好
第一步:拿到安装包
二选一:
下载 APK从项目官方文档页获取最新版安装包,保存到手机。
从源码构建(适合开发者)
git clone https://gitcode.com/GitHub_Trending/cl/cloudstream cd cloudstream ./gradlew assembleDebug构建完成后在app/build/outputs/apk/debug/目录下取 APK。
第二步:授权并安装
- 打开文件管理器,进入下载目录
- 点击 APK 文件,按系统提示允许"未知来源应用安装"
- 点击"安装",等待完成
TV 设备则用 U 盘拷入或 ADB 推送安装,全程遥控器操作即可。
装好之后:装插件、投屏、下视频
安装完成只是开始,真正用起来分三个场景:
给 CloudStream 装扩展
- 打开应用,进入"设置 → 扩展"
- 点击"添加仓库",粘贴扩展源地址
- 刷新后勾选需要的扩展,等待安装完成
装好扩展后回到首页搜索,能出结果就说明链路通了。
用 Chromecast 投到电视
- 确认手机和 Chromecast 在同一局域网
- 开始播放视频,点右上角投屏图标
- 选择目标设备,画面即切到电视
配置视频下载
- 进入"设置 → 下载",选择存储位置(内部存储或 SD 卡)
- 播放时点下载按钮,文件会存到指定目录
- 没网时直接在"下载"列表里离线观看
卡住了看这里
APK 装不上?依次核对:系统是否 Android 6.0 以上、"未知来源"权限是否真的开启、换一份最新版本的 APK 再试。
扩展装好了却没内容、视频播不了?先检查网络连通性,再把扩展更新到最新版,最后换一个不同的视频源试试——多数播放问题出在源本身。
以上就是 CloudStream 从安装到出片的全部流程。卡在某一步时,去项目的 Discord 社区提问,或在 GitHub Issues 里搜索是否有同类反馈,都能更快解决问题。
【免费下载链接】cloudstreamAndroid app for streaming and downloading media.项目地址: https://gitcode.com/GitHub_Trending/cl/cloudstream
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考