Manual Pengguna SoftPlayer

Ekstrak SoftPlayer di mesin target dan verifikasi lingkungan memenuhi persyaratan.

1. Konfirmasi mesin target adalah Windows 10/11 x64.
2. Ekstrak paket SoftPlayer ke direktori permanen, misalnya C:\SoftPlayer\.
3. Verifikasi direktori berisi SoftPlayer.exe, appsettings.json, dan struktur subdirektori SoftPlayerMedia\.
4. Untuk pemutaran video 8K, pastikan mesin memiliki GPU yang mendukung dekoding perangkat keras (GTX 1060+ atau setara); 4K dan di bawahnya dapat menggunakan grafis terintegrasi.

• SoftPlayer.exe terlihat di direktori yang diekstrak.
• Direktori SoftPlayerMedia\ sudah dibuat dengan subdirektori: Video, StandBy, Audio, PPT, dll.

• Tempatkan SoftPlayer di jalur yang stabil — file media, log, dan status lisensi semuanya disimpan relatif terhadap direktori program.
• Rekomendasikan penyimpanan SSD dengan kecepatan baca 200MB/dtk+ untuk pemutaran resolusi tinggi yang lebih lancar.

Konfirmasi program berjalan dengan benar dan selesaikan orientasi pertama kali.

1. Klik dua kali SoftPlayer.exe untuk meluncurkan (tidak perlu hak admin).
2. Pada peluncuran pertama, program membuka panduan Mulai Cepat di browser default (hanya pada peluncuran pertama; peluncuran berikutnya melewati ini).
3. Setelah membaca panduan, kunjungi http://localhost:8766/ di browser untuk membuka konsol manajemen.
4. Di tab Dashboard, konfirmasi status pemutar normal, dan informasi versi/lisensi terlihat.

