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à phòng trưng bày 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 |
|---|---|---|
| Phim triển lãm và tư liệu lưu trữ | 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 |
| Phát sóng khai mạc hoặc buổi diễn thuyết | 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) |
| Bộ sưu tập phòng trưng bày hoặc thành viên | 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 khách hoặc thành viên | 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 |
| Thời hạn hội 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 |
| Thiết bị trên mỗi thành viên | 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 |
Đ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ủ trong toà nhà (Ubuntu 22.04 hoặc 24.04), bộ cài, và mạng phòng trưng bày mà các màn hình và thiết bị của thành viên sẽ dùng.
- Phim triển lãm, các bản ghi tư liệu mà bạn có quyền, một bộ mã hoá cho giảng đường, và các màn hình hoặc đầu phát media cho phòng trưng bày.
- Khoá license và, nếu toà nhà không có internet, quy trình kích hoạt offline; cùng quyết định ai ở quầy sẽ bán gói thành viên.
Triển khai hạ tầng
Máy chủ trong toà nhà, kích hoạt tại chỗ.
- Chạy bộ cài trên máy chủ và đặt URL gốc phát thành địa chỉ mà mạng phòng trưng bày truy cập được.
- Kích hoạt khoá license offline từ panel; sau khi kích hoạt, dịch vụ chạy trên mạng nội bộ mà không cần internet.
- Thêm phim triển lãm trong Movies và luồng của giảng đường trong Streams, rồi kiểm tra trong web player.
- Với địa điểm thứ hai hoặc chương trình công cộng lớn, đăng ký một node từ Servers; panel cài nó qua SSH và định tuyến người xem của địa điểm đó tới node.
Tổ chức nội dung
Phòng trưng bày, kho tư liệu và bộ sưu tập thành viên.
- Tạo danh mục theo triển lãm và theo năm, và một series cho một chuỗi bài giảng với mỗi buổi nói chuyện một tập.
- Tạo một bouquet cho các màn hình phòng trưng bày và một cho thư viện thành viên gồm các buổi nói chuyện và phim tư liệu.
- Tạo một gói cho các phòng trưng bày và một gói cho mỗi loại thành viên, mỗi gói cấp các bouquet của nó; thời hạn của gói thành viên là thời hạn thành viên.
- Thêm poster và mô tả ngắn cho mọi phim để thư viện dễ đọc trong player.
Cấu hình đối tác (reseller)
Quầy và cửa hàng là các tài khoản được uỷ quyền.
- Tạo một nhóm với quyền giới hạn ở line và mã kích hoạt, không truy cập danh mục hay máy chủ.
- Thêm quầy, hoặc cửa hàng, dưới dạng reseller với nhóm đó, các gói thành viên và số dư credit.
- Một trung tâm văn hoá vận hành nhiều địa điểm có thể thêm một reseller cho mỗi địa điểm, mỗi nơi bán gói thành viên từ số dư riêng.
Cấu hình quyền truy cập của khách và thành viên
Màn hình và thành viên dùng line.
- Tạo một line cho mỗi màn hình phòng trưng bày trong Lines → add với gói phòng trưng bày, và gắn nó với địa chỉ của màn hình khi mạng cấp địa chỉ cố định.
- Tạo mã kích hoạt tại quầy cho mỗi gói thành viên bán ra; thành viên nhập mã vào player và line bắt đầu.
- Đặt số kết nối tối đa cho mỗi gói thành viên bằng số thiết bị một thành viên được dùng, thường là hai.
- Đưa cho thành viên ứng dụng player, danh sách phát M3U hoặc địa chỉ web player, tuỳ thiết bị của họ.
Phim triển lãm và tư liệu lưu trữ
Thư viện theo yêu cầu.
- Tải phim triển lãm và kho tư liệu đã số hoá lên dưới dạng phim, hoặc nạp vào thư mục media gốc bằng tác vụ VOD ingest.
- Thêm siêu dữ liệu TMDB khi có, và tự viết tiêu đề và mô tả cho phần còn lại.
- Giữ tư liệu không dành cho công chúng chỉ trong bouquet thành viên, và kiểm tra mỗi gói thấy gì bằng một line thử.
Lễ khai mạc và buổi diễn thuyết
Một sự kiện là một kênh trực tiếp.
- Thêm một luồng trực tiếp cho bộ mã hoá của giảng đường (RTMP push) và đặt nó vào bouquet thành viên, hoặc vào bouquet phòng trưng bày cho lễ khai mạc chiếu trên màn hình.
- Bật catch-up để thành viên đến muộn có thể tua lại, và tải bản ghi lên thư viện sau đó.
- Kiểm tra bộ mã hoá và luồng trước sự kiện bằng một line thử, trên cùng mạng mà khán giả sẽ dùng.
Hết hạn và gia hạn thành viên
Thời hạn thành viên là hiệu lực của line.
- Một line hết hạn vào cuối thời hạn của gói; gia hạn tại quầy cộng thêm một kỳ.
- Vô hiệu hoá line khi gói thành viên bị huỷ; các mã kích hoạt chưa từng dùng vẫn giữ nguyên cho đến khi được đổi.
- Đăng ký cửa hàng hoặc hệ thống thành viên vào các webhook để thấy các line sắp hết hạn hoặc đã hết hạn.
Tích hợp với cửa hàng hoặc hệ thống thành viên
Hệ thống bán quyền truy cập; player phát.
- Tạo khoá Reseller API cho cửa hàng hoặc hệ thống thành viên; nó gọi create_line, renew_line và disable_line, với request id ở mỗi lệnh ghi.
- Dùng connector thương mại khi bán gói thành viên trực tuyến; hệ thống khác dùng Reseller API và webhook.
- 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 hoặc mã kích hoạt.
Lưu ý về bảo mật
Giữ các bộ sưu tập đúng nơi của chúng.
- Tách mạng phòng trưng bày khỏi mạng của khách, và phục vụ mọi truy cập công khai sau reverse proxy có TLS và đã đặt TRUSTED_PROXIES.
- Đăng nhập hai lớp cho mọi tài khoản panel; quầy nhận một nhóm quyền giới hạn ở line và mã.
- Liên kết phát được ký và có hạn, giới hạn kết nối theo gói thành viên, và gắn địa chỉ cho các màn hình phòng trưng bày.
- Bật sao lưu cơ sở dữ liệu mã hoá kèm bản sao ngoài site, và dùng nhật ký kiểm toán để xem lại các 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 màn hình phòng trưng bày bị đen: kiểm tra line của nó đang bật và chưa hết hạn, việc gắn địa chỉ của màn hình, và máy chủ truy cập được trên mạng phòng trưng bày.
- Mã của một thành viên không dùng được: kiểm tra mã chưa được đổi và gói mà nó mở vẫn được gán cho quầy.
- Kích hoạt license offline thất bại: kiểm tra tệp kích hoạt so với khoá license và đồng hồ của máy chủ.
- Lễ khai mạc trực tiếp bị giật: kiểm tra bitrate của bộ mã hoá so với uplink và trạng thái của luồng trong Streams.