Android • 1.3 beta

Hướng dẫn sử dụng SantaQueue 1.3 beta

Cài đặt máy chủ Android, kết nối kiosk, quầy và Smart TV, rồi vận hành từ lúc khách lấy số đến khi hoàn tất lượt.

SANTAQUEUEHƯỚNG DẪN SỬ DỤNGAndroid 1.3 beta · versionCode 4

Phạm vi hướng dẫn

Tài liệu dành cho người lắp đặt và nhân viên vận hành mô hình dùng Android làm máy chủ tại cơ sở. Quầy và TV nhận dữ liệu từ máy chủ qua mạng nội bộ.

Cập nhật 15/11/2026Nền tảng Android 8.0+Phiên bản 1.3 beta · versionCode 4

1. Bắt đầu nhanh

  1. Cài APK SantaQueue 1.3 beta do Santa cung cấp trên tablet Android. Chọn tablet chính làm máy chủ.
  2. Tạo PIN quản trị. Vào Quản trị → Máy chủ LAN — Bật / tắt → Bật máy chủ. Ghi lại địa chỉ IPv4 và cổng đang hiển thị.
  3. Tạo dịch vụ và quầy. Nếu in phiếu, cấu hình máy in trên từng kiosk có máy in và in thử.
  4. Ghép quầy, kiosk phụ nếu có và TV bằng thông tin theo từng vai trò. Trên TV, bấm Bật âm thanh để nghe mẫu.
  5. Lấy một số thử. Kiểm tra phiếu giấy, số trên quầy và TV, lời gọi và báo cáo khi hoàn tất lượt.

2. Chuẩn bị thiết bị và mạng

Vai trò thiết bị trong SantaQueue
Thiết bịVai trò
Tablet Android ServerLưu hàng đợi, cấu hình và báo cáo. Có thể dùng cùng tablet làm màn hình lấy số.
Tablet Android kiosk phụGhép với máy chủ để lấy số theo dịch vụ. Nếu in, dùng cấu hình máy in của kiosk đó.
Điện thoại hoặc tablet tại quầyNhận, gọi, gọi lại và hoàn tất lượt. Có thể dùng ứng dụng Android hoặc trang quầy trên trình duyệt.
Smart TV hoặc thiết bị phát lên TVMở bảng TV bằng trình duyệt, hiển thị số và phát lời gọi.

Ứng dụng yêu cầu Android 8.0 trở lên. Dùng một mạng LAN nội bộ cho máy chủ, máy con và TV. Nếu thiết bị nối cùng Wi-Fi mà không thấy nhau, kiểm tra mạng khách hoặc tùy chọn cách ly thiết bị của bộ phát. Nên giữ IP máy chủ ổn định bằng đặt trước địa chỉ trên router. Cổng mặc định là 8989.

Cấp quyền mạng nội bộ khi Android hỏi. Với máy in Bluetooth hoặc USB, cấp quyền tương ứng khi kết nối. Nếu cài APK trực tiếp, tải từ nguồn Santa cung cấp và cho phép trình duyệt hoặc trình quản lý tệp cài ứng dụng khi Android yêu cầu. Trước khi cập nhật hệ thống đang chạy, hãy tạo bản sao lưu.

3. Khởi tạo máy chủ và ghép thiết bị

Tạo PIN và mở máy chủ LAN

Ở lần đầu, chọn chế độ máy chủ, nhập và xác nhận PIN quản trị. PIN này dùng để quản trị trên máy chủ. Khi ghép máy con, dùng mã ghép nối theo vai trò. Khi máy chủ đã bật, để tablet có nguồn điện và kiểm tra bảng TV hoặc quầy từ một thiết bị khác.

