Pagdaragdag ng Video

Ang S3D Player ay may Catalog na button. Binubuksan nito ang Media Manager, isang window para sa mabilis na pag-access sa mga 3D video at larawan. Pumili ka ng source mula sa listahan, mag-scroll sa mga card at simulan ang isang video sa isang click lang. Ang isang source ay maaaring isang folder sa iyong computer, isang YouTube channel o ang iyong sariling server na protektado ng password. Ang mga source ay inilalarawan sa isang plain text na configuration file, at maaari kang magdagdag ng kahit ilan hangga't kailangan mo nang walang anumang programming.

media manager

Mga paraan ng koneksyon

Sinusuportahan ng player ang apat na uri ng video source. Piliin ang isa na angkop sa iyong gawain. Maaari silang pagsamahin: ang isang catalog ay maaaring maglaman ng ilang lokal na folder, channel at server.

Paraan	Saan naroroon ang mga video	Ano ang kailangan mo	Pag-save sa disk
Lokal na folder	Sa iyong computer	Ang path ng folder lamang	Hindi kailangan, sa iyo na ang mga file
YouTube channel	Sa YouTube	Isang link sa channel	Pinapayagan
Ang iyong sariling server	Sa iyong web hosting	Hosting na may PHP, ang aming code package	Kung pinapayagan ng server
Server + Cloudflare R2	Sa Cloudflare R2 cloud storage	Hosting na may PHP, isang Cloudflare account, ang aming code package	Kung pinapayagan ng server

Configuration ng catalog

Ang lahat ng media source ay inilalarawan sa dalawang text file na matatagpuan sa folder ng player plugins\catalog\. Maaari mong buksan ang mga ito nang direkta mula sa Media Manager window gamit ang Base at User na mga button. Kapag na-save na ang isang file, awtomatikong nakukuha ng window ang mga pagbabago.

catalog-base.txt: isang listahan ng mga source na nagpapakita ng player. Ang file na ito ay pinapalitan ng mga update ng player paminsan-minsan, kaya huwag ilagay dito ang iyong sariling mga pagbabago: mawawala ang mga ito sa susunod na update.
catalog-user.txt: ang iyong sariling listahan. Hindi ito kailanman binabago ng mga update.

Sa listahan ng pagpili ng source, lumalabas ang mga source sa parehong pagkakasunod-sunod tulad ng sa mga file: una ang lahat mula sa catalog-base.txt, pagkatapos ang lahat mula sa catalog-user.txt. Kung ang iyong file ay may seksyon na may parehong pangalan tulad ng isa sa base file, ang iyong mga setting ay pumapalit sa mga nasa base.

Format ng file
Ang bawat source ay nagsisimula sa isang pangalan sa loob ng square brackets, na sinusundan ng mga linya sa anyo key = value. Anumang bagay pagkatapos ng # sign ay isang komento. Ang mga pangkalahatang setting ay nakasulat sa itaas ng file, bago ang unang seksyon:

# 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

Paraan 1: isang folder sa iyong computer

Ang pinakasimpleng paraan. Ini-scan ng player ang folder at ipinapakita ang lahat ng video bilang mga card na may preview. Ang mga preview ay kinukuha mula sa isang frame ng video mismo; para sa mga 3D video ginagamit ang kaliwang view.

Hakbang 1. Buksan ang catalog-user.txt
Sa window ng Media Manager, i-click ang button na User.

Hakbang 2. Magdagdag ng seksyon

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

path: ang buong path papunta sa folder na may mga video.
recursive = 1: isama rin ang mga subfolder. Kung wala ang linyang ito, ang folder lang mismo ang ini-scan.
include: ipakita lamang ang mga video na ang pamagat ay naglalaman ng kahit isa sa mga salitang ito. Opsyonal.
exclude: itago ang mga video na ang pamagat ay naglalaman ng alinman sa mga salitang ito. Opsyonal.

Hakbang 3. I-save ang file
Piliin ang bagong source sa listahan ng source sa window. Ini-scan ang folder sa tuwing pipiliin ito, kaya agad na lumalabas ang mga bagong file sa listahan. Kung wala ang folder, ipinapakita ng window ang Folder not found.

