# Kho video riêng

> **Dùng được khi kho riêng của tổ chức bạn đã được dựng xong.** Wandura dựng từng kho cùng bạn (kho, tên miền phát, key); trong lúc chờ, dùng [mô hình standard](https://docs.wandura.ai/vi/developers/architecture#compare-the-two-models). Hỏi Wandura trong kênh Discord của team bạn để bắt đầu.

> **TL;DR** — Thay vì xin Wandura một vé cho mỗi tập, tổ chức của bạn có thể có **kho riêng (space)** trên nền tảng video của Wandura (BytePlus VOD). Kho **chỉ** chứa những phim và bộ sưu tập fitness Wandura đã cấp phép cho bạn, được chép sẵn vào đó. Server của bạn đọc kho bằng một **key đọc, phát và sửa, chỉ dùng được trên kho của bạn**, và lấy link phát thẳng từ nền tảng. API của Wandura sẽ bổ sung metadata mà nền tảng không có, ví dụ diễn viên và bản dịch.

## Khi nào bạn có kho riêng
Wandura đề nghị kho riêng khi thiết lập giấy phép của bạn; bạn không tự tạo được. Wandura dựng kho cùng tên miền phát và key của bạn. So với các mô hình khác: [Kiến trúc · Chọn mô hình](https://docs.wandura.ai/vi/developers/architecture#compare-the-two-models).

## Cách hoạt động
```mermaid
sequenceDiagram
  participant W as Wandura
  participant S as Your space
  participant Srv as Your server
  participant App as Your app
  W->>S: copy the films and collections you licensed
  Srv->>S: list playlists and videos (your key)
  Srv->>S: ask for playback info (your key)
  S-->>Srv: playback links on your domain
  Srv-->>App: link for the viewer
  App->>S: play
  Srv->>W: extra metadata (cast, translations), joined by id
```

## Tên miền phát riêng
Mỗi kho đi kèm **tên miền phát của riêng tổ chức bạn**, dạng `<tên-tổ-chức>-playback.wandura.ai` cho phim và `<tên-tổ-chức>-fit-playback.wandura.ai` cho clip fitness. Mọi link phát trong kho của bạn đều nằm trên tên miền đó — không dùng chung với tổ chức khác. Wandura cấp chứng chỉ và cấu hình sẵn; bạn không cần làm gì ở phía DNS.

Tên miền là thứ **chỉ Wandura đổi được**. Nếu bạn cần thêm một tên miền nữa — ví dụ muốn tách số liệu giữa hai app của mình, xem [Đo lường và chi phí](https://docs.wandura.ai/vi/developers/concepts/own-space#usage) — hãy hỏi Wandura trong kênh Discord của team bạn.

## Key của bạn làm được gì
| Được | Không được |
|---|---|
| Đọc và phát mọi thứ trong kho của bạn | Đọc hoặc sửa bất kỳ kho nào khác |
| Sửa tiêu đề, mô tả, tag, playlist, ảnh và phụ đề; ẩn hoặc hiện video | Xoá video: hãy ẩn đi, hoặc nhờ Wandura |
| Tải video của riêng bạn lên (ví dụ trailer) và chạy mã hoá của kho | Đổi cấu hình kho hoặc tên miền |

Chỉnh sửa của bạn là của bạn: Wandura chỉ ghi các tag bắt đầu bằng `wd:` và thêm bản chép mới, nên thứ bạn đã sửa giữ nguyên. Khi Wandura cập nhật bản gốc, Wandura báo cho bạn và không đụng vào bản của bạn. Đừng xoá tag `wd:`. Video bạn tải lên và mã hoá bạn chạy được tính vào lượng dùng của tổ chức bạn.

Chỉ giữ key trên server, không bao giờ đặt trong app. Nếu lộ, báo Wandura: key mới được cấp và key cũ bị tắt.

## Phim và clip fitness
| Nội dung | Định dạng trong kho | Player |
|---|---|---|
| Phim | Chỉ HLS mã hoá | Player SDK (có giấy phép): [Player SDK](https://docs.wandura.ai/vi/developers/player-sdk) |
| Clip fitness từ 30 giây trở lên | HLS | Player thông thường bất kỳ (AVPlayer, ExoPlayer, hls.js) |
| Clip fitness ngắn (khoảng 10 giây) | MP4 | Player thông thường bất kỳ |

Danh sách đầy đủ bài tập trong thư viện fitness — mã, buổi tập, giai đoạn, thời lượng — ở [Danh mục bài tập](https://docs.wandura.ai/vi/developers/concepts/fitness-catalog). Dựng được giao diện và lịch tập từ đó trước khi kho của bạn sẵn sàng.

## Đo lường và chi phí
Vì kho của bạn tách riêng, nền tảng video **tự tách số liệu theo kho**: lượt phát và byte của từng video, dung lượng lưu trữ, và phần chuyển mã. Bạn không phải nhúng mã app vào link, cũng không phải xử lý log để biết phần nào là của mình. Wandura đối chiếu cùng những con số đó khi tính chi phí.

Một điều cần biết trước khi thiết kế: **số liệu tách theo kho, không tách theo app**. Nhiều app của bạn cùng đọc một kho thì chúng cộng vào cùng một con số. Nếu cần biết từng app dùng bao nhiêu, mỗi app cần **một tên miền phát riêng** — hỏi Wandura khi dựng kho, vì thêm về sau thì số liệu cũ không tách lại được.

Video bạn tự tải lên và mã hoá bạn tự chạy cũng tính vào lượng dùng của tổ chức bạn.

## Metadata
Wandura chép nội dung theo một bố cục cố định: mỗi bộ một playlist đặt tên bằng mã bộ (bộ dài hơn 100 tập tiếp ở `<code>-2`), tiêu đề tập `<code> · E<nn> · <tên>`, ảnh tên `<code>-poster-…`, `<code>-cover-…`, `<code>-hero-…`, và phụ đề WebVTT trên từng video. CMS đọc theo các quy ước đó chạy được ngay; ngoài ra bạn tự sắp xếp kho theo cách bạn muốn. Mỗi video trong kho có tiêu đề, mô tả, tag, danh mục, playlist, ảnh và phụ đề. Đọc chúng từ nền tảng. Thứ nền tảng không có (diễn viên, bản dịch, thời hạn giấy phép) sẽ được [Catalog](https://docs.wandura.ai/vi/developers/concepts/catalog) của Wandura bổ sung, kèm các id để nối một mục catalog với video trong kho của bạn. Wandura cũng sẽ báo cho server của bạn khi có thay đổi (tập mới, gỡ nội dung, sửa metadata), để bạn không phải quét kho. Trong lúc chờ, hỏi Wandura trong kênh Discord của team bạn.

Mỗi tập được chép còn mang các tag máy đọc: `wd:series:<code>`, `wd:ep:<nn>`, `wd:kind:episode` và `wd:lang:<ngôn ngữ>`. Một tập xuất hiện trong kho của bạn khi bản mã hoá của nó đã sẵn sàng ở đó, và chỉ bộ đã phát hành mới được chép.

## Khi giấy phép kết thúc
Wandura gỡ phim hoặc bộ sưu tập khỏi kho của bạn. Link server của bạn đã phát ra vẫn chạy tới khi hết hạn, nên gỡ nội dung khỏi app cùng lúc: [Khi quyền kết thúc](https://docs.wandura.ai/vi/developers/production/rights-end).

Khi cần gỡ khẩn (ví dụ có khiếu nại bản quyền), Wandura gỡ mọi bản chép của một bộ hoặc một tập khỏi kho của bạn cùng lúc: video kèm phụ đề, ảnh Wandura đã thêm, và các mục của những video đó trong playlist của bạn, kể cả playlist bạn tự tạo (playlist trống sau khi gỡ thì bị xoá). Video bạn tự tải lên giữ nguyên, và Wandura không chép lại nội dung đó. Gỡ khỏi app như trên.

## Liên quan
- [Kiến trúc · Chọn mô hình](https://docs.wandura.ai/vi/developers/architecture#compare-the-two-models)
- [Video mở](https://docs.wandura.ai/vi/developers/concepts/open-video): đường dùng chung cho app fitness nhỏ.
- [Bảo mật](https://docs.wandura.ai/vi/developers/concepts/security)