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à sân khấu hay vé. 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 |
|---|---|---|
| Kênh sân khấu | 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) |
| Loại vé | 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 |
| Vé hoặc thẻ tham dự | 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 |
| Kết thúc sự kiệ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 |
| Thiết bị trên mỗi vé | Số kết nối tối đa của line: bao nhiêu thiết bị xem cùng lúc | Max connections của line |
| Tích hợp bán vé hoặc đăng ký | 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 |
| Node tại địa điểm | Node phát video: máy chủ biên enroll từ panel, một node mỗi cơ sở hay toà nhà | Servers → thêm node, cài qua SSH |
Đ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à uplink đủ cho lượng khán giả đỉnh dự kiến, và với node tại địa điểm, một máy trong mạng của địa điểm.
- Một bộ mã hoá cho mỗi sân khấu có thể đẩy RTMP, cùng danh sách sân khấu, ngày và loại vé.
- Quyết định về cách vé đến panel: mã kích hoạt tạo hàng loạt, hoặc hệ thống bán vé gọi Reseller API.
Triển khai hạ tầng
Origin trước, sau đó là địa điểm.
- Chạy bộ cài trên máy chủ quản lý và đặt panel sau reverse proxy có TLS; đặt trusted proxies để 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 tham dự truy cập.
- Đăng ký một node từ Servers trên máy tại địa điểm; panel cài nó qua SSH, và các màn hình cục bộ được định tuyến tới nó.
- Tạo tài khoản đối tác (reseller) cho quầy bán vé với quyền về line và không có quyền về danh mục.
Tổ chức nội dung
Sân khấu là kênh, vé là gói.
- Thêm danh mục theo ngày hoặc theo chuyên đề để danh sách kênh đọc như chương trình sự kiện.
- Tạo một bouquet cho mỗi loại vé: các sân khấu mà loại vé đó được xem.
- Tạo một gói cho mỗi loại vé với độ dài của sự kiện làm thời hạn, và một gói dùng thử cho báo chí và diễn giả nếu cần.
- Tạo một bouquet cho luồng sân khấu hoặc phòng chờ của nhà tài trợ và chỉ cấp nó qua gói của nhà tài trợ.
Cấu hình đối tác (reseller)
Quầy bán vé, nếu nó cấp quyền truy cập.
- Tạo một nhóm có quyền về line và không có quyền về danh mục cho quầy bán vé.
- Thêm quầy bán vé dưới dạng reseller với nhóm đó và đủ credit cho số mã sẽ phát hành.
- Đơn vị đồng tổ chức hoặc đối tác khu vực bán vé riêng được cấp tài khoản đối tác và gói riêng.
Cấu hình quyền truy cập của người tham dự
Một line cho mỗi vé.
- Tạo mã kích hoạt hàng loạt, mỗi vé một mã, gắn với gói của loại vé tương ứng, rồi in hoặc gửi email kèm vé.
- Với bán vé trực tuyến, cài connector của nền tảng thương mại, hoặc để hệ thống bán vé gọi action=create_line với gói và một request id.
- Đặt số kết nối tối đa là một hoặc hai thiết bị cho mỗi vé để một mã không thể bị chia sẻ cho cả khán giả.
- Kiểm tra bằng một line dùng thử trước khi mở cửa, dùng cùng player mà người tham dự sẽ dùng.
Bản ghi các phiên
Bản ghi sau sự kiện.
- Ghi từng sân khấu và thêm các tệp vào thư viện dưới dạng tập của một series cho mỗi chuyên đề, hoặc nạp bằng tác vụ VOD ingest.
- Cấp các bản ghi qua một bouquet và một gói riêng, để người tham dự giữ quyền truy cập sau khi các line trực tiếp đã hết hạn.
- Kiểm tra phát các bản ghi bằng một line thử của gói đó trước khi thông báo.
Kênh sân khấu
Một sân khấu là một kênh trực tiếp.
- Thêm một luồng trực tiếp cho mỗi sân khấu với RTMP push của bộ mã hoá, và đặt nó vào các bouquet của những loại vé được xem.
- Bật catch-up để người tham dự bỏ lỡ phần đầu của một phiên có thể tua lại.
- Trước phiên đầu tiên, kiểm tra node tại địa điểm lấy mỗi sân khấu một lần từ origin và các màn hình được định tuyến tới nó.
Hết hạn
Quyền truy cập kết thúc cùng sự kiện.
- Cho mỗi gói vé một thời hạn kết thúc vào ngày cuối của sự kiện, để các line tự hết hạn mà không cần làm gì.
- Gia hạn một line, hoặc phát hành mã ngắn hạn, cho diễn giả hay nhà tài trợ đến muộn thay vì tạo gói mới.
- Vô hiệu hoá line của vé bị mất hoặc bị chia sẻ từ Lines; nhật ký kiểm toán lưu lại dấu vết.
Tích hợp với hệ thống bán vé
Hệ thống điều khiển quyền truy cập; player chỉ phát.
- Hệ thống bán vé hoặc đăng ký tạo line qua Reseller API và lắng nghe các webhook như line.created và line.expired.
- Bán vé trực tuyến trên nền tảng thương mại được hỗ trợ dùng connector của nó; không có connector gốc cho một sản phẩm bán vé cụ thể.
- Không có đăng nhập một lần cho người xem: người tham dự đăng nhập vào player bằng thông tin của line hoặc bằng mã kích hoạt.
Lưu ý về bảo mật
Một vé là một người.
- 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 để quầy bán vé không thể thay đổi các sân khấu.
- Liên kết phát được ký và có hạn cùng giới hạn kết nối thấp cho mỗi vé.
- 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à sân khấu.
Xử lý sự cố
Những kiểm tra đầu tiên thường gặp.
- Người tham dự không mở được một sân khấu: kiểm tra gói của line, bouquet chứa sân khấu và ngày hết hạn.
- Một sân khấu bị đứng trong phòng nhưng không đứng trực tuyến: kiểm tra heartbeat của node tại địa điểm và đường định tuyến của các màn hình tới nó.
- Một mã kích hoạt bị từ chối: kiểm tra mã chưa được dùng và gói của nó vẫn còn hiệu lực.
- 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.