Sổ tay người dùng SoftPlayer

Giải nén SoftPlayer trên máy mục tiêu và xác minh môi trường đáp ứng yêu cầu.

1. Xác nhận máy mục tiêu là Windows 10/11 x64.
2. Giải nén gói SoftPlayer vào thư mục cố định, ví dụ C:\SoftPlayer\.
3. Xác minh thư mục chứa SoftPlayer.exe, appsettings.json và cấu trúc thư mục con SoftPlayerMedia\.
4. Để phát video 8K, đảm bảo máy có GPU hỗ trợ giải mã phần cứng (GTX 1060+ hoặc tương đương); 4K và thấp hơn hoạt động với đồ họa tích hợp.

• SoftPlayer.exe hiển thị trong thư mục đã giải nén.
• Thư mục SoftPlayerMedia\ được tạo sẵn với các thư mục con: Video, StandBy, Audio, PPT, v.v.

• Đặt SoftPlayer ở đường dẫn ổn định — tệp media, log và trạng thái giấy phép đều được lưu tương đối với thư mục chương trình.
• Khuyến nghị lưu trữ SSD với tốc độ đọc 200MB/s+ để phát lại độ phân giải cao mượt mà hơn.

Xác nhận chương trình khởi động đúng và hoàn thành hướng dẫn lần đầu.

1. Nhấp đúp vào SoftPlayer.exe để khởi chạy (không cần quyền quản trị).
2. Khi khởi chạy lần đầu, chương trình mở hướng dẫn Khởi động nhanh trong trình duyệt mặc định (chỉ lần đầu; các lần khởi chạy sau sẽ bỏ qua).
3. Sau khi đọc hướng dẫn, truy cập http://localhost:8766/ trong trình duyệt để mở bảng quản lý.
4. Trên tab Dashboard, xác nhận trạng thái trình phát bình thường và thông tin phiên bản/giấy phép hiển thị.

