Thuộc tính của một chương trình video phụ thuộc vào loại nội dung của chương trình đó. Loại chương trình cho hệ thống biết siêu dữ liệu cần có để có thể điền vào giao diện người dùng một cách phù hợp.
Chương trình video có thể là một trong những loại sau:
Sử dụng PreviewProgram.Builder để xây dựng chương trình. Bạn có thể đọc thêm về các giá trị có thể có cho từng trường trong tài liệu tham khảo cho từng phương thức setter trên trình tạo.
val program = PreviewProgram.Builder() .setChannelId(channelId) .setTitle(clip.getTitle()) .setDescription(clip.getDescription()) .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE) // Set required attributes. .build()
Bảng sau đây cho thấy các thuộc tính có thể được chỉ định cho từng loại chương trình video. Mỗi thuộc tính liên kết với phương thức setter tương ứng trong PreviewProgram.Builder.
Các thuộc tính được đánh dấu ✔ là bắt buộc; các thuộc tính được đánh dấu (✔) là không bắt buộc.
| Thuộc tính | Phim | Phim truyền hình | Phần phim truyền hình | Tập phim truyền hình | Tạo đoạn trích video | Sự kiện | Kênh |
|---|---|---|---|---|---|---|---|
| Tác giả | (✔) | ||||||
| Phạm vi cung cấp | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Thể loại chính tắc | (✔) | (✔) | (✔) | (✔) | |||
| Mã nhận dạng kênh | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Content ID | (✔) | ||||||
| Mức phân loại nội dung | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| DurationMillis | ✔ | ✔ | ✔ | (✔) | |||
| Số tập | ✔ | ||||||
| Tiêu đề tập | (✔) | ||||||
| Thể loại | (✔) | (✔) | (✔) | (✔) | |||
| URI ý định | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Số lượt tương tác | (✔) | (✔) | |||||
| Loại tương tác | (✔) | (✔) | |||||
| Mã nhà cung cấp nội bộ | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Số lượng mục | (✔) | (✔) | |||||
| Video phát trực tiếp | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| URI biểu trưng (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Nội dung mô tả biểu trưng (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Giá chào bán | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Tỷ lệ khung hình của ảnh áp phích | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| URI ảnh áp phích | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| URI xem trước video | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Ngày phát hành | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
| Điểm xếp hạng của bài đánh giá | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Kiểu xếp hạng bài đánh giá | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Số phần hiển thị | ✔ | ✔ | |||||
| Mô tả ngắn | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Thời gian bắt đầu theo mili giây UTC (*) | ✔ | ✔ | ✔ | ✔ | |||
| Thời gian kết thúc theo giờ UTC (mili giây) (*) | ✔ | ✔ | ✔ | ✔ | |||
| Giá khởi điểm | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Tỷ lệ khung hình của hình thu nhỏ | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| URI hình thu nhỏ | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Tiêu đề | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Chiều cao video | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Chiều rộng video | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Weight | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
Hình ảnh xem trước
Kích thước đề xuất cho hình ảnh xem trước như sau:
| Thuộc tính | Tỷ lệ khung hình | Chiều rộng | Height |
ASPECT_RATIO_16_9 |
16:9 | 272 dp | 153 dp |
ASPECT_RATIO_3_2 |
3:2 | 229,5 dp | 153 dp |
ASPECT_RATIO_4_3 |
4:3 | 204 dp | 153 dp |
ASPECT_RATIO_1_1 |
1:1 | 153 dp | 153 dp |
ASPECT_RATIO_2_3 |
2:3 | 102 dp | 153 dp |
ASPECT_RATIO_MOVIE_POSTER |
1:1,441 | 106 dp | 153 dp |
Để có chất lượng tốt nhất, hãy sử dụng video xem trước có tỷ lệ khung hình 16:9 hoặc 4:3 và có kích thước tối thiểu như được chỉ định trong bảng này. Hãy sử dụng biểu trưng mờ để mang lại trải nghiệm tốt nhất cho người dùng.
Bạn có thể chỉ định chính xác kích thước video xem trước bằng VIDEO_WIDTH và VIDEO_HEIGHT.