Trên trang này
TL;DR — Các tập phim Wandura có giấy phép được mã hoá và chỉ phát được qua BytePlus VOD Player SDK (bản standard), chạy native trên iOS và Android. Wandura đăng ký app ID của bạn và cấp giấy phép (một tệp
.liccùng một App ID, gắn với bundle ID và package name chính thức của bạn); tổ chức của bạn trả tiền, khoảng US$2,860 mỗi app mỗi năm. Hãy test trên thiết bị thật. Hướng dẫn cài đặt từng bước nằm ở partner.wandura.ai → Developers → Player SDK, có sau khi onboarding.
Tóm tắt
| iOS | Android | |
|---|---|---|
| SDK | BytePlus VOD Player SDK, bản standard | BytePlus VOD Player SDK, bản standard |
| Gói Wandura dùng để test | CocoaPods TTSDKFramework 1.52.100.4-standard (subspec Player) |
Gradle com.bytedanceapi:ttsdk-player_standard:1.52.100.5 |
| Tối thiểu | iOS 11.0, Xcode 14, tắt Bitcode | Android API level 16, Java 8, armeabi-v7a hoặc arm64-v8a |
| Ngôn ngữ | Objective-C hoặc Swift (bridging header) | Java hoặc Kotlin |
| Wandura đã kiểm chứng | Phát nội dung mã hoá trên iPhone thật | Làm theo hướng dẫn của nhà cung cấp; hãy chia sẻ kết quả test đầu tiên trong kênh của bạn |
- App native. Wandura hỗ trợ tích hợp native trên iOS và Android. Nếu dùng framework đa nền tảng (React Native, Flutter…), bạn tự bọc SDK native trong một module của mình: hãy hỏi trong kênh của bạn trước khi lên kế hoạch.
- Web. Phát nội dung mã hoá trên web không nằm trong giấy phép này. Hãy hỏi Wandura trước khi định làm web player.
- Player thông thường không chạy được. Một player HLS như AVPlayer hay ExoPlayer dùng riêng sẽ tải playlist rồi đứng hình.
- Phiên bản SDK mới hơn. Các bản cập nhật patch của cùng phiên bản minor thì dùng được. Hãy báo Wandura trước khi chuyển sang phiên bản minor mới. Release notes của nhà cung cấp: iOS, Android.
Giấy phép
| Giấy phép | 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 US$2,860 mỗi app mỗi năm | Đủ cho 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 US$32,790 mỗi app mỗi năm | Không cần cho phim Wandura. |
| Dùng thử | Một app, để test | miễn phí, khoảng 30 ngày | Không gia hạn được: hãy bắt đầu khi QA của bạn bắt đầu. Chuyển sang giấy phép trả phí không cần phát hành lại app. |
Bạn nhận được: một tệp giấy phép (.lic) và App ID gắn với nó. Cả hai đều đưa vào app. Đừng để tệp giấy phép trong repository công khai.
Wandura cần từ bạn: bundle ID iOS và package name Android chính thức. Giấy phép gắn chính xác với chúng:
- Không đổi được ID sau khi giấy phép đã được cấp.
- Bản build debug có ID khác (hậu tố
.debug, flavour khác) bị tính là một app khác và không qua được bước kiểm giấy phép. Hãy build các bản QA bằng ID release. - Mỗi app một giấy phép: hai app cần hai giấy phép, kể cả cùng một công ty.
Thiết bị và quyền riêng tư
- Thiết bị thật. Test phát nội dung mã hoá trên iPhone thật và điện thoại Android thật. Simulator và emulator không được hỗ trợ cho việc này.
- Giá trị thiết bị. Sau khi SDK đã khởi động và qua bước kiểm giấy phép, SDK cung cấp một device ID và một device public key. App của bạn gửi chúng về backend cho mỗi request xin vé (
union_info,drm_kek). Device ID là một định danh lâu dài: hãy coi nó là dữ liệu cá nhân. Xem Bảo mật. - Khai báo quyền riêng tư. SDK có kèm thành phần analytics riêng của nhà cung cấp. Hãy khai báo nó trong phần quyền riêng tư trên App Store (privacy manifest) và biểu mẫu Data safety trên Google Play, theo tài liệu của nhà cung cấp.
Khối lượng công việc
Ước lượng cho một team đã có app video native đang chạy; thực tế của bạn có thể khác.
| Việc | Ước lượng |
|---|---|
| Cài SDK, kiểm giấy phép, giá trị thiết bị (mỗi nền tảng) | 1–2 ngày |
| Phát từ vé, hết hạn vé và phục hồi, phụ đề (mỗi nền tảng) | 2–3 ngày |
| Endpoint xin vé ở backend và paywall của bạn | 2–4 ngày |
| Kế hoạch test trên thiết bị thật | 2–3 ngày |
Các vấn đề thường gặp
| Triệu chứng | Nguyên nhân có thể | Cách sửa |
|---|---|---|
| Player tải mà không bao giờ bắt đầu phát | Dùng player thông thường thay vì SDK, hoặc bỏ sót một bước cài đặt | Phát qua SDK; làm đủ mọi bước của hướng dẫn trên portal. |
| Kiểm giấy phép thất bại | Bundle ID hoặc package name khác với giấy phép (hậu tố debug, flavour), hoặc app thiếu tệp .lic |
Build bằng ID release; kiểm tra tệp đã được đóng gói vào app. |
Giá trị thiết bị là (null), nil hoặc rỗng |
Đọc trước khi SDK khởi động hoặc trước khi qua bước kiểm giấy phép | Đọc sau khi kết quả kiểm giấy phép là OK. API từ chối các giá trị như vậy bằng 400 invalid_device_info. |
| Đang phát thì dừng sau một lúc | Vé đã hết hạn (30 phút) | Xin một vé mới và phát tiếp tại đúng vị trí. |
| Chạy được trên iOS, không chạy trên Android | Khác biệt về khu vực hoặc cài đặt trong SDK Android của nhà cung cấp | Hỏi trong kênh của bạn, kèm phiên bản SDK và thông báo lỗi. |
Hướng dẫn cài đặt
Hướng dẫn từng bước (cài đặt, giấy phép, giá trị thiết bị, playback, phụ đề, mã lỗi) nằm ở partner.wandura.ai → Developers → Player SDK, dành cho thành viên có vai trò Developer hoặc Admin, sau khi onboarding. Các trang theo nền tảng bên dưới trình bày luồng phía app xung quanh hướng dẫn đó, kèm code: iOS · Android.
Cập nhật 05/10/2026 · Lịch sử thay đổi (1)