# 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
```

## 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ỳ |

## 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)