LiveLed - Hướng dẫn sử dụng

Hệ thống gồm 3 màn hình, tất cả chạy trong mạng LAN, không cần internet:

Màn hình	Thiết bị	Địa chỉ	Ai dùng
Kiosk	Màn cảm ứng dọc 1080x1920	`http://<IP máy chủ>:8080/kiosk/`	PG / khách chọn logo
Display	Máy tính xuất hình ra LED (16:9)	`http://<IP máy chủ>:8080/display/`	Chạy tự động, không cần thao tác
Admin	Điện thoại hoặc máy tính	`http://<IP máy chủ>:8080/admin/`	Kỹ thuật viên, quản lý logo và cài đặt

<IP máy chủ> là địa chỉ IP của máy đang chạy start.bat. Địa chỉ đầy đủ được in ra ngay khi khởi động.

Luồng hoạt động: Kiosk hoặc Admin gửi lệnh → Máy chủ LiveLed (cùng mạng LAN) → Display (16:9) → Bộ xử lý LED (5:3).

1. Khởi động hệ thống

Trên máy chủ, mở thư mục dự án và chạy start.bat. Cửa sổ lệnh in ra 3 địa chỉ ở trên. Giữ cửa sổ này mở trong suốt sự kiện. Nếu chương trình dừng, start.bat tự khởi động lại.
Trên máy Display, mở Chrome toàn màn hình: chrome --kiosk http://<IP>:8080/display/
Trên màn kiosk, mở Chrome toàn màn hình: chrome --kiosk --overscroll-history-navigation=0 http://<IP>:8080/kiosk/
Trên điện thoại, mở http://<IP>:8080/admin/ và đăng nhập bằng PIN.

Ngay khi mở, màn Display tự chiếu lần lượt các logo. Không cần bấm gì thêm.

2. Kiosk (màn cảm ứng cho khách)

Màn hình chính

Kiosk - màn hình chính

Có 2 nút:

CHIẾU TẤT CẢ LOGO: LED chiếu lần lượt toàn bộ logo, mỗi logo theo thời gian cài trong admin.
CHỌN LOGO ĐỂ PHÁT: mở danh sách logo để chọn 1 logo.

Bấm CHIẾU TẤT CẢ LOGO, màn hình báo "Đang chiếu tất cả logo trên LED" trong vài giây:

Kiosk - đang chiếu tất cả

Chọn 1 logo

Bấm CHỌN LOGO ĐỂ PHÁT để vào danh sách. Vuốt lên xuống để xem thêm, thanh trượt bên phải cho biết đang ở đâu trong danh sách. Danh sách chia thành 5 trang màn hình:

Trang 1	Trang 2	Trang 3

Trang 4	Trang 5

Chạm vào một logo: LED đổi ngay sang logo đó, ô logo được viền xanh và hiện thông báo "Đang phát trên LED".

Kiosk - đã chọn logo

Logo được giữ trên LED trong thời gian "chọn 1 logo" (mặc định 10 giây). Hết thời gian, LED quay về chiếu tất cả, tiếp từ logo kế tiếp. Có thể đổi sang "Giữ nguyên logo" trong admin.
Bấm logo khác để đổi ngay, không cần đợi.
Bấm QUAY LẠI để về màn hình chính. Nếu không ai chạm vào màn hình sau 60 giây (chỉnh được), kiosk tự về màn hình chính và không ảnh hưởng đến LED.
Nếu mất kết nối với máy chủ, kiosk hiện dòng "Đang kết nối lại…" và tự nối lại khi có mạng.

3. Display (màn xuất ra LED)

Display

Nền trắng, logo khổ 5:3 nằm ở giữa khung 16:9. Kỹ thuật viên LED dùng bộ xử lý để lấy hình 5:3 từ khung này.
Chuyển logo bằng hiệu ứng mờ nhẹ (0,4 giây, chỉnh được).
Mở nhiều Display cùng lúc vẫn đồng bộ với nhau.
Mất kết nối: Display giữ nguyên logo cuối, tự nối lại và hiện đúng logo hiện tại.
Nếu cửa sổ chưa toàn màn hình, góc màn hình có nút để vào toàn màn hình. Khi chạy bằng chrome --kiosk thì không cần.
Thêm ?debug sau địa chỉ (ví dụ /display/?debug) để hiện chấm báo mất kết nối khi cần kiểm tra.

4. Admin (quản trị trên điện thoại)

Đăng nhập

Admin - đăng nhập

Nhập PIN rồi bấm Đăng nhập. PIN mặc định là 1234. Hãy đổi PIN trước sự kiện (xem mục Cài đặt). Nhập sai 5 lần liên tiếp sẽ bị khoá 60 giây. Phiên đăng nhập có hiệu lực 12 giờ.

