添加视频

S3D Player 有一个 Catalog 按钮。它会打开 Media Manager，一个用于快速访问 3D 视频和图片的窗口。你从列表中选择一个来源，滚动浏览卡片，单击即可开始播放视频。来源可以是您计算机上的文件夹、YouTube 频道或您自己的受密码保护的服务器。来源在纯文本配置文件中描述，您可以根据需要添加任意数量的来源，无需任何编程。

媒体管理器

连接方式

播放器支持四种类型的视频来源。选择适合您任务的一种。它们可以组合使用：一个目录可以包含多个本地文件夹、频道和服务器。

方式	视频所在位置	您需要什么	保存到磁盘
本地文件夹	在您的计算机上	仅需文件夹路径	不需要，文件已经是您的了
YouTube 频道	在 YouTube 上	频道链接	允许
您自己的服务器	在您的网络托管上	支持 PHP 的托管、我们的代码包	如果服务器允许
服务器 + Cloudflare R2	在 Cloudflare R2 云存储中	支持 PHP 的托管、一个 Cloudflare 账户、我们的代码包	如果服务器允许

目录配置

所有媒体来源都在播放器文件夹 plugins\catalog\ 中的两个文本文件中描述。您可以直接从 Media Manager 窗口使用 Base 和 User 按钮打开它们。文件保存后，窗口会自动获取更改。

catalog-base.txt：演示播放器的来源列表。此文件会不时被播放器更新替换，因此不要在此处放置您自己的更改：它们将在下次更新时丢失。
catalog-user.txt：您自己的列表。更新永远不会修改它。

在来源选择列表中，来源按照文件中的相同顺序显示：首先是 catalog-base.txt 中的所有内容，然后是 catalog-user.txt 中的所有内容。如果您的文件包含与基础文件中同名的部分，您的设置将替换基础设置。

文件格式
每个来源以方括号中的名称开头，后面是形式为 key = value 的行。# 号之后的任何内容都是注释。常规设置写在文件顶部，第一个部分之前：

# general settings
quality  = 1080      # 720 / 1080 / 2160
thumb    = max       # preview: mq / 720 / max
save_dir = D:\Video\Saved
cookies  = firefox   # YouTube sign in, see the YouTube section

# source
[My 3D videos]
path      = D:\Video\3D
recursive = 1

方法 1：计算机上的文件夹

最简单的方法。播放器会扫描该文件夹，并将所有视频以带预览的卡片形式显示。预览取自视频本身的一帧；对于 3D 视频，使用左视图。

第 1 步。打开 catalog-user.txt
在 Media Manager 窗口中，点击 User 按钮。

第 2 步。添加一个区段

[My 3D videos]
path      = D:\Video\3D
recursive = 1
include   = SBS, 3D

path：包含视频的文件夹的完整路径。
recursive = 1：同时包含子文件夹。没有此行时，仅扫描该文件夹本身。
include：仅显示标题中包含这些词中至少一个的视频。可选。
exclude：隐藏标题中包含这些词中任意一个的视频。可选。

第 3 步。保存文件
在窗口的来源列表中选择新来源。每次选择该文件夹时都会重新扫描，因此新文件会立即出现在列表中。如果文件夹不存在，窗口会显示 Folder not found。

* 播放器会从文件名检测 3D 格式，例如 movie_p.mp4 或 movie SBS.mkv。如果文件名未指定格式，播放器的格式检测器会在播放时尝试确定格式。

方法 2：YouTube 频道

播放器会将所选频道的视频作为目录显示，并在无需浏览器的情况下播放它们。按标题中的词进行筛选，可以只保留 3D 视频并丢弃其余视频。

第 1 步。向 catalog-user.txt 添加一个区段

[4K Cine Trailer]
url          = https://www.youtube.com/@4kcinematrailer
include      = 3D, SBS
exclude      = anaglyph, VR
search_max   = 3000
search_limit = 200

url：频道地址。
include / exclude：视频标题中的词，用于选择要显示哪些视频以及隐藏哪些视频。
search_max：要浏览的频道视频最大数量。
search_limit：要放入目录的匹配视频数量。

第 2 步。点击 Rescan
为避免触发 YouTube 的机器人防护，播放器绝不会自行扫描频道。窗口打开时，它会显示已保存的列表。新视频仅通过 Rescan 按钮以及滚动到列表末尾时加载，每次加载的数量恰好与窗口中能容纳的数量相同。

第 3 步。如果 YouTube 要求你确认你不是机器人
这种情况会出现在大学和办公网络以及一些大型互联网服务提供商中。在 Firefox 浏览器中登录你的 YouTube 账户。播放器随后会使用此登录信息正常访问视频。在 catalog-user.txt 顶部添加以下行：

cookies = firefox

