Chế độ chơi 1 · 2 · nhiều người

Phòng chơi, mã/QR tham gia, ghép cặp online, đồng bộ realtime, mất kết nối và cách xếp hạng, trao quà khi nhiều người chơi cùng lúc.

Mục tiêu

Mục tiêu	Chỉ số đo	Ngưỡng MVP
Vào phòng tại booth không cần nhân viên hướng dẫn	Thời gian từ quét QR đến "Đã kết nối" (đã có SĐT)	≤ 15 giây ở p90
Hai người thấy cùng một trận	Độ lệch hiển thị giữa TV và điện thoại	≤ 150 ms ở p95
Rớt mạng không làm hỏng trận	Tỉ lệ phòng bị Huỷ do mất kết nối	≤ 3%
Đông người vẫn chơi được	Số người cùng phòng nhiều người	Hàng trăm (Cáo gom lộc) — số đo tải: Hiệu năng & vận hành

Ngoài phạm vi

Vòng đời phiên chơi, lượt, kiểm tra điểm, quay thưởng của từng người — Khung game.
Chat, voice giữa người chơi; bạn bè / danh bạ trong nền tảng.
Đấu với máy (bot) — MVP không có.

So sánh 3 chế độ

	1 người	2 người	Nhiều người
Kiểu	Chơi một mình	Đối đầu (Cáo đối đầu) hoặc hợp tác	Cùng lúc, mỗi người tự chơi, chung bảng điểm (Cáo gom lộc) hoặc cùng góp nội dung (Cây lời chúc)
Phòng chơi	Không; riêng mô hình C (TV + tay cầm) có phòng 1 chỗ để ghép điện thoại với TV	Có, 2 chỗ	Có, nhiều chỗ
Nơi chơi	Mọi kênh	Booth: TV + 2 điện thoại · Online: 2 điện thoại	Booth: TV + điện thoại quét QR · Online: cùng giờ trên điện thoại
Realtime	Không (trừ mô hình C)	Bắt buộc	Bảng điểm cập nhật gần thực; luật chơi không phụ thuộc người khác
Kết quả quyết bởi	Điểm / may mắn của người đó	So 2 người	Xếp hạng trong phòng hoặc ngưỡng điểm cá nhân
Game mẫu	1, 2, 3, 4, 5, 8	6	7, 9 (10: 1 nhóm 1–4 người, tính như 1 phiên)

Luật từng game: 10 game mẫu.

Vai trò

Vai trò	Trong phòng chơi
Người chơi	Quét QR / nhập mã / mở link mời, bấm "Sẵn sàng", chơi, rời phòng
Chủ phòng (người chơi tạo phòng online)	Gửi link mời, bắt đầu sớm khi đủ tối thiểu, huỷ phòng khi chưa bắt đầu
Thiết bị TV / kiosk	Tự tạo phòng mới khi phòng trước kết thúc; hiện QR, danh sách chỗ, trận đấu, kết quả
Nhân viên booth	Bắt đầu / huỷ phòng tại điểm của mình, mời người khỏi chỗ, xem cảnh báo `.ds-ops` (độ trễ, rớt kết nối)

Phòng chơi

Luồng tại booth (TV + điện thoại)

TV thuộc điểm activation tự tạo phòng, hiện QR lớn + mã 4 số + các ô chỗ trống.
Người chơi quét QR → mở Zalo Mini App / web → định danh SĐT nếu chưa có.
Server kiểm tra còn lượt và còn chỗ → giữ chỗ; TV sáng ô, hiện tên hiển thị.
Người chơi bấm "Sẵn sàng". Đủ điều kiện bắt đầu → đếm ngược 3-2-1 trên TV, điện thoại rung.
Lúc bắt đầu: mỗi người được mở phiên chơi riêng và trừ lượt (theo Khung game).
Kết thúc → TV và điện thoại hiện kết quả cùng lúc → TV tạo phòng mới sau 15 giây.

Luồng online

Người chơi chọn "Chơi với bạn" (tạo phòng, nhận link mời) hoặc "Tìm đối thủ" (ghép ngẫu nhiên).
Mời bạn: chia sẻ link qua Zalo — người nhận mở link, định danh, vào phòng. Ghép ngẫu nhiên: vào hàng chờ của campaign × game.
Từ bước "Sẵn sàng" giống luồng booth; hiển thị trên điện thoại thay cho TV.

