Menambah Gambar

Butang Catalog dalam S3D Player membuka Media Manager. Selain video, ia boleh memaparkan foto 3D dan gambar biasa: anda memilih galeri daripada senarai, menatal melalui kad pratonton dan memulakan tayangan slaid dengan satu klik. Galeri boleh berupa folder pada komputer anda, pelayan anda sendiri yang dilindungi kata laluan atau storan awan Cloudflare R2. Galeri gambar ditambah dalam fail teks yang sama seperti video.

imej media

Format
JPG, PNG, BMP, WEBP, AVIF, GIF dan format stereo MPO (kamera 3D) dan HEIC (tangkapan 3D pada telefon pintar). Untuk gambar 3D yang disimpan dalam satu imej (SBS, Top/Bottom), pemain mengenal pasti susun atur daripada nama fail atau dengan pengesan formatnya.

Kaedah sambungan

Pemain menyokong empat jenis sumber gambar. Ia boleh digabungkan dengan sumber video dalam katalog yang sama.

Kaedah	Di mana gambar berada	Apa yang anda perlukan	Menyimpan ke cakera
Folder setempat	Pada komputer anda	Hanya laluan folder	Fail sudah ada pada PC anda
Pelayan anda sendiri	Pada hosting web anda	Hosting dengan PHP, pakej kod kami	Jika pelayan membenarkannya
Cloudflare R2	Dalam storan awan Cloudflare R2	Akaun Cloudflare dan kunci baca sahaja. Tiada hosting diperlukan	Ditetapkan oleh fail config.txt dalam baldi
Galeri awam	Pada mana-mana laman web	Fail index.txt yang menyenaraikan gambar	Ditetapkan oleh baris dalam index.txt

Konfigurasi katalog

Galeri diterangkan dalam fail yang sama seperti video: catalog-base.txt (disediakan oleh kami dan diganti oleh kemas kini pemain) dan catalog-user.txt (milik anda, tidak pernah diubah oleh kemas kini). Kedua-duanya terletak dalam folder pemain plugins\catalog\ dan boleh dibuka dengan butang Base dan User dalam tetingkap Media Manager. Format fail dan tetapan umum diterangkan pada halaman tentang menambah video.

Bahagian gambar berbeza daripada bahagian video dengan satu kunci: bukannya path atau url ia menggunakan images. Kunci ini memberitahu pemain untuk memaparkan gambar dan bukannya video.

[My 3D photos]
images = D:\Photo\3D

Kaedah 1: folder pada komputer anda

Kaedah paling mudah. Pemain mengimbas folder setiap kali galeri dipilih, jadi fail baharu muncul dalam senarai serta-merta.

Langkah 1. Buka catalog-user.txt
Dalam tetingkap Media Manager, klik butang User.

Langkah 2. Tambah bahagian

[My 3D photos]
images    = D:\Photo\3D
recursive = 1

images: laluan penuh ke folder dengan gambar.
recursive = 1: sertakan subfolder juga. Tanpa baris ini hanya folder itu sendiri diimbas.

Langkah 3. Simpan fail
Pilih galeri baharu dalam senarai sumber. Jika folder tidak wujud, tetingkap menunjukkan Folder not found.

Kaedah 2: galeri peribadi pada hosting web anda

Untuk mereka yang ingin menunjukkan foto 3D mereka sendiri kepada rakan, pelanggan atau audiens mereka. Gambar disimpan pada hosting web anda, satu folder bagi setiap galeri. Pemain mendapat senarai dan gambar itu sendiri hanya dengan log masuk dan kata laluan. Anda menentukan galeri mana setiap pengguna boleh lihat dan siapa yang dibenarkan menyimpan gambar. Cuba demo, ia sudah disertakan dalam pemain: S3D demo server images, gallery: Mix1, Mix2

Apa yang anda perlukan
Pelan hosting biasa yang murah dengan PHP dan Apache 2.4 (sokongan .htaccess).

Pakej kod: pelayan gambar anda sendiri

Langkah 1. Muat naik pakej ke hosting anda
Buka arkib dan salin folder ke hosting anda, contohnya ke /imgshow/. Di dalam folder galleriesnya, cipta satu folder bagi setiap galeri, contohnya mix1, mix2, dan letakkan gambar ke dalamnya. Fail .htaccess pakej menyekat akses langsung kepada gambar: ia hanya boleh diperoleh melalui pemain dengan kata laluan.