Phía trên cùng có chỉ báo Đã kết nối và nút Thoát. Màn hình có 3 tab: Logo, Cài đặt, Điều khiển.

Tab Logo

Admin - Logo

+ Tải logo lên: chọn một hoặc nhiều ảnh cùng lúc (tối đa 30 ảnh, mỗi ảnh tối đa 10 MB). Chỉ nhận png, jpg, webp. Nên dùng ảnh khổ 5:3, nền trắng.
Tên: bấm vào ô tên để đổi, tên tự lưu khi bạn bấm ra ngoài.
↑ / ↓: đổi thứ tự logo. Thứ tự này áp dụng cho cả danh sách trên kiosk và thứ tự chiếu tất cả.
Ẩn / Hiện: ẩn logo khỏi kiosk và LED nhưng vẫn giữ trong danh sách.
Thay ảnh: thay ảnh của logo mà vẫn giữ tên và vị trí.
Xoá: xoá hẳn logo, không hoàn tác được.

Thay đổi áp dụng ngay cho kiosk và display, không cần tải lại trang.

Tab Cài đặt

Admin - Cài đặt

Mục	Ý nghĩa	Mặc định
Thời gian mỗi logo khi chiếu tất cả	Số giây mỗi logo hiện khi chiếu lần lượt (3 đến 300)	10 giây
Thời gian hiển thị khi chọn 1 logo	Số giây giữ logo khi khách chọn (3 đến 300)	10 giây
Sau khi hết thời gian chọn 1 logo	"Quay về chiếu tất cả" hoặc "Giữ nguyên logo"	Quay về chiếu tất cả
Thời gian chuyển mờ	Độ dài hiệu ứng chuyển logo, 0 = tắt	400 ms
Căn logo trên màn hình LED	Giữa hoặc Trái (để khớp vùng LED)	Giữa
Kiosk tự về màn đầu sau	Số giây không chạm thì kiosk về màn hình chính	60 giây

Bấm Lưu cài đặt để áp dụng. Thời gian mới áp dụng từ logo kế tiếp, không cắt ngang logo đang chiếu.

Ở cuối tab có mục Đổi PIN: nhập PIN cũ và PIN mới (4 đến 8 số). Sau khi đổi, các thiết bị khác đang đăng nhập bị đăng xuất.

Tab Điều khiển

Admin - Điều khiển

Phần trên cho biết logo đang phát, chế độ (Chiếu tất cả hoặc Chọn 1 logo), thời gian còn lại, và số thiết bị đang kết nối (Kiosk, Display, Admin). Nếu Display báo 0, hãy kiểm tra máy Display.
Chiếu tất cả logo: chuyển về chiếu lần lượt.
Chạm vào một logo trong lưới để chiếu logo đó lên LED ngay, giống như chọn trên kiosk. Dùng khi cần điều khiển từ xa hoặc kiosk gặp sự cố.

5. Xử lý sự cố

Hiện tượng	Cách xử lý
Kiosk hiện "Đang kết nối lại…"	Kiểm tra dây mạng và máy chủ còn chạy không. Kiosk tự nối lại, không cần tải lại trang.
LED không đổi khi chọn logo	Mở admin tab Điều khiển, xem số Display. Nếu bằng 0, mở lại trang `/display/`.
Display đứng ở một logo	Bình thường nếu đang ở chế độ "Giữ nguyên logo". Bấm Chiếu tất cả logo để chạy lại.
Quên PIN	Tắt máy chủ, mở `data\db.json`, xoá toàn bộ mục `"auth": {...}` rồi chạy lại `start.bat`. PIN trở về `1234`, đăng nhập rồi đổi PIN mới.
Điện thoại không vào được admin	Điện thoại phải cùng mạng với máy chủ. Mở cổng 8080 trong Windows Firewall.
Máy chủ báo lỗi hoặc tắt đột ngột	Chạy lại `start.bat`. Dữ liệu được lưu liên tục và có bản sao `db.json.bak`.

6. Danh sách kiểm tra trước giờ G

☐ Máy chủ có IP tĩnh, mở cổng 8080 trên Windows Firewall.
☐ Đã đổi PIN admin.
☐ Đã kiểm tra tên, thứ tự, hình của tất cả logo.
☐ Đã chỉnh 2 thời gian (chiếu tất cả, chọn 1 logo).
☐ Máy Display và kiosk dùng dây LAN, tắt sleep, tắt update và thông báo Windows.
☐ Thử rút mạng khoảng 1 phút rồi cắm lại, Display và kiosk tự nối lại.
☐ Thử chọn một logo trên kiosk và xem LED đổi ngay.