• Trình duyệt mở thành công bảng quản lý (http://localhost:8766/) và hiển thị Dashboard.
• Số phiên bản và trạng thái giấy phép hiển thị trong header bảng điều khiển.

Để tắt hướng dẫn lần đầu, đặt System.ShowQuickStartOnFirstRun thành false trong appsettings.json.

Điều khiển thành công trình phát qua UDP và xác nhận kênh điều khiển hoạt động.

1. Đặt tệp video (ví dụ test.mp4) vào thư mục SoftPlayerMedia\Video\.
2. Mở PowerShell và chạy các lệnh sau:
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. Quan sát xem cửa sổ SoftPlayer có bắt đầu phát video được chỉ định không.

• Cửa sổ SoftPlayer bắt đầu phát tệp video được chỉ định.
• Tab Log của bảng quản lý hiển thị lệnh đã được nhận.

• Tệp video đặt sai thư mục (phải ở SoftPlayerMedia\Video\, không phải thư mục gốc chương trình).
• Sai cổng (mặc định là 7600, không phải cổng bảng quản lý 8766).

Nắm vững định dạng lệnh và hiểu phản hồi thành công so với thất bại.

1. Định dạng lệnh: lệnh:đối_số, ví dụ video:show.mp4 hoặc volume:80.
2. Lệnh không có đối số có thể gửi chỉ với tên lệnh (dấu hai chấm tùy chọn), ví dụ play.
3. Định dạng phản hồi thành công: OK:lệnh-gốc, ví dụ OK:video:show.mp4.
4. Định dạng phản hồi thất bại: ERR:lệnh-gốc:thông-báo-lỗi.
5. Đối với đường dẫn tệp media, chỉ cần tên tệp — trình phát tự động tìm trong thư mục con tương ứng: video: tìm trong SoftPlayerMedia/Video/.

• Phản hồi có tiền tố OK sau khi gửi lệnh xác nhận định dạng đúng và thực thi thành công.
• Phản hồi ERR bao gồm lý do cụ thể (tệp không tìm thấy, lỗi định dạng, v.v.).

Để chỉ định thư mục con, dùng dấu gạch chéo: video:subfolder/video.mp4 tìm trong SoftPlayerMedia/Video/subfolder/.

Nắm vững tất cả lệnh liên quan đến phát lại video.

1. Phát video cục bộ: video:filename.mp4 (tìm trong thư mục Video).
2. Phát luồng video mạng: webvideo:URL (hỗ trợ luồng HTTP/HTTPS/RTSP/RTMP/UDP).
3. Phát/Tiếp tục: play: (tiếp tục media tạm dừng).
4. Tạm dừng: pause: (tạm dừng media hiện tại).
5. Dừng và quay về chế độ chờ: stop: (quay về màn hình chào/vòng lặp chế độ chờ).
6. Dừng hoàn toàn / màn hình đen: stoped: (màn hình đen tiết kiệm điện).
7. Phát lại media hiện tại: replay:.
8. Điều khiển tiến trình: seek:milliseconds (nhảy đến vị trí), forward: (tua nhanh 10 giây), backward: (tua lại 10 giây).
9. Tốc độ phát lại: speed:1.5 (hỗ trợ 1,5x, 2,0x, v.v.).

• Sau lệnh video:, trình phát bắt đầu phát tệp được chỉ định.
• Sau lệnh stop:, quay về màn hình chế độ chờ (nếu tệp chế độ chờ được cấu hình).

• Để chế độ chờ lâu dài trong triển lãm, dùng standby: để lặp tệp chế độ chờ thay vì stoped: màn hình đen (màn hình đen có thể khiến khách thăm nghĩ thiết bị bị hỏng).
• stop và stoped có ngữ nghĩa khác nhau: stop quay về màn hình chào; stoped hiển thị màn hình đen thuần túy.

Nắm vững lệnh điều chỉnh âm lượng và điều khiển phát lại âm thanh.

1. Đặt âm lượng (0-100): volume:80 (đặt về giá trị chính xác).
2. Tăng âm lượng 10%: volup: (tăng 10% mỗi lần gọi).
3. Giảm âm lượng 10%: voldown: (giảm 10% mỗi lần gọi).
4. Chuyển đổi tắt tiếng: mute: (chuyển đổi giữa tắt tiếng và bật tiếng).
5. Tắt tiếng rõ ràng: muteon:.
6. Bật tiếng rõ ràng: muteoff:.
7. Phát tệp âm thanh: audio:filename.mp3 (tìm trong SoftPlayerMedia/Audio/).
8. Dừng âm thanh: audiostoped:.

• Sau volume:50, âm lượng trình phát giảm xuống 50%.
• mute: chuyển đổi giữa có âm thanh và im lặng.

Nắm vững lệnh danh sách vòng lặp, phân trang PPT và tải web.

1. Phát danh sách phát vòng lặp: listloop:file1.mp4;file2.mp4;file3.mp4 (phân cách tệp bằng dấu chấm phẩy).
2. Phát tuần tự (dừng ở cuối): liststop:filename.
3. Bài tiếp theo: next:, Bài trước: prev:.
4. Mở PPT toàn màn hình: ppt:filename.pptx (tìm trong SoftPlayerMedia/PPT/).
5. Điều hướng PPT: ppt:next (slide tiếp), ppt:prev (trước), ppt:home (đầu), ppt:end (cuối).
6. Nhảy đến slide: ppt:goto-5 (nhảy đến trang 5).
7. PPT tự chuyển: ppt:auto-5-filename.pptx (tự chuyển mỗi 5 giây).
8. Tải trang web: web:URL (hiển thị URL được chỉ định toàn màn hình).

• Sau lệnh listloop:, trình phát lặp qua các tệp được liệt kê.
• ppt:next chuyển PPT đến slide tiếp theo.

• Tệp PPT phải được đặt trong SoftPlayerMedia/PPT/ trước khi gửi lệnh.
• Đối với tệp PDF, lệnh dự phòng về cửa sổ xem với phân trang mô phỏng phím.
• Dùng listloop cho kịch bản triển lãm lặp lại thay vì gửi thủ công từng lệnh riêng lẻ.

Hiểu lệnh mask và cấp hệ thống.

1. Hiển thị lớp phủ mask: openmask: (phủ lớp mask trên video).
2. Ẩn lớp phủ mask: closemask:.
3. Đặt hành vi cuối phát lại: endbehavior:Stop / Loop / Standby.
4. Lấy phiên bản: version: (phản hồi bao gồm thông tin phiên bản hiện tại).
5. Khởi động lại trình phát: restart: (khởi động lại từ xa tiến trình trình phát).

• Sau openmask:, lớp phủ mask xuất hiện trên video.
• Sau version:, nhận được phản hồi với thông tin phiên bản.

Biết vị trí chính xác cho từng loại tệp media.

1. SoftPlayerMedia/Video/ — Tệp video (.mp4/.mkv/.avi v.v.), dùng bởi lệnh video:.
2. SoftPlayerMedia/StandBy/ — Tệp chế độ chờ, dùng bởi lệnh standby: và vòng lặp mặc định.
3. SoftPlayerMedia/Audio/ — Tệp âm thanh (.mp3/.wav/.flac v.v.), dùng bởi lệnh audio:.
4. SoftPlayerMedia/BackgroundAudio/ — Âm thanh nền, tự động lặp khi được bật.
5. SoftPlayerMedia/PPT/ — Tệp PPT/PDF, dùng bởi lệnh ppt:.
6. SoftPlayerMedia/Mask/ — Hình ảnh mask, dùng bởi lệnh openmask:.
7. SoftPlayerMedia/Thumbnail/ — Thư mục cache thumbnail (tự tạo, không cần tệp thủ công).

• Sau khi đặt video vào Video/, lệnh video:filename phát đúng.
• Cấu trúc thư mục được tạo tự động khi khởi chạy lần đầu — không cần cài đặt thủ công.

Quản lý tệp media hàng ngày qua bảng quản lý trình duyệt.

1. Mở http://player-IP:8766/ trong trình duyệt để truy cập bảng quản lý.
2. Nhấp vào điều hướng trên cùng để chuyển sang tab Files.
3. Chọn thư mục mục tiêu (Video / StandBy / Audio / PPT, v.v.).
4. Nhấp Upload để chọn tệp, hoặc kéo tệp vào khu vực tải lên.
5. Hỗ trợ tạo thư mục, đổi tên, xóa tệp/thư mục và tải xuống tệp.
6. Tệp hỗ trợ tối đa 3 cấp thư mục con; chọn thư mục hiện tại khi tải lên.

• Tệp mới tải lên xuất hiện trong danh sách tệp sau khi tải lên.
• Lệnh video:filename phát thành công tệp vừa tải lên.

• Bảng điều khiển sử dụng Basic Auth — cấu hình tên người dùng/mật khẩu trong appsettings.json.
• Giới hạn tải lên tệp đơn mặc định là 500MB, có thể cấu hình trong tệp config.
• Nhân viên bảo trì tại chỗ có thể tải lên nội dung thay thế qua bảng điều khiển mà không cần RDP.

Hiểu quy tắc dùng thử và lập kế hoạch thời điểm cấp phép phù hợp.

1. Bản dùng thử 30 ngày bắt đầu tự động khi chạy SoftPlayer lần đầu.
2. Tất cả tính năng có sẵn trong thời gian dùng thử, bao gồm phát lại độ phân giải cao và tất cả lệnh UDP.
3. Kiểm tra số ngày dùng thử còn lại trên tab Dashboard của bảng quản lý.
4. Sau khi dùng thử, phải nhập mã giấy phép để tiếp tục sử dụng.

• Dashboard bảng quản lý hiển thị trạng thái dùng thử hiện tại và số ngày còn lại.
• Lệnh phản hồi bình thường trong thời gian dùng thử không có giới hạn tính năng.

• Sử dụng thời gian dùng thử để hoàn thành kiểm tra và nghiệm thu trước khi bàn giao dự án chính thức.
• Mua giấy phép trước khi hết hạn dùng thử để tránh gián đoạn triển lãm.

Chọn cấp giấy phép phù hợp dựa trên nhu cầu độ phân giải triển lãm thực tế.

1. Giấy phép Standard: hỗ trợ độ phân giải tối đa 4K (3840×2160).
2. Giấy phép Professional: hỗ trợ độ phân giải tối đa 16K (15360×8640).
3. Yêu cầu phần cứng 4K: Intel i3+, 8GB RAM, đồ họa tích hợp (không cần GPU rời).
4. Yêu cầu phần cứng 8K: Intel i5 thế hệ 8+, 16GB RAM, GTX 1060+.
5. Yêu cầu phần cứng 16K: Intel i7+, 32GB RAM, RTX 3070+.
6. Nếu không chắc cần cấp nào, dùng thử để xác minh yêu cầu độ phân giải thực tế trước khi mua.

• Cấp giấy phép khớp với độ phân giải tối đa của thiết bị hiển thị trong dự án.
• Cấu hình phần cứng máy chủ đáp ứng yêu cầu tối thiểu cho độ phân giải mục tiêu.

Máy tính không có GPU rời có thể phát 4K và thấp hơn (chương trình tự động dự phòng giải mã phần mềm), nhưng 8K/16K cần GPU rời đạt chuẩn.

Nhập mã giấy phép để nâng cấp từ dùng thử lên phiên bản đầy đủ.

1. Tìm trường ID Thiết bị trên Dashboard bảng quản lý và sao chép nó.
2. Cung cấp ID thiết bị cho nhà cung cấp, chỉ định cấp yêu cầu (Standard/Professional).
3. Sau khi nhận mã giấy phép, đi đến tab Configuration trong bảng điều khiển và tìm phần License Management.
4. Dán mã giấy phép vào trường nhập liệu và nhấp Import License.
5. Sau khi nhập thành công, trạng thái giấy phép Dashboard thay đổi từ Trial sang Standard hoặc Professional.

• Dashboard bảng quản lý hiển thị trạng thái phiên bản đầy đủ (Standard hoặc Professional).
• Phát lại video độ phân giải cao không còn bị giới hạn.

• Áp dụng mã giấy phép cho sai thiết bị (mã gắn với thiết bị; máy mới cần mã mới).
• Chờ đến sau khi hết hạn dùng thử mới xin giấy phép, gây gián đoạn triển lãm.

Khôi phục kênh điều khiển lệnh UDP.

1. Xác nhận SoftPlayer đang chạy (hiển thị trong taskbar hoặc Task Manager).
2. Xác minh cổng trong lệnh của bạn khớp với cài đặt UdpPort trong appsettings.json (mặc định 7600).
3. Kiểm tra Tường lửa Windows có cho phép lưu lượng UDP vào trên cổng 7600 không.
4. Nếu danh sách trắng IP được bật (IpWhitelistEnabled: true), xác nhận IP người gửi nằm trong AllowedIps.
5. Kiểm tra tab Log của bảng quản lý để tìm bản ghi nhận lệnh xác nhận lệnh có đến trình phát không.

• Log bảng quản lý hiển thị bản ghi nhận lệnh, xác nhận kênh UDP hoạt động.
• Gửi volume:50 thay đổi âm lượng trình phát.

• Thử trước với 127.0.0.1 (localhost) để loại trừ vấn đề mạng trước khi dùng IP thực.
• Khi gửi từ SoftControl, đảm bảo giao thức lệnh UDP và cổng của SoftControl khớp với cấu hình SoftPlayer.

Chẩn đoán và giải quyết lỗi phát lại tệp media.

1. Xác nhận tệp video nằm trong SoftPlayerMedia\Video\ (không phải thư mục gốc chương trình).
2. Tên tệp phân biệt chữ hoa/thường — xác nhận tên trong lệnh khớp chính xác với tên tệp thực tế bao gồm phần mở rộng.
3. Đối với tệp trong thư mục con, bao gồm đường dẫn tương đối: video:subfolder/video.mp4.
4. Duyệt đến tab Files trong bảng quản lý để xác nhận tệp thực sự tồn tại.
5. Đối với định dạng tệp bất thường, kiểm tra log bảng quản lý để tìm thông báo lỗi VLC.
6. Thử mở cùng tệp trực tiếp bằng VLC Player trên máy để loại trừ tệp bị hỏng.

• Tệp mục tiêu hiển thị trong danh sách tệp bảng quản lý.
• Tên tệp trong lệnh khớp chính xác với những gì hiển thị trong danh sách tệp.

• Tên tệp trong lệnh chứa khoảng trắng toàn chiều hoặc ký tự, gây lỗi tệp không tìm thấy.
• Phần mở rộng tệp không khớp chữ hoa/thường (ví dụ lệnh dùng .MP4 nhưng tệp thực là .mp4).

Giải quyết vấn đề hiệu suất phát lại video độ phân giải cao.

1. Trước tiên xác nhận cấp giấy phép hiện tại: Standard chỉ hỗ trợ 4K; Professional hỗ trợ 16K.
2. Kiểm tra GPU có hỗ trợ giải mã phần cứng không (cần GTX 1060+ hoặc tương đương cho 8K).
3. Trong tab Performance của Task Manager, kiểm tra sử dụng giải mã GPU — gần 100% biểu thị tắc nghẽn GPU.
4. Kiểm tra yêu cầu tốc độ đọc đĩa: 4K cần 25-50 Mbps, 8K cần 80-100 Mbps, 16K cần 200+ Mbps.
5. Lưu tệp video độ phân giải cao trên SSD để tránh tắc nghẽn đọc HDD.
6. Để điều chỉnh tham số VLC, xem tài liệu tích hợp (docs\User Manual.html) trong thư mục chương trình.

• Cấp giấy phép khớp với độ phân giải phát lại yêu cầu.
• Cấu hình phần cứng đáp ứng yêu cầu tối thiểu cho độ phân giải mục tiêu.

Khôi phục quyền truy cập bảng quản lý trình duyệt.

1. Xác nhận SoftPlayer đang chạy.
2. Thử http://localhost:8766/ cục bộ trước để loại trừ vấn đề mạng.
3. Kiểm tra appsettings.json để xác nhận HttpMonitor.Enabled là true và cổng là 8766.
4. Kiểm tra Tường lửa Windows có cho phép lưu lượng TCP trên cổng 8766 không.
5. Nếu cổng bị chiếm bởi chương trình khác, thay đổi HttpMonitor.Port trong appsettings.json và khởi động lại.

• Trình duyệt có thể truy cập http://localhost:8766/ và hiển thị bảng quản lý.
• Dashboard bảng quản lý hiển thị trạng thái chạy của trình phát.