Đang chờ→Đang chơi→Kết thúc·Huỷ

Trạng thái phòng chơi chưa có trong Thuật ngữ — cần bổ sung.

Từ	Sang	Ai / điều kiện
—	Đang chờ	TV/kiosk tự tạo; hoặc người chơi tạo phòng online
Đang chờ	Đang chơi	Đủ số người tối thiểu đều "Sẵn sàng"; hoặc hết thời gian chờ mà đã đủ tối thiểu; hoặc nhân viên booth / chủ phòng bấm bắt đầu
Đang chờ	Huỷ	Hết thời gian chờ mà chưa đủ tối thiểu; chủ phòng / nhân viên huỷ; campaign Tạm dừng
Đang chơi	Kết thúc	Hết luật chơi (hết hiệp, hết giờ); hoặc chỉ còn 1 người ở game đối đầu
Đang chơi	Huỷ	Tất cả người chơi mất kết nối quá hạn; lỗi server

Tham số phòng	2 người	Nhiều người	Ai đặt
Sức chứa	2	2–500, mặc định 200	Manifest game (trần) → campaign chọn
Tối thiểu để bắt đầu	2	1	Manifest game
Thời gian chờ tối đa	3 phút	60 giây sau người thứ nhất, hoặc theo lịch (phòng giờ vàng 20:00)	Campaign
Vào giữa trận	Không	Cáo gom lộc: không; Cây lời chúc: có (phòng mở suốt sự kiện)	Manifest game

Mã / QR tham gia & ghép cặp

Mã	Quy tắc	Ví dụ
BR-MODE-01	Mã tham gia tại booth: 4 chữ số, hết hạn sau 60 giây, đổi mới liên tục trên TV; mỗi lần quét chỉ giữ được 1 chỗ	Người đứng xa chụp QR gửi bạn ở nhà → hết hạn trước khi dùng
BR-MODE-02	QR booth gắn với thiết bị + điểm activation; người chơi phải ở điểm đó — kiểm tra bằng mã đổi liên tục, không dùng GPS
BR-MODE-03	Một người chơi chỉ ở 1 phòng tại một thời điểm. Vào phòng mới → tự rời phòng cũ (nếu phòng cũ chưa bắt đầu)
BR-MODE-04	Không giữ chỗ nếu hết lượt; kiểm tra lượt khi vào phòng và trừ lượt khi phòng bắt đầu	Hết lượt → "Bạn đã hết lượt hôm nay" ngay khi quét
BR-MODE-05	Ở phòng chờ quá 30 giây không bấm "Sẵn sàng" khi người kia đã sẵn sàng → mất chỗ
BR-MODE-06	Link mời Zalo: dùng 1 lần, hết hạn 10 phút hoặc khi phòng đầy/bắt đầu	Gửi vào nhóm 20 người → người mở đầu tiên vào được
BR-MODE-07	Ghép ngẫu nhiên: cùng campaign × game × kênh; chờ tối đa 45 giây, không ghép được → gợi ý mời bạn hoặc chơi 1 người (nếu game hỗ trợ); không trừ lượt
BR-MODE-08	Không ghép 2 phiên của cùng người chơi, hoặc 2 người chơi cùng thiết bị	Chống tự đấu để ăn quà thắng — Chống gian lận
BR-MODE-09	TV chỉ hiện tên hiển thị; không hiện SĐT. Tên hiển thị lọc từ cấm trước khi lên TV

Đồng bộ realtime & mất kết nối

