Hướng dẫn vận hành LiveKit Manager

1. Nắm rõ các trạng thái

• Worker báo kết nối của máy tới manager; worker chủ động kết nối ra ngoài bằng WebSocket bảo mật trên server.
• OBS báo trạng thái ứng dụng, scene, recording và output của encoder.
• Preview là bản xem từ OBS. Nó không chứng minh TikTok nhận được luồng.
• TikTok LIVE chỉ chuyển sang “đã mở” hoặc “người vận hành xác nhận” sau khi người trực mở trang LIVE và tự kiểm tra.

Không dán mật khẩu TikTok, stream key hoặc thông tin đăng nhập vào ghi chú, tên profile hay URL. Manager chỉ nhận cờ cho biết đích OBS đã cấu hình; worker không gửi địa chỉ đích hay stream key lên manager.

2. Chuẩn bị OBS trên từng máy

1. Mở OBS trong cùng phiên Windows của worker. Trong cài đặt WebSocket, bật server, giữ địa chỉ ở máy cục bộ (mặc định 127.0.0.1:4455) và đặt xác thực.
2. Tạo các scene cần dùng, tối thiểu một scene nội dung như Game và một scene chờ như Standby. Kiểm tra capture game, giả lập hoặc avatar và nguồn tiếng trực tiếp trong OBS.
3. Nếu được cấp quyền phát, cấu hình đích phát theo quy trình được nền tảng cho phép ngay trong OBS/LIVE workflow. Không dùng buổi công khai để thử cấu hình.
4. Để recording riêng tư, hãy xác nhận thư mục lưu và dung lượng trống trên máy. Manager không tự xóa file hết hạn.

Preflight sẽ chặn khi OBS chưa xác nhận có đủ cấu hình đích phát. Nếu chưa có đích thử được phê duyệt, chỉ dùng preview và các thao tác đọc trạng thái; không bấm bắt đầu phiên phát.

3. Enroll và kết nối worker

1. Trong Tài khoản, admin cấp token riêng theo đúng worker ID. Token chỉ hiển thị một lần; trên máy OBS chạy lại scripts/install-worker-task.ps1 với cùng worker ID rồi nhập token tại lời nhắc ẩn. Nếu task đang chạy, installer dừng task trước khi thay cấu hình được bảo vệ và chạy lại sau đó. Không ghi token vào ghi chú hay chat; manager chỉ lưu bản băm.
2. Trên máy OBS, chạy scripts/install-worker-task.ps1 trong phiên người dùng OBS với worker ID, địa chỉ manager wss://<manager>/ws/worker và trang LIVE của tài khoản (nếu có).
3. Installer hỏi mật khẩu OBS WebSocket cục bộ và lưu cấu hình vào thư mục được Windows ACL bảo vệ. Task chạy sau khi người dùng đăng nhập; OBS phải đang chạy trong phiên đó.
4. Trên manager, xác nhận máy hiện online, OBS đã kết nối và version worker đúng. Dùng preview để kiểm tra ảnh; xem scene và audio meter nếu có.

Để gỡ máy, dùng scripts/uninstall-worker-task.ps1 -WorkerId "studio-01". Thêm -RemoveConfig nếu cần xóa token và mật khẩu OBS được lưu tại máy.

4. Tạo profile nội dung

1. Mở Profiles và tạo profile loại game, emulator, avatar hoặc other.
2. Chọn scene OBS chính, scene an toàn, và tên tiến trình nội dung nếu preflight cần kiểm tra app đang chạy.
3. Thêm URL trang TikTok LIVE dùng cho kiểm tra thủ công. URL phải là HTTPS trên tiktok.com.
4. Nếu cần recording manager, bật policy, nhập đúng thư mục OBS và retention. Preflight kiểm tra OBS đang rảnh để ghi, đúng thư mục và đủ dung lượng.
5. Lưu profile rồi kiểm tra revision, scene và máy tương thích trước khi tạo phiên.