除了 firefox，你也可以提供 cookies.txt 文件的路径。基于 Chrome 的浏览器（Chrome、Edge、Opera、Brave）将无法使用：它们会加密自己的 cookie，因此播放器无法使用它们。

* 当 YouTube 拒绝访问时，播放器会暂停其请求 30 分钟。这可以保护你的 IP 地址不被封锁。暂停会在一段时间后自动解除。

方法 3：在你的虚拟主机上建立私有目录

适合那些想向朋友、客户或观众展示自己的 3D 视频的人。视频存储在你的虚拟主机上；播放器获取列表并播放它们，但需要登录名和密码。你可以决定谁可以观看，以及谁可以保存视频。试试演示，它已包含在播放器中：S3D demo server

你需要什么
一个普通的廉价虚拟主机方案，支持 PHP 和 Apache （支持 .htaccess）。不需要专用服务器。

代码包：你自己的视频服务器

第 1 步。将代码包上传到你的虚拟主机
解压压缩包，将文件夹复制到你的虚拟主机，例如复制到 /demo/。视频放入其 media 文件夹。

第 2 步。配置 config.php
打开代码包文件夹中的 config.php。它设置管理面板的文件名及其初始密码。在网站公开可访问之前，请更改这两项。

第 3 步。添加用户
在管理面板中，创建带密码的用户，并标记其中哪些用户允许保存视频。

第 4 步。测试服务器
在 Windows 命令提示符中：

curl -i -X POST -d "user=demo-user&pass=12345" "https://example.com/demo/list.php"

响应 200 且第一行为 #private：服务器工作正常。响应 403：登录名或密码错误。

第 5 步。将服务器添加到播放器

[My server]
url      = https://example.com/demo/list.php
user     = demo-user
password = 12345
save_dir = D:\Video\Saved

选择源并点击 Rescan。下次打开窗口时，列表将从缓存中获取并在后台刷新。

方法 4：Cloudflare R2 + 你的虚拟主机

Cloudflare 为存储和提供文件提供了非常优惠的条件：最高 10 GB 的免费存储空间和免费出站流量，超出后价格适中。使用一个小型私有主机方案来管理登录名和密码，而视频本身则存储在 Cloudflare R2 云存储中，而不是主机上。主机只验证密码并向播放器提供链接。视频直接从 R2 传输给观看者，因此大文件既不占用你主机的空间，也不消耗流量。试试演示，它已包含在播放器中：Cloudflare-R2 demo video

Cloudflare R2
代码包：R2 + video

第 1 步。创建一个 R2 存储桶
在 Cloudflare 控制台中，打开 R2 object storage，创建一个存储桶并将你的视频上传到其中。

第 2 步。创建一个访问密钥
在 R2 object storage 中，在 Account Details 下，点击 API Tokens 旁边的 Manage。权限：Object Read only；存储桶：仅限你自己的（Apply to specific buckets only）； TTL：Forever。令牌创建后，复制 Access Key ID 和 Secret Access Key。密钥只显示一次。

第 3 步。将代码包上传到你的主机
将代码包文件夹复制到你的主机，例如复制到 /cloudflare/。在 config.php 中，输入 Account ID、两个密钥和存储桶名称，以及管理面板文件名及其密码。

第 4 步。添加用户并测试
与方法 3 相同：在管理面板中添加用户，使用 curl 命令进行测试。

第 5 步。将服务器添加到播放器

[My R2 server]
url      = https://example.com/cloudflare/list.php
user     = demo-user
password = 12345
save_dir = D:\Video\Saved

* R2 密钥仅存储在主机上；观看者永远无法获取它。服务器会签发有效期 1 小时的临时视频链接。

保存视频

如果来源允许保存，窗口标题栏会显示一个 Save 复选框。勾选后，视频在播放时也会写入磁盘：写入来源部分的 save_dir 文件夹，如果那里没有设置，则写入通用的 save_dir。来自 YouTube 频道的视频始终可以保存。私有服务器仅允许服务器所有者已许可的用户进行保存。本地文件夹没有保存选项，因为文件已经在你的计算机上。

当你点击 Rescan 时，来自私有服务器的许可会随列表一起到达。在点击 Rescan 之前，窗口会显示 No save 而不是复选框。

故障排除

如果列表为空，Media Manager 窗口会显示原因。

No cache: press Rescan
该源从未被加载过。请点击 Rescan。

Folder not found
该文件夹不存在。请检查 path 中的路径。

Wrong user or password
服务器拒绝了登录名或密码。请检查 user 和 password。

Too many attempts, wait 15 min
连续登录失败次数过多。请等待 15 分钟。

Server not responding
没有网络连接，或者 url 中的地址有误。

YouTube: requests refused
YouTube 认为这些请求可疑。请启用 cookies = firefox 并等待暂停结束。