NidoPlay 使用手册

1. 下载与系统支持

iPhone 和 iPad 用户请通过 App Store 安装： NidoPlay。 Android 用户可下载安装包： NidoPlay Android APK。

支持 iOS。
支持 Android。
支持 HarmonyOS 2-4 兼容设备，使用 Android APK 安装。
HarmonyOS NEXT / 纯血鸿蒙暂不支持。

Android 或 HarmonyOS 2-4 设备安装 APK 时，系统可能提示允许浏览器、文件管理器或安装器安装外部应用。这是系统安装 APK 的常见提示；如果你不确定，请先通过微信或邮件联系确认设备兼容性。

2. 第一次使用

首次打开 NidoPlay 时，应用会显示隐私提示和本地文档。阅读后继续使用，即可进入首页。 NidoPlay 不需要注册账号，也不需要登录。

如果首页还没有媒体内容，会看到“选择媒体文件夹”或“添加媒体文件夹”入口。你需要主动选择一个本地文件夹，NidoPlay 才会扫描里面的音视频内容。

选择文件夹后，应用只读取你授权的目录。
扫描结果、缩略图、观看记录和播放设置保存在当前设备本地。
应用不会上传你的本地视频、音频、目录结构或观看记录。
如果系统提示文件夹权限，请选择允许，否则无法建立本地媒体库。

3. 准备本地资源

NidoPlay 适合整理已经保存到设备上的家庭音视频内容，例如动画、儿歌、英语启蒙、学习资料、故事音频和睡前内容。它不会帮你搜索片源，也不会下载内容。

推荐先在文件管理器或网盘客户端下载好内容，并整理成清楚的文件夹结构：

下载/
  动画合集/
    01.mp4
    02.mp4
  英语启蒙/
    Lesson 01.mp4
    Lesson 02.srt
  睡前故事/
    story-01.mp3
    story-02.m4a

选择文件夹时，建议选择“下载”这样的根目录。NidoPlay 会把下一层文件夹整理成媒体卡片，例如“动画合集”“英语启蒙”“睡前故事”。这样家人打开首页时，看到的是一组清晰的媒体卡片，而不是一堆散乱文件。

不要选择过高的系统根目录，否则扫描范围太大，内容会很乱。
不要只选择某一集所在的最深目录，否则首页可能只看到很少内容。
原始文件不会被移动、重命名或删除。
同名字幕请和视频放在同一文件夹，例如 01.mp4 旁边放 01.srt。

4. 添加媒体文件夹

在首页点击“选择媒体文件夹”或在设置里点击“添加文件夹”，选择你准备好的本地目录。

添加后，NidoPlay 会开始扫描：

检测文件变化。
扫描支持的视频和音频文件。
整理文件夹层级，生成本地媒体树。
生成或缓存封面、缩略图和扫描结果。

扫描完成后，首页会出现媒体卡片。以后再次打开应用，会尝试恢复已授权目录。如果目录移动、网盘缓存被清理、系统权限失效，设置页会提示重新选择对应文件夹以恢复扫描和播放。

支持的文件

常见视频：mp4、mkv、avi、mov、wmv、flv、webm、m4v。
常见音频：mp3、m4a、aac、flac、wav、ogg、opus 等。
外挂字幕：同名 srt、ass、ssa。
图片封面：jpg、jpeg、png、gif、webp、bmp。

是否能实际播放，还取决于当前系统和底层播放器的解码能力。文件扩展名命中不代表所有编码都一定能播放。

5. 浏览、整理与隐藏内容

首页和目录页会按文件系统层级展示内容。NidoPlay 支持自然排序，带数字的剧集名称会尽量按人能理解的顺序排列。你可以进入某个媒体卡片继续浏览子文件夹和视频，也可以使用搜索查找本地文件夹或音视频名称。

隐藏媒体卡片

如果某个文件夹或视频暂时不想显示，可以长按对应的媒体卡片进入多选模式。选中要隐藏的文件夹或视频后，点击顶部的“隐藏”，确认后这些内容就不会再出现在首页和目录页。

隐藏只影响 NidoPlay 的显示。
隐藏不会删除设备里的原始文件。
隐藏的文件夹和视频会集中到“设置 > 已隐藏内容”里管理。
在“已隐藏内容”里可以单个点击“恢复”。
也可以点击“全部恢复”，让所有隐藏内容重新出现在首页和目录列表。

