GET STARTED & SUPPORT
新手指引与技术支持
新手指引：添加媒体库
GreenPlayer 播放您选择的媒体文件或服务器内容。请先准备自己的视频文件，或有权访问的服务器。
在“设置 → 帮助与反馈 → 新手指引”可随时重看教程；媒体库空白页有“查看添加教程”，播放器顶部的问号按钮提供操作说明。旧版没有这些入口时，可按下面的步骤操作。
本机或 iCloud Drive 文件夹
- 在媒体库顶部点击 ＋ → 添加本地文件夹。
- 在系统文件选择器中选择文件夹并确认授权，再点击“添加”。iCloud Drive 文件可能需要先下载。
- 回到媒体库，打开刚添加的文件夹，点击视频文件开始播放。
Jellyfin / Emby
- 在媒体库顶部点击 ＋，根据服务器选择 Jellyfin 或 Emby。
- 填写主机、端口、协议和服务器账号，点击“连接”。这是媒体服务器的账号，GreenPlayer 不需要注册账号。
- 打开刚添加的服务器，点击影片海报，在详情页点击“播放”；剧集可先选择一集。
示例地址 http://192.168.1.20:8096：主机填 192.168.1.20，端口填 8096，协议选 HTTP。主机不包含协议、端口或路径；若地址末尾有 /jellyfin 等路径，请单独填写“路径”，否则留空。端口以实际服务器设置为准。跨互联网连接请使用 HTTPS。
NAS / 网络共享
- 在媒体库顶部点击 ＋，根据 NAS 已开启的服务选择 SMB、WebDAV 或 FTP。
- 填写域名或 IP、服务端口、共享名称或目录路径，以及有访问权限的账号，点击“添加”。
- 打开刚添加的来源，进入视频所在目录，点击文件播放。
示例 smb://192.168.1.20/Movies：主机填 192.168.1.20，端口通常为 445，共享名称填 Movies。共享名称留空时会先列出可访问的共享。WebDAV 的目录路径由服务提供方指定；FTP 请在可信网络中使用。
新手指引：手势与快捷键
屏幕亮度↕ 右侧
播放音量← 后退 · 左右滑动调整进度 · 前进 →
iPhone / iPad
| 操作 | 功能 |
|---|---|
| 单击画面 | 显示或隐藏控制栏 |
| 双击画面 | 播放或暂停 |
| 单指或双指左右滑动 | 调整进度；向右前进，向左后退 |
| 画面左侧上下滑动 | 调整屏幕亮度；向上增加，向下减少 |
| 画面右侧上下滑动 | 调整音量；向上增加，向下减少 |
| 长按画面左侧 / 右侧 | 持续快退 / 快进扫描，松手结束 |
请在画面中部操作，避开顶部、底部按钮和中央分界处。长按扫描用于快速移动播放位置；正常播放速度请通过倍速菜单调整。
iPad 外接键盘可用空格播放或暂停，左右方向键按设置的跳转间隔后退或前进。请保持播放器位于前台，且未在输入框中编辑文字。
Mac
| 操作 | 功能 |
|---|---|
| 空格 | 播放或暂停 |
| ← / → | 后退或前进，秒数跟随“设置 → 跳转间隔” |
| ↑ / ↓ | 增大或减小音量 |
| Esc | 关闭播放；有帮助弹窗时先关闭弹窗 |
| 单击画面 | 显示或隐藏控制栏 |
| 双击画面 | 进入或退出全屏 |
| 触控板双指左右滑动 | 调整进度；向右前进，向左后退 |
| 触控板双指上下滑动 | 调整音量；向上增加，向下减少 |
触控板操作时请将指针放在播放器窗口内。这些手势与快捷键用于 App 内播放；投屏时请使用投屏遥控界面的可用控制。
常见问题
连接失败、找不到 NAS 或服务器怎么办？
先确认主机、端口、协议、路径和账号正确，服务器已开机且服务已启用。局域网连接需设备之间网络互通，并允许 GreenPlayer 使用本地网络。访客 Wi-Fi、AP 隔离、VPN 或 VLAN 规则可能阻止访问。跨互联网连接需由您或管理员正确配置访问地址和有效 HTTPS 证书。
连接成功后，媒体库为空怎么办？
确认服务器中已添加媒体库并完成扫描，且当前账号有权访问该媒体库。文件来源则检查共享名称、目录路径和账号权限。加密来源可能被隐藏，点击媒体库顶部锁按钮并完成身份验证后查看；Jellyfin / Emby 内容可使用刷新按钮重新加载。
如何投屏？为什么没有投屏按钮？
当前支持 Jellyfin / Emby 媒体服务器内容的 DLNA 投屏。播放影片后，点击播放器顶部电视图标，选择同一局域网内已启用 DLNA 接收功能的设备。投屏后使用遥控界面播放、暂停、拖动进度或停止；控制能力取决于接收设备。
本地文件夹、SMB、WebDAV 和 FTP 来源目前没有 DLNA 投屏入口；应用没有将这些文件转发给电视的本地媒体服务。当前投屏入口用于 DLNA，不包含 AirPlay 或 Chromecast 协议。
找不到电视怎么办？
确认电视与手机、平板或 Mac 在同一局域网，电视已开启 DLNA 接收，并已允许 GreenPlayer 使用本地网络。检查路由器是否限制组播或设备互访。电视有线连接、手机无线连接也可以，只要路由器允许它们相互发现和访问。
手机上能播放，投屏后为什么黑屏、无声或字幕缺失？
DLNA 投屏时，接收设备直接读取媒体地址并负责解码，手机的播放模式不会替电视解码。电视可能不支持视频编码、音轨、字幕格式或媒体封装；电视也必须能访问服务器地址，不能依赖只有手机能用的 VPN、请求头或登录方式。
尝试更换音轨、字幕或使用常见的 H.264/AAC MP4 文件确认设备能力。Jellyfin / Emby 服务端转换需要服务器和账号允许；转码能否解决还取决于服务器生成的流和电视支持范围。App 内兼容播放模式或外挂字幕的本机渲染能力不会自动转移到电视。
投屏画面拉伸、黑边、颜色或进度显示异常怎么办？
画面比例与颜色受视频本身、电视显示设置、HDR 支持和服务器输出影响。先检查电视的画面比例设置，关闭强制拉伸，并用普通 SDR 视频对照；原片自带黑边可能属于正常画面。
部分 DLNA 接收设备不能完整上报播放状态、时长或进度，遥控界面可能延迟，拖动也可能不可用。App 内画面比例设置不会直接改变电视画面。反馈时请提供电视型号、服务器类型、编码信息和具体异常表现。
视频无法播放、卡顿或字幕异常怎么办？
先在设置中将播放模式设为“自动”，检查网络速度和服务器负载。Jellyfin / Emby 可尝试较低清晰度；是否可以切换取决于服务器提供的播放方案和账号权限。字幕或音轨异常时，从播放器菜单选择其他轨道。反馈时请注明封装、视频/音频编码、字幕格式和具体表现。
iCloud 会同步视频和观看进度吗？
新安装时 iCloud 配置同步默认开启，可以在设置中关闭。同步的是加密的连接配置和相关偏好，不上传视频文件，也不通过这项功能同步观看历史。Jellyfin / Emby 观看进度由媒体服务器记录。本地文件夹在另一台设备上可能需要重新授权访问。
配置未同步时，请检查设备是否登录同一 Apple 账户、iCloud 钥匙串是否可用，以及设置中的同步状态。Apple 账户变化后，按应用提示确认当前账户。开启同步后，购买状态摘要也会加密同步，权益仍由 Apple 购买账户与有效购买凭证决定。
后续更新与功能建议
App Store 版本通过 App Store 更新。
后续改进方向包括媒体兼容性、字幕体验、播放与投屏稳定性，以及媒体库易用性。功能及支持范围以当前发布版本为准。
提交功能建议时，请说明使用的设备、媒体来源、想完成的操作，以及目前遇到的障碍；优先描述使用场景。可通过“设置 → 帮助与反馈”发送建议，或在公开支持仓库提交整理后的需求。
问题反馈
通过“设置 → 帮助与反馈”填写问题说明，使用您选择的邮件方式发送至 greenplayer_app@163.com。邮件发送前请核对正文、截图和附件，避免包含密码、访问令牌、私有地址或个人媒体内容。
“附带诊断日志”默认不勾选。主动勾选后，应用会附上当前保留的全部脱敏操作及错误记录，以及可用的系统诊断。诊断在本机和附件中加密保存，最多保留 3 天且不超过 10 MB；应用不会自动上传日志。邮件正文和您自行添加的截图不属于诊断附件的加密范围。
请在问题发生后尽快反馈，并说明设备、来源类型、操作步骤和可见提示。反馈邮件中的编号便于后续沟通。邮件应用负责实际发送，GreenPlayer 无法确认邮件最终送达。
未配置邮件时，请先设置系统邮件账户，或通过上述邮箱主动联系。需要删除已提交的个人信息和诊断附件时，可发送邮件申请。
公开问题入口：提交整理后的问题描述。请勿在公开问题中上传原始诊断附件或个人截图。
商店演示素材
Tears of Steel（2012），© Blender Foundation，按 CC BY 3.0 使用。用于新版影片详情及 Mac 播放素材。官方来源、作者与许可说明。
Caminandes: Llamigos（2016），© Blender Foundation，导演 Pablo Vazquez，按 CC BY 3.0 使用。用于 iPhone/iPad 播放与手势素材。官方影片 · 开放影片说明。
演示媒体来自 Jellyfin 官方 Demo 或对应影片的公开副本；GreenPlayer 不提供或附送这些影片。截图保持实际界面与影片内容，仅为排版缩放、裁切、加标题及边框；电视插图为投屏示意。Jellyfin 与 Blender 不为本应用背书。
第三方开源组件
GreenPlayer 的兼容播放通过 MPVKit 1.0.0 使用 mpv 0.41.0 与 FFmpeg 8.1.2。本构建的 FFmpeg 使用 LGPL-3.0-or-later（启用 version3，未启用 GPL/nonfree）；mpv 使用 LGPL-2.1-or-later，MPVKit 使用 LGPL-3.0。版权归各组件作者与贡献者所有。
对应第三方源码、构建脚本、修改记录、完整许可文本及 SHA-256 校验值见按版本归档的开源材料。应用内“隐私与法律 → 开源软件许可 → MPVKit 组件清单与版权声明”也列出 FFmpeg 与许可；第三方条款不因应用其他条款而被限制。
购买与恢复
永久解锁为一次性购买，无自动续费。换设备或重装后请使用原 App Store 购买账户；软件自动检查权益，必要时在设置或购买页点击“恢复购买”。开启 iCloud 同步可同步购买状态摘要，恢复权益仍需要有效的 Apple 购买凭证。
每台设备有 20 次播放体验，成功播放累计达到 10 秒计一次。永久解锁为一次性购买，无订阅或自动续费；购买可通过同一 Apple 购买账户恢复，支持 iPhone、iPad 和 Mac App Store 版。价格以 App Store 显示为准。
购买或恢复首次操作需要连接 App Store。无法加载价格时请检查网络并重试。请勿在公开问题中发布完整购买凭证或交易编号；客服如需核对，应通过私下渠道提供必要信息。
支持范围
GreenPlayer 不提供媒体内容、服务器账号或第三方服务支持。Jellyfin、Emby、NAS 和网络服务本身的问题，可能需要联系对应服务器管理员。
隐私与数据控制说明请查看 隐私政策。