Các hướng dẫn này ánh xạ khái niệm của ngành lên đối tượng nền tảng đang có (bouquet, line, gói, tài khoản đối tác, node, API). Đây là ánh xạ khái niệm, không phải tính năng riêng của ngành, và tài khoản đối tác là tài khoản uỷ quyền, không phải tenant tách biệt.
Ánh xạ khái niệm
Không có gì trong panel được gọi là đội hình hay thành viên. Bảng cho biết đối tượng nào đóng vai trò nào; các chương bên dưới thiết lập chúng theo thứ tự đó.
| Trong ngành của bạn | Trên nền tảng | Ở đâu trong panel |
|---|---|---|
| Luồng trận đấu hoặc buổi tập | Kênh trực tiếp: một luồng với nguồn, EPG và định dạng đầu ra | Streams → thêm live stream (URL nguồn hoặc RTMP push) |
| Thư viện phân tích và xem lại | Danh mục VOD: phim và series có mùa và tập, danh mục và metadata | Movies và Series, hoặc job ingest VOD |
| Gói theo đội hình hoặc giải đấu | Bouquet: một tập kênh, phim hay series có tên mà một gói cấp quyền | Bouquets, từ Streams và Movies / Series |
| Quyền truy cập của thành viên hoặc gia đình | Line: một quyền truy cập với gói, bouquet, hạn, giới hạn kết nối và đầu ra | Lines → thêm, hoặc mã kích hoạt, hoặc Reseller API |
| Mùa giải hoặc thời hạn thành viên | Ngày hết hạn của line, gia hạn bằng gói, credit hay API | Ngày hết hạn của line và thời lượng của gói |
| Tài khoản nhân viên đội hoặc học viện | Tài khoản đối tác (reseller): dashboard uỷ quyền có credit, quyền hạn và line riêng | Users → thêm reseller; Groups cho quyền hạn |
| Tích hợp cửa hàng hoặc quản lý câu lạc bộ | Reseller API và webhook: các thao tác của panel từ hệ thống của bạn | Reseller API key và webhook trong dashboard của reseller |
Điều kiện tiên quyết
Những thứ cần có trước khi cài đặt.
- Một máy chủ (Ubuntu 22.04 hoặc 24.04) có địa chỉ công khai hoặc tên miền, và đủ băng thông upstream cho các trận đấu bạn định phát.
- Camera và bộ mã hoá ở sân có thể đẩy RTMP, cùng các tệp huấn luyện và phân tích đã ghi mà huấn luyện viên của bạn đang giữ.
- Quyết định ai xem được gì: các đội hình nào chia sẻ tài liệu, trận đấu nào chỉ dành cho thành viên, và ai trong ban nhân viên được cấp tài khoản panel.
Triển khai hạ tầng
Học viện trước, thêm node khi ngày thi đấu cần.
- Chạy bộ cài trên máy chủ của học viện và đặt panel sau reverse proxy có TLS; đặt trusted proxies để log và quy tắc IP thấy địa chỉ thật của người xem.
- Đặt URL gốc phát thành địa chỉ công khai mà người xem truy cập, để các liên kết panel cấp dùng được từ nhà.
- Nếu nhiều gia đình cùng xem một trận, đăng ký một node từ Servers; panel cài nó qua SSH và phân phối kênh trực tiếp từ node đó.
- Tạo tài khoản đối tác (reseller) cho ban huấn luyện với quyền về danh mục và không có quyền về line của thành viên.
Tổ chức nội dung
Đội hình và mùa giải là danh mục, quyền truy cập là bouquet.
- Tạo danh mục theo nhóm tuổi và theo mùa giải, và series cho các giải đấu với mỗi trận một tập.
- Tạo một bouquet cho tài liệu phân tích của mỗi đội hình, một cho các kênh trận đấu trực tiếp và một cho toàn học viện.
- Tạo một gói cho mỗi loại thành viên: các bouquet nó cấp, với mùa giải làm thời hạn và giá bằng credit nếu nhân viên bán.
- Đặt tên bouquet theo đội hình hoặc giải đấu mà nó thuộc về, để nhân viên biết cấp gói nào cho một gia đình.
Cấu hình đối tác (reseller)
Nhân viên quản lý thành viên của riêng họ, nếu câu lạc bộ muốn vậy.
- Tạo một nhóm có quyền về danh mục cho huấn luyện viên và một nhóm có quyền về line cho thư ký thành viên.
- Thêm từng người dưới dạng reseller với nhóm tương ứng; chỉ cấp credit cho thư ký nếu gói thành viên được bán qua panel.
- Một học viện vệ tinh hoặc hội cổ động có thành viên riêng nhận tài khoản đối tác và gói riêng.
Cấu hình quyền truy cập của thành viên và gia đình
Một line cho mỗi thành viên hoặc mỗi gia đình.
- Tạo khoá Reseller API cho cửa hàng hoặc hệ thống quản lý câu lạc bộ và giữ trong phần bí mật của hệ thống đó.
- Khi đăng ký, hệ thống gọi action=create_line với gói của loại thành viên và một request id; mùa giải là thời hạn của gói.
- Đặt số kết nối tối đa bằng số thiết bị một gia đình cần (thường là ba hoặc bốn) để một gói thành viên không bị chia sẻ ra ngoài hộ gia đình.
- Cho ngày thi đấu thử, thêm một line từ Lines → add với gói dùng thử, hoặc in mã kích hoạt cho cổ động viên trên khán đài.
Thư viện phân tích và xem lại
Trận đấu và buổi tập theo yêu cầu.
- Tải từng trận hoặc buổi tập lên làm nguồn của một tập, hoặc nạp bằng tác vụ VOD ingest; giữ ngày, đối thủ và đội hình trong tiêu đề.
- Gắn bản ghi vào bouquet của đội hình thông qua series của nó, để chỉ các line của đội hình đó thấy.
- Kiểm tra phát bằng một line thử của từng loại thành viên để xác nhận ai thấy gì.
Luồng trận đấu và buổi tập
Camera sân là một kênh trực tiếp.
- Thêm một luồng trực tiếp cho mỗi bộ mã hoá ở sân (RTMP push) và đặt nó vào bouquet ngày thi đấu.
- Bật catch-up để gia đình vào muộn có thể tua lại, và thêm bản ghi vào thư viện sau tiếng còi mãn cuộc.
- Vào ngày thi đấu đông người, kiểm tra node lấy kênh một lần từ origin và phục vụ người xem được định tuyến tới nó.
Hết hạn thành viên
Quyền truy cập đi theo mùa giải.
- Một line hết hạn vào cuối thời hạn của gói; cửa hàng gia hạn nó bằng action=renew_line khi phí mùa giải tiếp theo được thanh toán.
- Đăng ký cửa hàng vào các webhook để gửi nhắc nhở khi có line.expiring và đóng gói thành viên khi có line.expired.
- Cầu thủ rời đi giữa mùa bị cửa hàng vô hiệu hoá bằng action=disable_line; line được giữ lại để lưu hồ sơ.
Tích hợp với cửa hàng hoặc phần mềm câu lạc bộ
Hệ thống điều khiển quyền truy cập; player chỉ phát.
- Cài connector của nền tảng thương mại (WooCommerce, Shopify và các nền tảng khác) ở phía cửa hàng để một lần mua tạo line và một khoản thanh toán gia hạn nó.
- Hệ thống quản lý câu lạc bộ hoặc bán vé được kết nối qua Reseller API và webhook; không có connector gốc cho nó.
- Không có đăng nhập một lần cho người xem: thành viên đăng nhập vào player bằng thông tin của line, do cửa hàng gửi cho họ.
Lưu ý về bảo mật
Tài liệu của đội hình ở lại với đội hình.
- Phục vụ panel và URL gốc phát qua TLS và đặt TRUSTED_PROXIES thành reverse proxy của bạn.
- Đăng nhập hai lớp cho mọi tài khoản panel, và nhóm quyền để thư ký không thể thay đổi danh mục và huấn luyện viên không thể thấy các line.
- Liên kết phát được ký và có hạn, giới hạn kết nối trên mỗi line, và gắn IP hoặc quốc gia cho line của nhân viên.
- Sao lưu cơ sở dữ liệu mã hoá kèm bản sao ngoài site, và nhật ký kiểm toán cho mọi thay đổi của line và danh mục.
Xử lý sự cố
Những kiểm tra đầu tiên thường gặp.
- Một phụ huynh thấy phân tích của đội một: kiểm tra gói của line và các bouquet nó cấp.
- Thành viên mới chưa có quyền truy cập sau khi trả tiền: kiểm tra log lệnh gọi Reseller API của yêu cầu từ cửa hàng và ngày hết hạn của line.
- Luồng trận đấu bị giật lúc giao bóng: kiểm tra băng thông tải lên của bộ mã hoá ở sân, và heartbeat của node nếu có node phục vụ người xem.
- Nhật ký kiểm toán hiện địa chỉ của proxy: đặt TRUSTED_PROXIES thành proxy và khởi động lại panel.