* Natutukoy ng player ang 3D format mula sa pangalan ng file, halimbawa movie_p.mp4 o movie SBS.mkv. Kung hindi tinukoy ng pangalan ang format, sinusubukan ng format detector ng player na matukoy ito habang nagpe-play.

Paraan 2: isang channel sa YouTube

Ipinapakita ng player ang mga video ng napiling channel bilang isang catalog at pina-play ang mga ito nang walang browser. Ang filter ayon sa mga salita sa pamagat ay nagbibigay-daan sa iyo na panatilihin lamang ang mga 3D video at itapon ang iba.

Hakbang 1. Magdagdag ng seksyon sa 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: ang address ng channel.
include / exclude: mga salita sa mga pamagat ng video na pumipili kung aling mga video ang ipapakita at alin ang itatago.
search_max: ang maximum na bilang ng mga video sa channel na titingnan.
search_limit: kung ilang tugmang video ang ilalagay sa catalog.

Hakbang 2. I-click ang Rescan
Upang maiwasang ma-trigger ang proteksyon ng YouTube laban sa mga bot, hindi kailanman nag-i-scan ng mga channel ang player nang mag-isa. Kapag bumukas ang window, ipinapakita nito ang naka-save na listahan. Ang mga bagong video ay nilo-load lamang sa pamamagitan ng button na Rescan at kapag nag-scroll ka hanggang sa dulo ng listahan, sa bawat pagkakataon ay eksaktong kasing dami ng kasya sa window.

Hakbang 3. Kung hihilingin ng YouTube na kumpirmahin mong hindi ka bot
Nangyayari ito sa mga network ng unibersidad at opisina at sa ilang malalaking internet provider. Mag-sign in sa iyong YouTube account sa Firefox browser. Gagamitin ng player ang sign in na ito para ma-access ang mga video nang normal. Idagdag ang sumusunod na linya sa tuktok ng iyong catalog-user.txt:

cookies = firefox

Sa halip na firefox maaari mong ibigay ang path sa isang cookies.txt file. Ang mga browser na nakabase sa Chrome (Chrome, Edge, Opera, Brave) ay hindi gagana: ini-encrypt nila ang kanilang mga cookies, kaya hindi magagamit ng player ang mga ito.

* Kapag tumanggi ang YouTube na magbigay ng access, i-pause ng player ang mga request nito nang 30 minuto. Pinoprotektahan nito ang iyong IP address mula sa pag-block. Kusang nawawala ang pause pagkatapos ng ilang sandali.

Paraan 3: isang pribadong catalog sa iyong web hosting

Para sa mga gustong magpakita ng sarili nilang 3D videos sa mga kaibigan, kliyente o kanilang audience. Ang mga video ay nakaimbak sa iyong web hosting; nakukuha ng player ang listahan at pina-play ang mga ito gamit lamang ang login at password. Ikaw ang magpapasya kung sino ang makakapanood at sino ang pinapayagang mag-save ng mga video. Subukan ang demo, kasama na ito sa player: S3D demo server

Ano ang kailangan mo
Isang ordinaryong murang hosting plan na may PHP at Apache (suporta sa .htaccess). Hindi kailangan ng dedicated server.

Code package: ang sarili mong video server

Hakbang 1. I-upload ang package sa iyong hosting
I-unpack ang archive at kopyahin ang folder sa iyong hosting, halimbawa sa /demo/. Ang mga video ay napupunta sa media folder nito.

Hakbang 2. I-configure ang config.php
Buksan ang config.php sa folder ng package. Dito nakatakda ang file name ng admin panel at ang paunang password nito. Palitan ang pareho bago maging pampubliko ang site.

Hakbang 3. Magdagdag ng mga user
Sa admin panel, gumawa ng mga user na may password at markahan kung sino sa kanila ang pinapayagang mag-save ng mga video.

Hakbang 4. Subukan ang server
Sa Windows command prompt:

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

Tugon na 200 na may #private sa unang linya: gumagana ang server. Tugon na 403: mali ang login o password.