Mã	Quy tắc	Ví dụ
BR-MODE-10	Server là nguồn sự thật của trận: thời gian, lượt đi, lựa chọn, tỉ số. Thiết bị chỉ gửi thao tác và vẽ trạng thái server trả về	Cáo đối đầu: TV chỉ mở kết quả khi server nhận đủ 2 lựa chọn hoặc hết 5 giây
BR-MODE-11	Lựa chọn kín: server không gửi lựa chọn của người này cho thiết bị người kia trước khi mở kết quả	Điện thoại B chỉ thấy "Áo đỏ đã chọn"
BR-MODE-12	Đo độ trễ khi ghép và trong trận. Ngưỡng: ≤ 150 ms bình thường · 150–300 ms chơi tiếp · > 300 ms hiện `.ds-ops` cho nhân viên	Nên có Wi-Fi riêng cho booth
BR-MODE-13	Cửa sổ thao tác tính theo giờ server; thao tác đến sau hạn = không chọn → hệ thống chọn ngẫu nhiên, ghi "Tự động"
BR-MODE-14	Mất kết nối: giữ chỗ và tạm dừng trận (game đối đầu) tối đa 15 giây; về kịp → chơi tiếp từ trạng thái server
BR-MODE-15	Quá 15 giây — game đối đầu: người rớt bị xử thua, người còn lại thắng; game nhiều người: người rớt dừng ở điểm hiện tại, những người khác chơi tiếp
BR-MODE-16	Trả lượt khi rớt kết nối: chỉ khi nguyên nhân phía nền tảng (server / mạng booth do nhân viên báo); rớt phía người chơi không trả	Game 4 (1 người, mô hình C): quá hạn → lượt không tính, trả lại lượt
BR-MODE-17	Chủ động rời giữa trận = bỏ cuộc: game đối đầu xử thua; phiên của người rời thành Bỏ dở
BR-MODE-18	Bảng điểm nhiều người trên TV cập nhật mỗi 2 giây; điểm trên TV là điểm tạm, chỉ điểm sau kiểm tra mới tính xếp hạng

Xếp hạng & trao quà trong phòng

Chế độ	Xếp hạng	Ai được quay thưởng / nhận quà
2 người đối đầu	Tỉ số sau 3 hiệp; hoà → luân lưu 1 lượt	Thắng: quay trong nhóm quà chính · Thua: quay trong nhóm quà động viên
2 người hợp tác	Điểm chung của đội	Cả 2 cùng kết quả: đạt ngưỡng → mỗi người quay riêng
Nhiều người, xếp hạng phòng	Điểm sau kiểm tra; hoà → ai đạt trước xếp trên	Top N của phòng (campaign đặt N) quay nhóm quà top; còn lại đạt ngưỡng tối thiểu → quay nhóm quà tham gia
Nhiều người, cá nhân	Không xếp hạng phòng	Theo kiểu trao quà của từng người — Khung game
Cây lời chúc	Không	Quà nhỏ sau khi gửi lời chúc (không chờ duyệt)

Mã	Quy tắc	Ví dụ
BR-MODE-19	Mỗi người trong phòng tối đa 1 lượt trúng / phòng. Quay thưởng chạy riêng cho từng người, dùng chung cơ cấu giải và tồn của campaign/điểm
BR-MODE-20	Thắng do đối thủ bỏ cuộc / rớt mạng: được quay nhóm quà chính nếu đã chơi ≥ 1 hiệp đầy đủ; chưa → quay nhóm quà động viên	Chống "dàn xếp rời trận"
BR-MODE-21	Phòng Huỷ: không ai được quay thưởng; trả lượt cho mọi người nếu lỗi phía nền tảng
BR-MODE-22	Người có phiên Không hợp lệ bị loại khỏi xếp hạng phòng; người xếp sau được đẩy lên
BR-MODE-23	Kết quả phòng nhiều người công bố trên TV sau khi kiểm tra xong toàn bộ phiên, tối đa 10 giây sau khi hết giờ

Màn hình

Màn	Kênh	Thành phần chính	Hành động
Phòng chờ booth	TV	`.ds-join--lg` QR + mã 4 số, `.ds-lobby` + `.ds-slot` (áo đỏ / áo xanh), top hôm nay	—
Đã kết nối	Điện thoại	Tên, màu đội, trạng thái người kia	Sẵn sàng · Rời phòng
Tạo phòng online	Điện thoại	Link mời, ô chỗ, đồng hồ chờ	Mời qua Zalo · Huỷ
Tìm đối thủ	Điện thoại	Đếm thời gian chờ	Huỷ · Mời bạn thay thế
Đang chơi	TV + điện thoại	`.ds-versus`, `.ds-rounds`, `.ds-secret` (đối đầu); bảng điểm + "đang chơi: 248 người" (nhiều người)	Theo game
Chờ kết nối lại	TV + điện thoại	Đếm 15 giây, tên người rớt	—
Kết quả phòng	TV + điện thoại	Người thắng / top N, tỉ số; điện thoại hiện quà của chính mình	Theo Khung game
Điều khiển nhân viên	Điện thoại / iPad nhân viên	Phòng hiện tại, độ trễ từng thiết bị, `.ds-ops`	Bắt đầu · Huỷ phòng · Mời khỏi chỗ