• Browser berhasil membuka konsol manajemen (http://localhost:8766/) dan menampilkan Dashboard.
• Nomor versi dan status lisensi terlihat di header konsol.

Untuk menonaktifkan panduan pertama kali, atur System.ShowQuickStartOnFirstRun ke false di appsettings.json.

Berhasil mengontrol pemutar melalui UDP dan konfirmasi saluran kontrol berfungsi.

1. Tempatkan file video (misalnya test.mp4) di direktori SoftPlayerMedia\Video\.
2. Buka PowerShell dan jalankan perintah berikut:
3. $udp = New-Object System.Net.Sockets.UdpClient
4. $data = [System.Text.Encoding]::UTF8.GetBytes("video:test.mp4")
5. $udp.Send($data, $data.Length, "127.0.0.1", 7600)
6. $udp.Close()
7. Amati apakah jendela SoftPlayer mulai memutar video yang ditentukan.

• Jendela SoftPlayer mulai memutar file video yang ditentukan.
• Tab Log konsol manajemen menampilkan perintah telah diterima.

• File video ditempatkan di direktori yang salah (harus di SoftPlayerMedia\Video\, bukan direktori root program).
• Port salah (default adalah 7600, bukan port konsol manajemen 8766).

Kuasai format perintah dan pahami respons berhasil vs. gagal.

1. Format perintah: perintah:argumen, misalnya video:show.mp4 atau volume:80.
2. Perintah tanpa argumen dapat dikirim hanya sebagai nama perintah (titik dua opsional), misalnya play.
3. Format respons berhasil: OK:perintah-asli, misalnya OK:video:show.mp4.
4. Format respons gagal: ERR:perintah-asli:pesan-kesalahan.
5. Untuk jalur file media, hanya nama file yang diperlukan — pemutar secara otomatis mencari di subdirektori yang sesuai: video: mencari di SoftPlayerMedia/Video/.

• Respons berawalan OK setelah mengirim perintah mengonfirmasi format dan eksekusi yang benar.
• Respons ERR menyertakan alasan spesifik (file tidak ditemukan, kesalahan format, dll.).

Untuk menentukan subdirektori, gunakan garis miring: video:subfolder/video.mp4 mencari di SoftPlayerMedia/Video/subfolder/.

Kuasai semua perintah terkait pemutaran video.

1. Putar video lokal: video:namafile.mp4 (mencari di direktori Video).
2. Putar aliran video jaringan: webvideo:URL (mendukung aliran HTTP/HTTPS/RTSP/RTMP/UDP).
3. Putar/Lanjutkan: play: (lanjutkan media yang dijeda).
4. Jeda: pause: (jeda media saat ini).
5. Berhenti dan kembali ke standby: stop: (kembali ke layar selamat datang / loop standby).
6. Berhenti penuh / layar hitam: stoped: (layar hitam hemat daya).
7. Putar ulang media saat ini: replay:.
8. Kontrol progres: seek:milidetik (lompat ke posisi), forward: (lewati 10 detik ke depan), backward: (lewati 10 detik ke belakang).
9. Kecepatan pemutaran: speed:1.5 (mendukung 1,5x, 2,0x, dll.).

• Setelah perintah video:, pemutar mulai memutar file yang ditentukan.
• Setelah perintah stop:, kembali ke layar standby (jika file standby dikonfigurasi).

• Untuk standby yang berjalan lama di pameran, gunakan standby: untuk melakukan loop file standby daripada stoped: layar hitam (layar hitam dapat membuat pengunjung mengira perangkat rusak).
• stop dan stoped memiliki semantik yang berbeda: stop kembali ke layar selamat datang; stoped menampilkan layar hitam murni.

Kuasai perintah kontrol penyesuaian volume dan pemutaran audio.

1. Atur volume (0-100): volume:80 (atur ke nilai tepat).
2. Naikkan volume 10%: volup: (meningkat 10% per panggilan).
3. Turunkan volume 10%: voldown: (menurun 10% per panggilan).
4. Toggle bisu: mute: (beralih antara bisu dan tidak bisu).
5. Bisukan secara eksplisit: muteon:.
6. Aktifkan suara secara eksplisit: muteoff:.
7. Putar file audio: audio:namafile.mp3 (mencari di SoftPlayerMedia/Audio/).
8. Hentikan audio: audiostoped:.

• Setelah volume:50, volume pemutar turun ke 50%.
• mute: beralih antara suara dan keheningan.

Kuasai perintah daftar loop, paginasi PPT, dan pemuatan web.

1. Loop playlist: listloop:file1.mp4;file2.mp4;file3.mp4 (pisahkan file dengan titik koma).
2. Pemutaran berurutan (berhenti di akhir): liststop:namafile.
3. Trek berikutnya: next:, Trek sebelumnya: prev:.
4. Buka PPT dalam layar penuh: ppt:namafile.pptx (mencari di SoftPlayerMedia/PPT/).
5. Navigasi PPT: ppt:next (slide berikutnya), ppt:prev (sebelumnya), ppt:home (pertama), ppt:end (terakhir).
6. Loncat ke slide: ppt:goto-5 (loncat ke halaman 5).
7. Auto-maju PPT: ppt:auto-5-namafile.pptx (auto-maju setiap 5 detik).
8. Muat halaman web: web:URL (tampilkan URL yang ditentukan dalam layar penuh).

• Setelah perintah listloop:, pemutar berulang melalui file yang tercantum.
• ppt:next memajukan PPT ke slide berikutnya.

• File PPT harus ditempatkan di SoftPlayerMedia/PPT/ sebelum mengirim perintah.
• Untuk file PDF, perintah jatuh kembali ke jendela penampil dengan paginasi simulasi penekanan tombol.
• Gunakan listloop untuk skenario loop pameran daripada mengirim perintah individual secara manual.

Pahami perintah tingkat mask dan sistem.

1. Tampilkan overlay mask: openmask: (melapisi lapisan mask pada video).
2. Sembunyikan overlay mask: closemask:.
3. Atur perilaku akhir pemutaran: endbehavior:Stop / Loop / Standby.
4. Dapatkan versi: version: (respons menyertakan info versi saat ini).
5. Restart pemutar: restart: (restart proses pemutar dari jarak jauh).

• Setelah openmask:, overlay mask muncul di video.
• Setelah version:, diterima respons dengan info versi.

Ketahui lokasi yang tepat untuk setiap jenis file media.

1. SoftPlayerMedia/Video/ — File video (.mp4/.mkv/.avi dll.), digunakan oleh perintah video:.
2. SoftPlayerMedia/StandBy/ — File standby, digunakan oleh perintah standby: dan loop default.
3. SoftPlayerMedia/Audio/ — File audio (.mp3/.wav/.flac dll.), digunakan oleh perintah audio:.
4. SoftPlayerMedia/BackgroundAudio/ — Audio latar belakang, diputar berulang secara otomatis saat diaktifkan.
5. SoftPlayerMedia/PPT/ — File PPT/PDF, digunakan oleh perintah ppt:.
6. SoftPlayerMedia/Mask/ — Gambar mask, digunakan oleh perintah openmask:.
7. SoftPlayerMedia/Thumbnail/ — Direktori cache thumbnail (dibuat otomatis, tidak perlu file manual).

• Setelah menempatkan video di Video/, perintah video:namafile memutarnya dengan benar.
• Struktur direktori dibuat secara otomatis pada peluncuran pertama — tidak perlu pengaturan manual.

Kelola file media sehari-hari melalui konsol manajemen browser.

1. Buka http://IP-pemutar:8766/ di browser untuk mengakses konsol manajemen.
2. Klik navigasi atas untuk beralih ke tab Files.
3. Pilih direktori target (Video / StandBy / Audio / PPT, dll.).
4. Klik Unggah untuk memilih file, atau seret file ke area unggah.
5. Mendukung pembuatan folder, penggantian nama, penghapusan file/folder, dan pengunduhan file.
6. File mendukung hingga 3 tingkat subdirektori; pilih direktori saat ini saat mengunggah.

• File yang baru diunggah muncul dalam daftar file setelah diunggah.
• Perintah video:namafile berhasil memutar file yang baru diunggah.

• Konsol menggunakan Basic Auth — konfigurasikan nama pengguna/kata sandi di appsettings.json.
• Batas unggah file tunggal default adalah 500MB, dapat dikonfigurasi dalam file konfigurasi.
• Staf pemeliharaan di lokasi dapat mengunggah konten pengganti melalui konsol tanpa RDP.

Pahami aturan uji coba dan rencanakan waktu lisensi dengan tepat.

1. Uji coba 30 hari dimulai secara otomatis pada peluncuran pertama SoftPlayer.
2. Semua fitur tersedia selama uji coba, termasuk pemutaran resolusi tinggi dan semua perintah UDP.
3. Periksa sisa hari uji coba di tab Dashboard konsol manajemen.
4. Setelah uji coba, kode lisensi harus diimpor untuk melanjutkan penggunaan.

• Dashboard konsol manajemen menampilkan status uji coba saat ini dan sisa hari.
• Perintah merespons normal selama uji coba tanpa batasan fitur.

• Gunakan periode uji coba untuk menyelesaikan pengujian dan penerimaan sebelum pengiriman proyek formal.
• Beli lisensi sebelum uji coba berakhir untuk menghindari downtime pameran.

Pilih tingkatan lisensi yang tepat berdasarkan kebutuhan resolusi pameran aktual.

1. Lisensi Standard: mendukung hingga resolusi 4K (3840×2160).
2. Lisensi Professional: mendukung hingga resolusi 16K (15360×8640).
3. Persyaratan perangkat keras 4K: Intel i3+, RAM 8GB, grafis terintegrasi (tidak perlu GPU diskrit).
4. Persyaratan perangkat keras 8K: Intel i5 generasi ke-8+, RAM 16GB, GTX 1060+.
5. Persyaratan perangkat keras 16K: Intel i7+, RAM 32GB, RTX 3070+.
6. Jika tidak yakin tingkatan mana yang dibutuhkan, gunakan uji coba untuk memverifikasi persyaratan resolusi aktual sebelum membeli.

• Tingkatan lisensi sesuai dengan resolusi maksimum perangkat tampilan dalam proyek.
• Konfigurasi perangkat keras server memenuhi persyaratan minimum untuk resolusi target.

Komputer tanpa GPU diskrit dapat memutar 4K dan di bawahnya (program secara otomatis beralih ke dekoding perangkat lunak), tetapi 8K/16K memerlukan GPU diskrit yang memenuhi syarat.

Impor kode lisensi untuk meningkatkan dari uji coba ke versi penuh.

1. Temukan bidang Device ID di Dashboard konsol manajemen dan salin.
2. Berikan device ID ke pemasok, tentukan tingkatan yang diperlukan (Standard/Professional).
3. Setelah menerima kode lisensi, buka tab Konfigurasi di konsol dan temukan bagian Manajemen Lisensi.
4. Tempel kode lisensi ke dalam bidang input dan klik Impor Lisensi.
5. Setelah impor berhasil, status lisensi Dashboard berubah dari Uji Coba ke Standard atau Professional.

• Dashboard konsol manajemen menampilkan status versi penuh (Standard atau Professional).
• Pemutaran video resolusi tinggi tidak lagi dibatasi.

• Menerapkan kode lisensi ke perangkat yang salah (kode terikat ke perangkat; mesin baru memerlukan kode baru).
• Menunggu hingga uji coba berakhir baru mengajukan permohonan lisensi, menyebabkan downtime pameran.

Pulihkan saluran kontrol perintah UDP.

1. Konfirmasi SoftPlayer sedang berjalan (terlihat di taskbar atau Task Manager).
2. Verifikasi port dalam perintah Anda sesuai dengan pengaturan UdpPort di appsettings.json (default 7600).
3. Periksa apakah Windows Firewall mengizinkan lalu lintas UDP masuk pada port 7600.
4. Jika daftar putih IP diaktifkan (IpWhitelistEnabled: true), konfirmasi IP pengirim ada di AllowedIps.
5. Periksa tab Log konsol manajemen untuk catatan penerimaan perintah guna mengonfirmasi apakah perintah mencapai pemutar.

• Log konsol manajemen menampilkan catatan penerimaan perintah, mengonfirmasi saluran UDP berfungsi.
• Mengirim volume:50 mengubah volume pemutar.

• Uji dengan 127.0.0.1 (localhost) terlebih dahulu untuk mengesampingkan masalah jaringan sebelum menggunakan IP aktual.
• Saat mengirim dari SoftControl, pastikan protokol perintah UDP SoftControl dan port sesuai dengan konfigurasi SoftPlayer.

Diagnosis dan selesaikan kegagalan pemutaran file media.

1. Konfirmasi file video ada di SoftPlayerMedia\Video\ (bukan direktori root program).
2. Nama file bersifat case-sensitive — konfirmasi nama dalam perintah benar-benar cocok dengan nama file aktual termasuk ekstensi.
3. Untuk file di subdirektori, sertakan jalur relatif: video:subfolder/video.mp4.
4. Telusuri tab Files di konsol manajemen untuk mengonfirmasi file benar-benar ada.
5. Untuk format file yang tidak biasa, periksa log konsol manajemen untuk pesan kesalahan VLC.
6. Coba buka file yang sama langsung dengan VLC Player di mesin untuk mengesampingkan kerusakan file.

• File target terlihat dalam daftar file konsol manajemen.
• Nama file dalam perintah tepat cocok dengan yang ditampilkan dalam daftar file.

• Nama file dalam perintah mengandung spasi lebar penuh atau karakter, menyebabkan file tidak ditemukan.
• Ketidakcocokan huruf besar/kecil ekstensi file (misalnya perintah menggunakan .MP4 tetapi file sebenarnya .mp4).

Selesaikan masalah kinerja pemutaran video resolusi tinggi.

1. Pertama konfirmasi tingkatan lisensi saat ini: Standard hanya mendukung 4K; Professional mendukung 16K.
2. Periksa apakah GPU mendukung dekoding perangkat keras (GTX 1060+ atau setara diperlukan untuk 8K).
3. Di tab Kinerja Task Manager, periksa utilisasi dekode GPU — mendekati 100% menunjukkan bottleneck GPU.
4. Periksa persyaratan kecepatan baca disk: 4K butuh 25-50 Mbps, 8K butuh 80-100 Mbps, 16K butuh 200+ Mbps.
5. Simpan file video resolusi tinggi di SSD untuk menghindari bottleneck baca HDD.
6. Untuk penyesuaian parameter VLC, lihat dokumentasi bawaan (docs\User Manual.html) di direktori program.

• Tingkatan lisensi sesuai dengan resolusi pemutaran yang diperlukan.
• Konfigurasi perangkat keras memenuhi persyaratan minimum untuk resolusi target.

Pulihkan akses konsol manajemen browser.

1. Konfirmasi SoftPlayer sedang berjalan.
2. Coba http://localhost:8766/ secara lokal untuk mengesampingkan masalah jaringan terlebih dahulu.
3. Periksa appsettings.json untuk mengonfirmasi HttpMonitor.Enabled adalah true dan port adalah 8766.
4. Periksa apakah Windows Firewall mengizinkan lalu lintas TCP pada port 8766.
5. Jika port digunakan oleh program lain, ubah HttpMonitor.Port di appsettings.json dan restart.

• Browser dapat mengakses http://localhost:8766/ dan menampilkan konsol manajemen.
• Dashboard konsol manajemen menampilkan status runtime pemutar.