Langkah 2. Konfigurasikan config.php dan buka panel admin
Dalam config.php, tetapkan kata laluan admin awal dan nama fail halaman admin anda sendiri, kemudian namakan semula admin.php kepada nama itu. Dalam panel admin, tambah pengguna dengan kata laluan dan tetapkan bagi setiap:
save: sama ada pengguna boleh menyimpan gambar.
galleries: galeri (folder) mana yang pengguna boleh lihat: * untuk semua, atau nama seperti mix1,mix2.
Panel itu juga menunjukkan semua galeri dan gambar, aktiviti pengguna dan log masuk yang gagal. Arahan langkah demi langkah disertakan dalam pakej (README.txt).

Langkah 3. Uji pelayan
Dalam command prompt Windows:

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

Respons 200 dengan #private pada baris pertama: pelayan berfungsi. Respons 403: log masuk atau kata laluan salah. Respons 404: galeri tidak wujud atau tidak dibenarkan untuk pengguna ini.

Langkah 4. Tambah galeri ke pemain

[Galeri saya: Mix1]
images   = https://example.com/imgshow/list.php?dir=mix1
user     = demo-user
password = 12345
save_dir = D:\Photo\Saved

Satu bahagian bagi setiap galeri, dengan nama folder di hujung alamat selepas dir=. Pilih galeri dan klik Rescan.

Kaedah 3: Cloudflare R2 secara terus, tanpa pengehosan

Pemain membaca gambar terus daripada storan awan Cloudflare R2; tiada pelayan diperlukan sama sekali. Cloudflare menyediakan sehingga 10 GB storan dan trafik keluar secara percuma, dengan harga sederhana selepas itu. Kaedah ini sesuai untuk galeri awam yang besar. Cuba demo, ia sudah disertakan dalam pemain: S3D R2 images, gallery: Mix1, Mix2

Cloudflare R2

Langkah 1. Cipta baldi dan muat naik gambar
Dalam papan pemuka Cloudflare, buka R2 object storage dan cipta baldi. Di dalamnya, cipta satu folder bagi setiap galeri, contohnya mix1, dan muat naik gambar ke dalamnya.

Langkah 2. Benarkan atau larang penyimpanan
Letakkan fail config.txt yang mengandungi satu baris ke dalam folder galeri:

save = 1

save = 1: penonton boleh menyimpan gambar; save = 0 atau tiada fail: penyimpanan tidak dibenarkan. Kebenaran disimpan dalam baldi, bukan pada komputer penonton, jadi penonton tidak boleh mengubahnya.

Langkah 3. Cipta kunci baca sahaja
Dalam R2 object storage, di bawah Account Details, klik Manage di sebelah API Tokens. Kebenaran: Object Read only; baldi: milik anda sahaja (Apply to specific buckets only); TTL: Forever; biarkan penapis IP kosong. Selepas token dicipta, salin Access Key ID dan Secret Access Key. Rahsia itu ditunjukkan sekali sahaja. Baris Token value tidak digunakan oleh pemain; jangan kongsikannya dengan sesiapa.

Langkah 4. Tambah galeri ke pemain
Dalam papan pemuka alamat baldi kelihatan seperti ini: https://<Account ID>.r2.cloudflarestorage.com/<bucket>. Bahagian ini mengambil Account ID, nama baldi dan folder galeri daripadanya:

[Galeri R2 saya: Mix1]
images = r2://<Account ID>/<bucket>/mix1
key    = <Access Key ID>
secret = <Secret Access Key>

Pilih galeri dan klik Rescan.

* Kunci akses disimpan dalam fail teks pada komputer setiap penonton. Ia baca sahaja dan sah untuk baldi ini sahaja: fail tidak boleh dipadam atau diubah dengannya. Gunakan kaedah ini hanya untuk galeri awam; untuk galeri peribadi gunakan Kaedah 2.

Kaedah 4: galeri awam yang disenaraikan dalam index.txt

Gambar-gambar tersedia secara awam di mana-mana laman web, bersama-sama dengan fail index.txt yang menyenaraikannya. Tiada kata laluan atau kunci diperlukan.

