新增影片

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 並等待暫停結束。