5. Chuẩn bị và chạy một phiên

1. Mở Phiên live, chọn worker, profile và nhãn tài khoản không chứa thông tin bí mật.
2. Bấm Preflight. Xử lý mọi mục blocker: worker/OBS, scene, app dự kiến, scene an toàn, cấu hình đích OBS, và recording nếu bật. Cảnh báo TikTok là phần cần người trực kiểm tra.
3. Xem preview và xác nhận nội dung đúng trước khi phát. Nếu preview hoặc audio chưa rõ, dừng tại đây để sửa máy/scene.
4. Chỉ khi đích phát và tài khoản được phép dùng đã được xác nhận, bấm Bắt đầu và xác nhận hộp thoại. Manager gửi lệnh recording (nếu bật) rồi OBS output.
5. Sau đó bấm Mở TikTok để mở trang LIVE trong Chrome/trình duyệt và tự kiểm tra phía người xem. Nếu chưa xác nhận được, giữ TikTok ở trạng thái chưa kiểm tra; OBS active không thay thế xác nhận này.

Một buổi thử an toàn cần đích nhận luồng riêng tư, không công khai, và tài khoản/quyền được phê duyệt. Nếu chưa có các điều kiện đó, dùng preflight, preview OBS và kiểm thử Chrome cục bộ; không phát ra TikTok thật.

6. Theo dõi, xử lý và kết thúc

• Theo dõi worker/OBS/output, preview, scene, FPS/drop, audio, dung lượng và cảnh báo ở dashboard.
• Trang Cảnh báo & nhật ký cho operator/admin nhận cảnh báo, giao người xử lý, thêm ghi chú, tạm ẩn/hiện lại và đóng từng incident. Viewer chỉ xem.
• Nếu cần che nội dung, dùng scene an toàn đã cấu hình cho phiên. Với sự cố encoder, dùng thao tác dừng phiên sau khi xác nhận.
• Kết thúc bằng nút dừng của phiên. Manager lưu trạng thái OBS, timeline, lệnh, xác nhận TikTok và phần ghi chú cuối phiên. Recording đã hết hạn vẫn cần dọn thủ công theo chính sách lưu trữ.
• Admin nên tạo và tải backup định kỳ; dùng “Diễn tập khôi phục” để kiểm tra bản sao mà không thay cơ sở dữ liệu đang chạy.

7. Khi một bước chưa sẵn sàng

• Worker offline: kiểm tra tiến trình/task, URL WSS, firewall outbound, token đúng worker và thời điểm heartbeat.
• OBS chưa kết nối: kiểm tra OBS WebSocket đang bật, cổng cục bộ, mật khẩu, và worker chạy dưới đúng tài khoản Windows.
• Scene/app blocker: kiểm tra tên scene đúng tuyệt đối và tiến trình game/giả lập/avatar đang chạy trong cùng user session.
• Đích phát blocker: kiểm tra OBS service, server và stream key cục bộ. Không gửi key cho operator hoặc nhập vào manager.
• LiveKit preview chưa sẵn sàng: manager cần LiveKit URL/credential và kết nối WebRTC khả dụng cho browser cùng worker; ảnh preview định kỳ vẫn là chỉ báo OBS riêng.
• TikTok chưa xác nhận: mở URL bằng browser và kiểm tra thủ công. Hệ thống không tự đăng nhập, lấy URL playback riêng tư hoặc suy ra TikTok từ OBS.

Giới hạn xác minh hiện tại

Manager/worker đã được kiểm tra cục bộ, kể cả OBS 33.0.1 sang viewer LiveKit loopback ở chế độ chỉ đọc. Triển khai hosted tại admin.livekit.vn, worker trên máy production và một phiên TikTok thật chưa được xác minh. Checklist chi tiết nằm trong docs/IMPLEMENTATION_CHECKLIST.md của project.