Langkah 1. Cipta index.txt
Satu nama fail setiap baris, relatif kepada folder yang mengandungi index.txt, atau alamat penuh sesuatu gambar. Baris yang bermula dengan # diabaikan.

save = 0
photo1_x.jpg
photo2.mpo
sub/photo3.heic
https://other.site/pic_p.jpg

save = 1 membenarkan penonton menyimpan gambar-gambar; tanpa baris ini penyimpanan tidak dibenarkan.

Langkah 2. Tambah galeri ke pemain

[Public gallery]
images = https://example.com/gallery/index.txt

Pilih galeri dan klik Rescan. Gambar-gambar dipaparkan mengikut susunan yang diberikan dalam index.txt.

Melihat

Pratonton
Pratonton dimuatkan hanya untuk kad yang kelihatan dalam tetingkap. Apabila anda menatal lebih jauh, yang seterusnya dimuatkan. Pratonton yang selesai disimpan dalam cache cakera dan muncul serta-merta pada kali berikutnya. Untuk gambar 3D pratonton menunjukkan paparan kiri.

Tayangan slaid
Mengklik kad memulakan tayangan slaid dari gambar itu. Gambar-gambar kemudian mengikut dalam gelung, dalam susunan yang sama seperti dalam tetingkap.

Pengisihan
Newest dan Oldest: mengikut tarikh fail. Name: mengikut nama, dengan nombor dibandingkan mengikut nilai: 1, 2, 3 ... 10 ... 1000. Ini memudahkan untuk siri bernombor.

Galeri jauh
Gambar dari pelayan, R2 atau index.txt tidak ditulis ke cakera apabila penyimpanan tidak dibenarkan. Pemain menyimpan gambar semasa, 10 seterusnya dan 3 sebelumnya dalam memori, supaya pelayaran berjalan tanpa kelewatan.

Menyimpan gambar

Jika galeri membenarkan penyimpanan, pengepala tetingkap menunjukkan kotak semak Save. Apabila ia ditanda, setiap gambar yang dimuatkan untuk tayangan slaid juga ditulis ke cakera: ke folder save_dir bahagian galeri atau, jika tiada yang ditetapkan di sana, ke save_dir umum. Fail yang sudah wujud dalam folder tidak akan ditimpa.

Siapa yang menentukan sama ada penyimpanan dibenarkan:
Pelayan anda sendiri: pemilik pelayan, dengan pilihan simpan setiap pengguna dalam panel admin.
Cloudflare R2: pemilik baldi, dengan fail config.txt dalam folder galeri.
Galeri awam: pengarang, dengan baris save = 1 dalam index.txt.

Kebenaran tiba bersama-sama dengan senarai apabila anda mengklik Rescan. Sehingga Rescan diklik, tetingkap menunjukkan No save dan bukannya kotak semak.

Penyelesaian masalah

Jika senarai kosong, tetingkap Media Manager menunjukkan puncanya.

No cache: press Rescan
Galeri belum pernah dimuatkan. Klik Rescan.

Folder not found
Folder tidak wujud. Semak laluan dalam images.

Tiada fail imej
Senarai telah dimuatkan tetapi tiada gambar. Semak folder dan sambungan fail.

Pengguna atau kata laluan salah
Pelayan menolak log masuk atau kata laluan. Semak user dan password.

Terlalu banyak percubaan, tunggu 15 min
Terlalu banyak percubaan log masuk yang gagal berturut-turut. Tunggu 15 minit.

Pelayan tidak memberi respons
Tiada sambungan rangkaian, atau alamat dalam images salah.

Ralat pelayan 404
Galeri tidak wujud di pelayan, atau ia tidak dibenarkan untuk pengguna ini (galeri pengguna dalam panel admin).

R2: HTTP 403 SignatureDoesNotMatch
secret salah, atau jam komputer berbeza dengan ketara daripada masa sebenar.

R2: HTTP 403 AccessDenied
Kunci tidak tergolong dalam baldi ini atau tiada kebenaran baca.

R2: key atau secret tidak ditetapkan
Bahagian ini tiada baris key atau secret.

Index: HTTP 404
Alamat index.txt salah.