Hakbang 5. Idagdag ang server sa player

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

Piliin ang source at i-click ang Rescan. Sa susunod na pagbukas ng window, ang listahan ay kinukuha mula sa cache at nire-refresh sa background.

Paraan 4: Cloudflare R2 + ang iyong web hosting

Nag-aalok ang Cloudflare ng napakapaborableng mga tuntunin para sa pag-iimbak at paghahatid ng iyong mga file: hanggang 10 GB ng storage nang libre at libreng outbound traffic, na may katamtamang presyo kapag lumampas doon. Gumamit ng maliit na pribadong hosting plan para sa mga login at password, habang ang mga video mismo ay nakaimbak sa Cloudflare R2 cloud storage sa halip na sa hosting. Sinusuri lamang ng hosting ang password at binibigyan ang player ng mga link. Ang video ay direktang napupunta sa manonood mula sa R2, kaya ang malalaking file ay hindi kumukuha ng espasyo o traffic sa iyong hosting. Subukan ang demo, kasama na ito sa player: Cloudflare-R2 demo video

Cloudflare R2
Package ng code: R2 + video

Hakbang 1. Gumawa ng R2 bucket
Sa Cloudflare dashboard, buksan ang R2 object storage, gumawa ng bucket at i-upload ang iyong mga video dito.

Hakbang 2. Gumawa ng access key
Sa R2 object storage, sa ilalim ng Account Details, i-click ang Manage sa tabi ng API Tokens. Mga pahintulot: Object Read only; bucket: sa iyo lamang (Apply to specific buckets only); TTL: Forever. Pagkatapos magawa ang token, kopyahin ang Access Key ID at ang Secret Access Key. Ang secret ay ipinapakita lamang nang isang beses.

Hakbang 3. I-upload ang package sa iyong hosting
Kopyahin ang folder ng package sa iyong hosting, halimbawa sa /cloudflare/. Sa config.php, ilagay ang Account ID, ang dalawang key at ang pangalan ng bucket, pati na rin ang pangalan ng admin panel file at ang password nito.

Hakbang 4. Magdagdag ng mga user at subukan
Pareho sa Paraan 3: mga user sa admin panel, isang pagsubok gamit ang curl command.

Hakbang 5. Idagdag ang server sa player

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

* Ang R2 key ay nakaimbak lamang sa hosting; hindi ito nakukuha ng mga manonood. Nagbibigay ang server ng pansamantalang mga link ng video na may bisa ng 1 oras.

Pag-save ng mga video

Kung pinapayagan ng source ang pag-save, nagpapakita ang header ng window ng Save checkbox. Kapag ito ay naka-check, ang video ay isinusulat din sa disk habang nagpe-play: sa save_dir folder ng source section o, kung wala itong nakatakda doon, sa pangkalahatang save_dir. Ang mga video mula sa YouTube channels ay laging maaaring i-save. Ang isang pribadong server ay nagpapahintulot ng pag-save lamang para sa mga user na pinahintulutan ng may-ari ng server. Ang isang lokal na folder ay walang opsyon sa pag-save, dahil ang mga file ay nasa iyong computer na.

Ang pahintulot mula sa isang pribadong server ay dumarating kasama ng listahan kapag i-click mo ang Rescan. Hanggang sa ma-click ang Rescan, ipinapakita ng window ang No save sa halip na ang checkbox.

Pag-troubleshoot

Kung walang laman ang listahan, ipinapakita ng window ng Media Manager ang dahilan.

No cache: press Rescan
Hindi pa kailanman na-load ang source. I-click ang Rescan.

Folder not found
Wala ang folder. Suriin ang path sa path.

Wrong user or password
Tinanggihan ng server ang login o password. Suriin ang user at password.

Too many attempts, wait 15 min
Masyadong maraming nabigong pagtatangkang mag-login nang sunod-sunod. Maghintay ng 15 minuto.

Server not responding
Walang koneksyon sa network, o mali ang address sa url.

YouTube: requests refused
Itinuring ng YouTube na kahina-hinala ang mga kahilingan. I-enable ang cookies = firefox at maghintay hanggang matapos ang pag-pause.