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
Trong panel không có gì gọi là phòng hay lượt lưu trú. Bảng cho biết đối tượng nào đóng vai trò nào; các chương 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 |
|---|---|---|
| Nhà vận hành khách sạn hoặc đối tác được uỷ quyề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 |
| Gói kênh | 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 |
| Phòng hoặc thiết bị | 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 |
| Video thông tin khách sạn | 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 |
| Kênh truyền hình bản quyền | 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ời gian lưu trú | 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 |
| Một node mỗi toà nhà hay dãy | 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
Cần có gì trước khi cài.
- Một máy chủ trong mạng của cơ sở (Ubuntu 22.04 hoặc 24.04), bộ cài, và một địa chỉ mà thiết bị trong phòng truy cập được.
- Feed kênh cơ sở có bản quyền (URL pull hoặc RTMP), video thông tin của khách sạn, và thiết bị trong phòng (hộp Android TV, hộp MAG hoặc Enigma2, smart TV có ứng dụng player hoặc trình duyệt).
- Khả năng PMS gọi HTTP API khi nhận và trả phòng, hoặc quy trình để lễ tân làm trong panel.
Triển khai hạ tầng
Máy chủ trung tâm và một node mỗi toà nhà.
- Chạy bộ cài trên máy chủ trung tâm; đặt địa chỉ phát là địa chỉ nội bộ của cơ sở để phòng ở trong mạng nội bộ.
- Thêm feed kênh trong Streams và video thông tin trong Movies; kiểm tra trong web player.
- Enroll một node mỗi dãy hoặc toà nhà từ Servers; panel cài qua SSH và điều hướng phòng của toà đó tới node.
- Đặt key bản quyền trên máy chủ; kích hoạt tại chỗ và dịch vụ chạy không cần đường truyền ra ngoài.
Tổ chức nội dung
Gói kênh và video khách sạn.
- Tạo một bouquet mỗi gói kênh (phòng tiêu chuẩn, suite, hội nghị) từ kênh của cơ sở.
- Tạo một bouquet video khách sạn (chào mừng, tiện ích, an toàn) và thêm vào mọi gói.
- Tạo một gói mỗi hạng phòng với bouquet nó cấp và thời lượng một ngày: khi nhận phòng, line của phòng được gia hạn mỗi đêm lưu trú một lần (mỗi lần gia hạn cộng thêm thời lượng của gói), khi trả phòng thì tắt (chương 8).
- Sắp xếp kênh và gán logo để menu trên TV dễ đọc.
Cấu hình đối tác (reseller)
Cơ sở, hoặc nhà vận hành nhiều cơ sở, như tài khoản uỷ quyền.
- Tạo một nhóm với quyền giới hạn ở line (phòng) và không đổi danh mục.
- Thêm lễ tân của cơ sở, hoặc nhà vận hành, là reseller với nhóm đó và các gói phòng.
- Nhà vận hành nhiều cơ sở có một reseller mỗi cơ sở, mỗi reseller có phòng và credit riêng.
Cấu hình phòng (line)
Một line mỗi phòng, đặt tên theo số phòng.
- Tạo một line mỗi phòng trong Lines với số phòng là tên và gói của hạng phòng.
- Đặt max connections là 1 (một TV) hoặc bằng số màn hình trong phòng.
- Gắn line với địa chỉ thiết bị của phòng khi mạng cấp địa chỉ cố định cho thiết bị.
- Cấu hình thiết bị (Xtream Codes API hoặc M3U với thông tin line, hoặc cổng MAG / Enigma2) một lần; thông tin ở lại với phòng.
Video thông tin khách sạn
Video riêng của cơ sở theo yêu cầu.
- Tải lên video chào mừng và thông tin như phim, với các phiên bản ngôn ngữ của cơ sở là mục riêng hoặc track âm thanh.
- Đưa vào bouquet video khách sạn để mọi hạng phòng nhận được.
- Cập nhật từ panel mỗi khi thông tin thay đổi; phòng thấy bản mới ngay.
Kênh truyền hình bản quyền
Kênh của cơ sở như live stream.
- Thêm mỗi kênh bản quyền trong Streams với feed của nó; chỉ bật timeshift hoặc xem lại nơi giấy phép cho phép.
- Thêm nguồn EPG để lịch trên TV hiện chương trình.
- Giữ kênh giới hạn lãnh thổ trong bouquet chỉ gói phù hợp mới cấp.
Nhận phòng, trả phòng và hết hạn
Lượt lưu trú là hiệu lực của line.
- Khi nhận phòng bật line của phòng và gia hạn theo độ dài lưu trú (PMS qua API, hoặc lễ tân trong panel).
- Khi trả phòng tắt line; lượt lưu trú mới bật lại, nên thông tin không bao giờ rời phòng.
- Đăng ký webhook cho PMS hoặc lễ tân để thấy line bật, tắt và hết hạn.
Tích hợp với PMS
Nhận và trả phòng điều khiển phòng.
- Tạo Reseller API key cho PMS và giữ trong cấu hình của PMS.
- Khi nhận phòng PMS gọi action=enable_line và action=renew_line cho line của phòng với request id; khi trả phòng action=disable_line.
- Ứng dụng dịch vụ cho khách (gọi nhân viên, dọn phòng, trả phòng nhanh, gọi món) và kết nối hậu cần thuộc gói Enterprise và được chốt cùng cơ sở.
Lưu ý về bảo mật
Giữ kênh trong cơ sở.
- Giữ địa chỉ phát và node trong mạng của cơ sở; không mở ra internet thứ gì phòng không cần.
- Một kết nối mỗi phòng, gắn với thiết bị; link ký hết hạn nên link sao chép ngừng hoạt động.
- Đăng nhập hai lớp cho panel; lễ tân có nhóm quyền hạn hẹp.
- Bật sao lưu cơ sở dữ liệu mã hoá; thông tin phòng nằm trong đó.
Xử lý sự cố
Những kiểm tra đầu tiên thường gặp.
- Phòng không có TV: kiểm tra line đang bật và chưa hết hạn, rồi thông tin và địa chỉ của thiết bị.
- Thiếu kênh trong phòng: kiểm tra bouquet của gói hạng phòng.
- TV dừng khi mất internet: kiểm tra địa chỉ phát và nguồn là địa chỉ nội bộ; feed bên ngoài phụ thuộc đường truyền.
- PMS gọi thất bại: kiểm tra API key, ghi là POST, và request id khi gọi lại.