Ghép kiosk phụ, quầy và TV

  • Kiosk phụ: Trên máy chủ, vào Quản trị → Cài đặt quầy để lấy hoặc tạo mã kiosk. Trên tablet phụ, chọn vai trò máy lấy số, nhập IPv4, cổng và mã ghép. Nếu có nhiều cấu hình kiosk, chọn đúng kiosk của khu vực.
  • Quầy: Lấy mã quầy ở Cài đặt quầy, hoặc dùng mật khẩu cố định dành cho quầy nếu quản trị đã đặt. Trên ứng dụng chọn vai trò quầy, hoặc mở http://192.168.1.50:8989/staff trên trình duyệt và ghép nối. Thay IP và cổng ví dụ bằng thông số thực tế. Sau đó chọn quầy được giao.
  • TV: Vào Quản trị → Cài đặt Smart TV để lấy mã hoặc sao chép đường dẫn của máy chủ. Ví dụ http://192.168.1.50:8989/tv#123456. Mở liên kết trên TV và bấm Bật âm thanh.

Mã ghép có thời hạn. Khi mã hết hạn, tạo mã mới cho thiết bị chưa ghép. Thiết bị đã ghép vẫn có thể kết nối lại bằng phiên đã lưu. Dùng tùy chọn thu hồi ghép nối của máy chủ khi cần ngắt các thiết bị đã đăng ký.

4. Thiết lập dịch vụ, quầy và kiosk

Dịch vụ và dãy số

Vào Quản trị → Quản lý dịch vụ. Đặt tên, tiền tố, độ rộng phần số và giới hạn dãy theo nhu cầu. Ví dụ tiền tố 1 với phần số 5 chữ số có thể cho số đầu 100001 khi số bắt đầu là 1. Chọn dãy khác nhau giữa các dịch vụ để khách dễ phân biệt.

Có thể ẩn nút của dịch vụ trên kiosk. Nếu dịch vụ đã có phiếu hoặc lịch sử liên quan, ứng dụng có thể chặn xóa. Dùng ẩn nút khi chỉ muốn ngừng nhận lượt mới.

Quầy phục vụ

Trong Cài đặt quầy, thêm quầy, đặt số và tên hiển thị, rồi gán các dịch vụ mà quầy được xử lý. Quầy nhận tất cả dịch vụ khi danh sách phân công để trống. Có thể đặt tên như Quầy 1 hoặc Phòng khám 301. Bộ đọc tiếng Việt đọc các tên theo dạng này thành “Quầy số 1” hoặc “Phòng khám số 301”.

Cấu hình riêng từng kiosk

Vào Quản trị → Kiosk lấy số. Thêm hồ sơ theo tên cửa hoặc khu vực. Giữ Tất cả dịch vụ hoặc chọn một nhóm dịch vụ. Nếu có nhiều hồ sơ, chọn kiosk tương ứng trên màn hình lấy số để thiết bị lưu lựa chọn cho lần sau. Các dịch vụ đã ẩn hoặc vượt hạn mức sẽ không hiện để lấy số.

Trong Cài đặt hệ thống, có thể chỉnh thiết kế kiosk và mẫu phiếu. Tùy chỉnh tiêu đề, bố cục nút, ảnh nền hoặc biểu tượng dịch vụ, sau đó xem thử ở đúng chiều màn hình sẽ sử dụng.

5. Kết nối máy in và kiểm tra phiếu

Trên máy chủ kiêm kiosk, vào Quản trị → Cài đặt hệ thống → Cấu hình máy in và phiếu. Với kiosk phụ, mở phần cấu hình máy in trên chính thiết bị đó. Chọn kết nối phù hợp với cổng của máy in.

Kết nốiCách thiết lập
IP / LANNhập IP máy in và cổng in của thiết bị. Nếu máy in dùng cổng RAW mặc định, thử 9100.
Bluetooth Classic SPPGhép máy in trong Android, cấp quyền Bluetooth rồi chọn đúng máy in trong ứng dụng.
USB OTGDùng tablet và cáp/hub hỗ trợ OTG. Cắm máy in, chọn thiết bị và cấp quyền USB khi Android hỏi.

Chọn khổ in, số dòng đẩy giấy và tùy chọn cắt phù hợp với máy. Bấm in thử, xem kết quả trên giấy rồi bật Tự in khi khách lấy số. Với máy in demo thông thường, xác nhận đã nhận phiếu thử nếu ứng dụng yêu cầu.