移除媒体库记录

多选模式里还可能看到“删除”或移除相关操作。这里的删除不是删除磁盘文件，而是把所选项目从当前媒体库记录中移出；重新授权或重新扫描对应文件夹后，内容可以再次显示。

清除缓存

设置里的“清除缓存”会删除缩略图和扫描数据，并恢复已隐藏项目，然后自动重新扫描。观看历史和原始视频文件不会被删除。

6. 视频播放

点击视频即可进入播放器。播放器支持常见家庭观看需要的控制：

播放、暂停、上一集、下一集。
点击或拖动进度条跳转。
左右滑动快进或快退。
双击播放或暂停。
长按画面临时 3x 快进，松手后恢复原倍速。
左侧上下滑动调节亮度，右侧上下滑动调节音量。
点击“锁定”进入防误触模式，再点击“解锁”恢复控制。
点击“倍速”选择 0.5x、0.75x、1x、1.25x、1.5x、2x。
点击“画面”切换适应、填充、16:9、4:3 等显示比例。

字幕

如果视频旁边有同名 srt、ass 或 ssa 字幕文件，播放器会尝试加载。字幕支持开关。字幕读取失败不会影响视频继续播放。

跳过片头片尾

播放器设置里有“跳过片头片尾”。你可以为当前文件夹保存片头秒数和片尾秒数，适合固定片头片尾的合集。设置会按文件夹保存。

视频定时停止

设置里可以配置“视频定时停止”。如果接近结尾，NidoPlay 会优先播完当前视频后停止，适合睡前或限定观看时间。

7. 音频与熏听

NidoPlay 支持本地音频播放，也支持把视频切换成“熏听”模式，只保留声音继续播放。这适合儿歌、故事、英语启蒙、睡前内容，或者把熟悉的视频当音频听。

音频支持播放、暂停、上一首、下一首、进度跳转和倍速。
支持单曲循环、顺序播放、列表循环。
支持音频定时停止，并带渐弱暂停。
关闭播放页后，可以通过悬浮迷你播放器继续控制音频或视频声音。
支持系统媒体控制，例如耳机、锁屏或系统播放控件。
Android / HarmonyOS 2-4 会使用前台媒体播放通知；iOS 支持后台音频模式。

如果你只想让孩子听声音而不看画面，可以先打开视频，再点击播放器里的“熏听”。需要回到画面时，点击“返回视频”。

8. 历史与续播

NidoPlay 会定期保存播放进度，也会在应用切到后台、退出播放页、投屏断开时保存进度。首页会显示继续观看入口，方便回到上次内容。

继续观看：回到首页即可看到最近的续播内容。
观看记录：设置里可以进入“观看记录”查看历史。
已看完状态：播放完成后会记录完成状态。
清空观看历史：设置里可以清空观看历史和续播进度，此操作不可恢复。

如果某个视频被隐藏，相关继续观看入口也会被隐藏，避免从首页绕回已隐藏内容。

9. 投屏

NidoPlay 的投屏只用于当前局域网，不用于外网播放、上传、账号、广告或统计。

iOS 使用系统 AirPlay 选择器。
Android / HarmonyOS 2-4 支持扫描 DLNA 设备。
Android / HarmonyOS 2-4 会通过局域网临时 HTTP 服务把当前本地视频提供给电视播放。
支持投屏播放、暂停、进度同步、跳转和断开。

投屏前请让手机和电视或投屏设备连接到同一个 Wi-Fi。Android / HarmonyOS 2-4 设备可能需要允许附近 Wi-Fi 设备或网络相关权限，这些权限只用于发现同一局域网内的 DLNA 设备和临时传输当前播放文件。

10. 隐私和边界

NidoPlay 是家庭本地媒体播放器，不是内容平台，也不是云盘或资源搜索工具。

NidoPlay 不做什么

不提供在线片源。
不提供内容下载。
不做账号登录。
不做云同步或云备份。
不上传你的本地媒体文件、目录结构或观看记录。
不做广告推荐流。
不做远程片单或跨设备媒体库。

保存在本机的数据

你授权的文件夹信息。
本地扫描结果和目录结构缓存。
缩略图、本地封面和显示设置。
观看历史、播放进度、播放设置和隐藏项目记录。

你可以在应用内清除缓存、观看历史和隐藏内容记录。也可以通过系统卸载应用删除应用本地数据。完整说明见 NidoPlay 隐私政策。