Mẫu màn: 10 game mẫu (game 4, 6, 7, 9).

Ngoại lệ & lỗi

Tình huống	Hệ thống xử lý	Thông báo hiển thị
Quét QR hết hạn	Không vào phòng	"Mã đã hết hạn. Quét lại mã trên màn hình"
Phòng đầy	Không giữ chỗ; booth: gợi ý chờ phòng sau	"Phòng đã đủ người. Lượt sau bắt đầu sau ít phút"
Người thứ 2 không vào trong thời gian chờ	Phòng Huỷ, không trừ lượt	"Chưa có đối thủ. Mời bạn hoặc thử lại"
TV mất mạng giữa trận	Trận tạm dừng; điện thoại hiện "Đang chờ màn hình"; quá 15 giây → Huỷ, trả lượt	`.ds-ops` cho nhân viên
Campaign Tạm dừng khi phòng Đang chờ	Phòng Huỷ, không trừ lượt	"Chương trình tạm dừng"
Hết quà trong khi phòng đang chơi	Người thắng nhận "chưa trúng" theo BR-QUA-03 — Kho quà	"Tiếc quá, chưa trúng lần này"

Tiêu chí nghiệm thu

AC-MODE-01Cho mã tham gia đã hiện quá 60 giây, khi người chơi nhập mã đó, thì bị từ chối và được yêu cầu quét lại.
AC-MODE-02Cho phòng 2 người đã có 2 người, khi người thứ 3 quét QR, thì nhận "Phòng đã đủ người" và không phòng nào bị thay đổi.
AC-MODE-03Cho Cáo đối đầu, khi A đã chọn hướng, thì dữ liệu thiết bị B nhận được không chứa hướng của A cho tới lúc mở kết quả.
AC-MODE-04Cho một người không chọn trong 5 giây, thì hệ thống chọn ngẫu nhiên và hiện "Tự động" trên TV.
AC-MODE-05Cho người chơi mất mạng 10 giây giữa trận đối đầu, khi kết nối lại, thì trận chơi tiếp với tỉ số và vai đúng như trước khi rớt.
AC-MODE-06Cho người chơi mất mạng 16 giây giữa trận đối đầu, thì người còn lại được xử thắng và quà theo BR-MODE-20.
AC-MODE-07Cho phòng Huỷ do người thứ 2 không vào, thì không ai bị trừ lượt.
AC-MODE-08Cho link mời Zalo đã có người dùng, khi người thứ hai mở link, thì nhận thông báo phòng đã đủ / link hết hiệu lực.
AC-MODE-09Cho ghép ngẫu nhiên không có ai trong 45 giây, thì người chơi được gợi ý mời bạn và lượt không bị trừ.
AC-MODE-10Cho phòng Cáo gom lộc 200 người, khi hết giờ, thì TV hiện top N trong ≤ 10 giây và mỗi điện thoại hiện quà của chính người đó.
AC-MODE-11Cho cùng một SĐT trên 2 điện thoại, khi vào ghép ngẫu nhiên, thì không bị ghép với chính mình.

Câu hỏi mở

#	Câu hỏi	Hỏi ai
Q-MODE-01	MVP có chế độ 2 người online (ghép ngẫu nhiên, mời qua Zalo) không, hay chỉ 2 người tại booth?	FCM
Q-MODE-02	Có game 2 người hợp tác trong lộ trình không? 10 game mẫu chưa có.	FCM / Đội game
Q-MODE-03	Người thua trận đối đầu có chắc được quà động viên, hay chỉ được quay trong nhóm quà động viên?	FCM
Q-MODE-04	Phòng nhiều người online "giờ vàng" theo lịch có cần không? Ai đặt lịch (campaign)?	FCM
Q-MODE-05	Trạng thái phòng chơi cần bổ sung vào Thuật ngữ — PM xác nhận bộ: Đang chờ · Đang chơi · Kết thúc · Huỷ.	PM

Lịch sử thay đổi

Bản	Ngày	Người sửa	Nội dung
0.1	2026-11-11	PM	Nháp khởi tạo