6. Lấy số và phục vụ

  1. Khách chọn dịch vụ tại kiosk và lấy phiếu. Nếu màn hình báo đã gửi lệnh in, xác nhận kết quả bằng phiếu giấy.
  2. Nhân viên mở quầy, chọn Gọi số tiếp theo. Nếu đã bật tự phân, khi khách lấy số và có quầy đang trực, rảnh và phù hợp mà không còn phiếu cũ chờ quầy đó, SantaQueue có thể chuyển thẳng phiếu tới quầy đó.
  3. Khi khách đến, xác nhận khách có mặt để chuyển sang đang phục vụ. Bấm hoàn tất khi xong.
  4. Nếu khách chưa đến, thực hiện hai lần gọi lại theo chế độ của hệ thống. Sau khoảng chờ cuối, bấm Đánh dấu vắng mặt rồi gọi số tiếp theo nếu còn người chờ.

Vào Cài đặt hệ thống → Vận hành / Gọi số / Thông báo phiếu để đặt tên cơ sở, thời gian chờ gọi lại, chế độ tự gọi lại, tự phân và cách xưng hô. Thời gian thông báo nhận phiếu nhận giá trị 0–5 giây. Đặt 0 để ẩn thông báo nhận phiếu thành công. Cảnh báo máy in vẫn hiển thị.

Ví dụ đặt gọi lại tự động mỗi 5 giây thì lượt đầu ở giây 0, hai lần gọi lại khoảng giây 5 và giây 10. Từ khoảng giây 15, nhân viên có thể đánh dấu vắng mặt. Ở chế độ thủ công, nhân viên bấm hai lần gọi lại và chờ đủ khoảng chờ sau lần cuối.

7. Cài bảng TV và giọng đọc

Trong Cài đặt Smart TV, chọn ngang hoặc dọc, điều chỉnh ảnh nền và độ tối nền theo màn hình thực tế. Có thể đặt thông báo chạy chữ từ mục thông báo TV. Mở đường dẫn bảng TV riêng trên trình duyệt và bật toàn màn hình nếu thiết bị hỗ trợ.

  1. Trên Android Server, tìm Chuyển văn bản thành giọng nói trong cài đặt Android. Chọn bộ đọc và tải dữ liệu giọng tương ứng. Với lời gọi tiếng Việt, ưu tiên giọng tiếng Việt có thể chạy ngoại tuyến.
  2. Nghe thử giọng trong cài đặt Android. Tắt rồi bật lại máy chủ SantaQueue để nạp giọng vừa cài.
  3. Tại TV, tải lại bảng, bấm Bật âm thanh và nghe mẫu. Sau đó phát sinh một lượt gọi mới khi TV đã kết nối. Thử cả lượt tự phân đầu tiên và lượt gọi lại.

Máy chủ tổng hợp lời gọi thành tệp âm thanh và TV tải tệp qua LAN. Nếu thông báo yêu cầu cài giọng đọc, kiểm tra máy chủ Android. Nếu đã có giọng nhưng TV im tiếng, kiểm tra âm lượng, bật lại âm thanh trên trang TV hoặc mở cùng địa chỉ trên trình duyệt khác để đối chiếu.

8. Demo và kích hoạt bản quyền

Chế độĐiều kiện sử dụng
Demo với HPRT TP80N-M hoặc TP80KTối đa 20 phiếu mỗi ngày khi nhận diện đúng model. Demo không yêu cầu serial.
Demo với máy in thông thườngTối đa 10 phiếu mỗi ngày cho nhóm máy in thông thường, trong giới hạn demo chung 20 phiếu/ngày. Xác nhận in thử trước khi dùng nếu được yêu cầu.
Đã kích hoạtMáy in kiosk phải là HPRT TP80N-M hoặc TP80K có serial được duyệt. Áp dụng số kiosk, quầy, TV và hạn mức dịch vụ nếu key có cấu hình.
  1. Chuẩn bị model và serial của các máy in đưa vào sử dụng. Có thể đọc nhận dạng máy in trong phần cấu hình máy in.
  2. Khi Android Server có Internet, mở Cài đặt hệ thống → Bản quyền / Kích hoạt offline, nhập key cấp cho cơ sở và kích hoạt.
  3. Kiểm tra thông báo đã kích hoạt và số thiết bị được cấp. Khi Santa thay đổi hạn mức hoặc danh sách máy in, kết nối Internet và bấm Làm mới bản quyền.

