Lịch sử thay đổi
Mọi lần sửa trang này, mới nhất ở trên. Mở từng mục để xem đã đổi gì.
- 01/10/2026 · +6 −6 dòng
Xem thay đổi
⋯ ## Khi nào xin vé - Xin một vé cho mỗi lần bắt đầu phát: khi người xem chạm vào một tập, hoặc khi app tải trước tập kế tiếp. Đừng xin vé hàng loạt rồi lưu lại, vì mỗi vé hết hạn trong vòng vài phút. + Xin một vé cho mỗi lần bắt đầu phát: khi người xem chạm vào một tập, hoặc khi app tải trước tập kế tiếp. Đừng xin vé hàng loạt rồi lưu lại, vì mỗi vé hết hạn 30 phút sau khi được cấp. Mỗi request chỉ dành cho đúng một tập. Không có endpoint batch. ⋯ | `drm_kek` | Device public key do Player SDK tạo ra. Private key tương ứng không bao giờ rời khỏi thiết bị. | - Bộ tài liệu onboarding Player SDK của bạn ghi rõ các lệnh gọi SDK cụ thể. Wandura cung cấp giấy phép SDK và đăng ký bundle ID hoặc package name của app bạn trong quá trình onboarding. + Hướng dẫn Player SDK ở partner.wandura.ai → **Developers** → **Player SDK** ghi rõ các lệnh gọi SDK cụ thể; hướng dẫn có sau khi [onboarding](../before-you-start.md#get-onboarded), cho thành viên vai **Developer** hoặc **Admin**. 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 đó. Quy tắc cho giá trị thiết bị: - Gửi cả hai hoặc không gửi cái nào. Chỉ gửi một giá trị sẽ trả `400` `invalid_request`. - - Gửi đúng output thật của SDK. Giá trị trông như rỗng, ví dụ chuỗi `"(null)"`, `"null"` hoặc `"undefined"`, hoặc ngắn hơn 8 ký tự, sẽ trả `400` `invalid_device_info`. Response liệt kê các trường sai trong `fields`. Thường điều này có nghĩa là một lệnh gọi SDK không trả về gì và code của bạn đã biến nó thành chuỗi. + - Gửi đúng output thật của SDK. Một giá trị bị từ chối bằng `400` `invalid_device_info` khi, sau khi bỏ khoảng trắng hai đầu, nó ngắn hơn 8 ký tự hoặc là một trong `(null)`, `null`, `nil`, `undefined`, `nan`, `<null>`, `none` (chữ hoa hay thường đều tính). Response liệt kê các trường sai trong `fields`. Thường điều này có nghĩa là một lệnh gọi SDK không trả về gì và code của bạn đã biến nó thành chuỗi. - Không gửi cả hai cho một tập đã mã hoá sẽ trả `409` `sdk_required`. ⋯ ## Lượt phát, prefetch và `intent` - Mỗi request xin vé thành công được ghi nhận phía Wandura và tính là một lượt phát. Nếu app tải tập trước khi người xem chạm vào, hãy báo cho Wandura bằng trường tuỳ chọn `intent`: + Mỗi request xin vé thành công được ghi nhận phía Wandura và tính là một lượt phát, trừ khi được đánh dấu là prefetch. Nếu app tải tập trước khi người xem chạm vào, hãy báo cho Wandura bằng trường tuỳ chọn `intent`: | Giá trị | Ý nghĩa | ⋯ | `prefetch` | App đang tải tập trước khi người xem chạm. Không tính là lượt phát. | - `intent` không bao giờ làm thay đổi response. Giá trị bị thiếu hoặc viết sai được ghi nhận là không xác định, không bị từ chối. Request prefetch vẫn tính vào [rate limit](rate-limits.md) của bạn. + `intent` không bao giờ làm thay đổi response. Giá trị bị thiếu hoặc viết sai được ghi nhận là không xác định, không bị từ chối, và request đó vẫn tính là một lượt phát: chỉ `prefetch` được loại khỏi số lượt phát. Request prefetch vẫn tính vào [rate limit](rate-limits.md) của bạn. ## `viewer_ref` ⋯ - Mảng rỗng nghĩa là chưa có phụ đề nào được gắn. Đó không phải lỗi. - - URL phụ đề không gắn với thời hạn của vé, nên bạn vẫn dùng được sau khi vé hết hạn. + - URL phụ đề không gắn với thời hạn của vé, nên bạn vẫn dùng được sau khi vé hết hạn. Khi Wandura thay một file phụ đề, file mới có URL mới và URL cũ thôi chạy: nếu URL đã lưu bị lỗi, hãy lấy URL hiện tại từ một vé mới. - Player native có thể nhận URL trực tiếp. Trong web player, đừng thêm thuộc tính `crossorigin` vào thẻ video để tải phụ đề bằng `<track>`: việc đó thay đổi cách chính video được request và có thể khiến video không phát được. Thay vào đó, hãy tải file WebVTT bằng `fetch` và thêm cue bằng `video.addTextTrack()`. ⋯
- 01/10/2026 · +1 −1 dòng
Xem thay đổi
⋯ ### Kiểm tra `protection` - Đọc `protection` ở mọi response. Chỉ bán tập trả phí khi giá trị là `private-encrypted`. Nếu bạn nhận được giá trị khác, đừng bán tập đó và hãy liên hệ đầu mối đối tác Wandura của bạn. + Đọc `protection` ở mọi response. Chỉ bán tập trả phí khi giá trị là `private-encrypted`. Nếu bạn nhận được giá trị khác, đừng bán tập đó và hãy liên hệ Wandura. ## Thời hạn {#expiry} ⋯
- 29/09/2026 · Tạo trang