動画の追加

S3D Player には Catalog ボタンがあります。これを押すと Media Manager が開きます。これは3D動画や画像にすばやくアクセスするためのウィンドウです。リストからソースを選択し、カードをスクロールして、ワンクリックで動画を再生できます。ソースには、コンピューター上のフォルダー、YouTubeチャンネル、または独自のパスワード保護されたサーバーを指定できます。ソースはプレーンテキストの設定ファイルに記述され、プログラミングなしで必要なだけ追加できます。

メディアマネージャー

接続方法

プレーヤーは4種類の動画ソースをサポートしています。タスクに合ったものを選んでください。これらは組み合わせることができます。1つのカタログに複数のローカルフォルダー、チャンネル、サーバーを含めることができます。

方法	動画の場所	必要なもの	ディスクへの保存
ローカルフォルダー	コンピューター上	フォルダーのパスのみ	不要、ファイルはすでに手元にあります
YouTubeチャンネル	YouTube上	チャンネルへのリンク	許可されています
独自のサーバー	ウェブホスティング上	PHP対応のホスティング、当社のコードパッケージ	サーバーが許可している場合
サーバー + Cloudflare R2	Cloudflare R2クラウドストレージ内	PHP対応のホスティング、Cloudflareアカウント、当社のコードパッケージ	サーバーが許可している場合

カタログの設定

すべてのメディアソースは、プレーヤーフォルダー plugins\catalog\ にある2つのテキストファイルに記述されています。Media Manager ウィンドウから Base ボタンと User ボタンで直接開くことができます。ファイルを保存すると、ウィンドウは変更を自動的に反映します。

catalog-base.txt: プレーヤーのデモ用のソース一覧です。このファイルはプレーヤーの更新によって時々置き換えられるため、独自の変更をここに入れないでください。次の更新で失われます。
catalog-user.txt: 独自のリストです。更新によって変更されることはありません。

ソース選択リストでは、ソースはファイル内と同じ順序で表示されます。最初に catalog-base.txt のすべて、次に catalog-user.txt のすべてが表示されます。あなたのファイルにベースファイルと同じ名前のセクションが含まれている場合、あなたの設定がベースの設定を置き換えます。

ファイル形式
各ソースは角括弧で囲まれた名前で始まり、その後に キー = 値 形式の行が続きます。# 記号以降はコメントです。一般設定はファイルの先頭、最初のセクションの前に記述します:

# 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: タイトルにこれらの単語の少なくとも 1 つを含む動画のみを表示します。省略可能です。
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"

最初の行に #private を伴う 200 の応答が返れば、サーバーは動作しています。 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 を有効にして、一時停止が終わるまでお待ちください。