Bắt đầu
Trên trang này
TL;DR — Để phát phim Wandura, team bạn cần sẵn sàng 3 thứ trước khi code: một org trên partner.wandura.ai có giấy phép cho các phim của bạn, license Player SDK cho từng app, do tổ chức của bạn trả tiền (giá niêm yết khoảng 2.860 USD mỗi app mỗi năm cho iOS + Android), và app ID chính thức. Sau đó bạn xây 2 phần: backend đồng bộ catalog và xin vé playback, và app phát tập phim qua Player SDK. Toàn bộ các bước nằm trong hướng dẫn tích hợp.
Note: Chỉ chiếu video không cần giữ bản quyền (ví dụ clip fitness)? Đường video mở (sắp có) không cần license Player SDK.
1. Chuẩn bị (chưa cần code)
| Xong? | Hạng mục | Vì sao cần | Chi tiết |
|---|---|---|---|
| ☐ | Org trên partner.wandura.ai + email của Admin | Mọi key và giấy phép đều thuộc về org | Hướng dẫn tích hợp · Giai đoạn 0 |
| ☐ | Email các developer backend | Họ được vai Developer để quản lý key | Vai trò |
| ☐ | Danh sách phim và ngày giấy phép trong thoả thuận | Catalog chỉ hiện phim mà giấy phép của bạn cho phép | Catalog |
| ☐ | Bundle ID iOS và package name Android chính thức | License Player SDK gắn với chúng và không chuyển sang ID khác được | License Player SDK |
| ☐ | Các môi trường (ví dụ staging và production) | Mỗi môi trường cần một key playback riêng, do developer của bạn tự tạo | Xác thực |
| ☐ | Ngân sách license Player SDK: tổ chức của bạn trả tiền | Thống nhất gói và ngày bắt đầu với Wandura | License Player SDK |
| ☐ | Vào được kênh Discord Wandura của team bạn | Onboarding, giấy phép và go-live đều diễn ra ở đó | Onboarding |
2. Onboarding
Mỗi team đối tác làm việc với Wandura trong kênh Discord riêng của mình: kênh Discord Wandura của team bạn. Onboarding gồm sáu bước dưới đây, theo đúng thứ tự. Mỗi bước bắt đầu khi Wandura đã nhận đủ thứ cần từ bạn.
| Bước | Chuyện gì xảy ra | Bạn gửi gì |
|---|---|---|
| 1. Hỏi | Bạn nhắn trong kênh Discord Wandura của team bạn rằng bạn sẵn sàng tích hợp. | Tên tổ chức và email của người sẽ làm Admin. |
| 2. Tổ chức và thành viên | Wandura tạo tổ chức của bạn trên partner.wandura.ai và mời Admin cùng các developer. Developer nhận vai Developer. | Email các developer backend. |
| 3. Tổ chức test và giấy phép phim | Wandura quyết định bạn test trong một tổ chức test riêng hay không, và cấp giấy phép các phim dùng để test cho tổ chức bạn test. | Các phim bạn muốn dùng để test, lấy từ thoả thuận. |
| 4. Dùng thử Player SDK | Wandura đăng ký app ID của bạn và cấp license Player SDK dùng thử. Bạn được vào hướng dẫn Player SDK: có sau khi onboarding, trên cổng, ở partner.wandura.ai → Developers → Player SDK (phải đăng nhập, vai Developer hoặc Admin). | Bundle ID iOS và package name Android chính thức. |
| 5. Key staging | Developer của bạn tự tạo các key staging trên trang Developers, kể cả playback key (Stream films in an app). Nếu playback key bị lộ, bất kỳ ai cũng stream được phim bạn được cấp phép, nên hãy thu hồi ngay. | Không cần gì: không phải xin Wandura. |
| 6. Key production và license trả phí | Khi go-live, developer của bạn tự tạo playback key production theo cùng cách, và license Player SDK trả phí thay bản dùng thử. | Kết quả kế hoạch test và ngày go-live dự kiến. |
3. License Player SDK và giá
Các tập phim được mã hoá, nên app của bạn phải phát bằng Player SDK. Player HLS thông thường không giải mã được. Wandura đăng ký app ID của bạn và cấp license Player SDK; tổ chức của bạn trả tiền license đó.
| License | Dùng cho | Giá niêm yết | Ghi chú |
|---|---|---|---|
| Standard — mobile | iOS và Android của một app (một bundle ID + một package name) | khoảng 2.860 USD mỗi app mỗi năm | Đủ để phát phim mã hoá của Wandura. |
| Premium — mobile | Như trên, thêm tính năng của nhà cung cấp | khoảng 32.790 USD mỗi app mỗi năm | Không cần cho phim Wandura. |
| Web player | Web | không mất phí license theo giá niêm yết | Hỏi Wandura trước khi định làm app web. |
| Dùng thử | Một app, để test | miễn phí, khoảng 30 ngày | Nâng từ dùng thử lên bản trả phí không cần phát hành lại app. |
- Mỗi app một license. Hai app khác nhau cần hai license, kể cả cùng một công ty.
- ID là chốt. Đổi bundle ID hoặc package name sau khi đã cấp license là không hỗ trợ: app mất quyền dùng SDK.
- Giá có thể đổi. Số trên là giá niêm yết. Thoả thuận với Wandura quyết định giá thật.
4. Backend của bạn cần xây gì
| Xây | Làm gì | Chi tiết |
|---|---|---|
| ☐ Nơi giữ key | Giữ API key của Wandura chỉ trên server, không bao giờ trong app | Xác thực |
| ☐ Job đồng bộ catalog | Gọi catalog 15–60 phút một lần, lưu phim và tập vào database của bạn | Giai đoạn 2 |
| ☐ Bảng phim + tập | Bản sao của bạn: tên, poster, thứ tự, tập miễn phí, tình trạng | Lưu gì |
| ☐ Endpoint xin vé trong API của bạn | Kiểm người xem và paywall của bạn, rồi xin Wandura vé cho một tập | Giai đoạn 3 |
| ☐ Xin trước + thử lại | Xin vé cho 2 tập kế; thay vé đã hết hạn | Xin trước |
| ☐ Đổi lỗi thành thông báo + theo dõi | Biến lỗi API thành thông báo cho người xem; theo dõi tỉ lệ lỗi | Lỗi |
5. App của bạn cần xây gì
| Xây | Làm gì | Chi tiết |
|---|---|---|
| ☐ Gắn Player SDK (từng nền tảng) | Phát tập mã hoá; hướng dẫn Player SDK trên cổng ghi tên các lệnh gọi | Playback |
| ☐ Giá trị thiết bị | Lấy 2 giá trị từ SDK và gửi kèm mỗi lần xin vé | Giá trị thiết bị |
| ☐ Màn paywall | Tập miễn phí, mở khoá, gói thuê bao — theo luật của bạn | Paywall trước |
| ☐ Phụ đề | Nạp các file WebVTT có trong mỗi vé | Phụ đề |
| ☐ Thông báo cho người xem | Người xem thấy gì với từng lỗi | Thông báo |
6. Trước khi go-live
- ☐ Staging qua hết kế hoạch test.
- ☐ Đã có key production và license Player SDK trả phí.
- ☐ Đã làm xong checklist go-live cùng Wandura.
Cập nhật 01/10/2026 · Lịch sử thay đổi (5)