Sau khi kích hoạt hợp lệ, cấp số, gọi số và bảng TV tiếp tục hoạt động qua LAN khi Internet gián đoạn. Giọng đọc ngoại tuyến trên Android Server cần được cài và thử riêng. Nếu đã dùng hết suất, kiểm tra liên kết thiết bị và quyền được cấp trước khi ghép thêm.

9. Báo cáo và chuyển ngày

Vào Quản trị → Báo cáo ngày / Quầy / Dịch vụ, chọn ngày cần xem và làm mới báo cáo. Đối chiếu số phát, hoàn tất, vắng mặt và tồn cuối. Xuất CSV nếu cần tổng hợp trên máy tính. Phiếu phát ngày trước có thể được ghi nhận hoàn tất hoặc vắng mặt vào ngày xử lý.

Trong Quản trị → Xử lý phiếu qua ngày, chọn xử lý tự động hoặc chủ động đóng các phiếu tồn. Ở chế độ yêu cầu xử lý thủ công, quản trị cần xử lý phiếu chưa hoàn tất trước khi phát số ngày mới. Lịch sử và báo cáo vẫn được giữ.

10. Sao lưu, cập nhật và khôi phục

  1. Trên máy chủ, vào Cài đặt hệ thống → Sao lưu và khôi phục → Tạo bản sao lưu. Lưu tệp ZIP vào nơi riêng tư và có thể đọc lại khi tablet gặp sự cố.
  2. Trước khi khôi phục, sao lưu dữ liệu đang có trên máy đích rồi tắt máy chủ LAN. Chọn Khôi phục bản sao lưu, mở đúng tệp ZIP và đọc xác nhận trước khi đồng ý. Khôi phục thay thế dữ liệu hiện có của máy đích.
  3. Bật lại máy chủ, kiểm tra dịch vụ, quầy, thiết kế và lịch sử. Ghép lại thiết bị và kiểm tra máy in. Nếu thay tablet, liên hệ Santa để xử lý kích hoạt trên máy chủ mới khi cần.

11. Xử lý sự cố

Hiện tượngCách kiểm tra
Quầy hoặc TV không kết nốiKiểm tra máy chủ đã bật, IP/cổng đúng, các thiết bị cùng LAN và mã ghép còn hiệu lực. Nếu IP đổi, dùng liên kết mới từ Android Server.
Kiosk không thấy một dịch vụKiểm tra nút dịch vụ đang bật, hồ sơ kiosk chọn đúng và dịch vụ nằm trong hạn mức key.
Máy in không in hoặc bị từ chốiKiểm tra giấy, nắp, nguồn, cáp/mạng và quyền kết nối. Với key đã kích hoạt, đối chiếu model và serial đã duyệt rồi làm mới bản quyền nếu vừa thay đổi trên máy chủ cấp key.
TV có số nhưng không phát loaBấm Bật âm thanh, thử giọng trên máy chủ và kiểm tra âm lượng TV. Khi thử gọi, phát sinh lượt mới sau khi TV đã đồng bộ.
Chưa bấm được Vắng mặtKiểm tra đã đủ hai lần gọi lại và đã hết khoảng chờ sau lần gọi thứ ba.
Kiosk LAN chưa xác nhận đã cấp sốKhôi phục kết nối tới cùng máy chủ và dùng thao tác thử lại hiện trên màn hình. Yêu cầu cũ được giữ để tránh cấp thêm số.
Khôi phục bị chặnTắt máy chủ LAN, kiểm tra đúng tệp sao lưu của SantaQueue Android và thử lại.

Kiểm tra trước khi đưa vào sử dụng

Thử cấp phiếu và gọi số trên từng quầy, nghe lời gọi đầu trên TV, kiểm tra key và tạo bản sao lưu. Nếu cần vận hành khi Internet gián đoạn, thử lại khi mạng LAN vẫn kết nối.

Trở về Mục lục