Các thuộc tính của 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 nào cần dự kiến để giao diện người dùng có thể được điền vào 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 để tạo chương trình. Bạn có thể đọc thêm về các giá trị có thể sử dụng cho từng trường trong tài liệu tham khảo về mỗi phương thức setter trên trình tạo.
Kotlin
val program = PreviewProgram.Builder() .setChannelId(channelId) .setTitle(clip.getTitle()) .setDescription(clip.getDescription()) .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE) // Set required attributes .build()
Java
PreviewProgram program = new PreviewProgram.Builder() .setChannelId(channelId) .setTitle(clip.getTitle()) .setDescription(clip.getDescription()) .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE) // Set required attributes .build();
Bảng sau đây trình bày các thuộc tính có thể được gán 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.
Bạn phải cung cấp các thuộc tính được đánh dấu ✔; những dấu đượ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 | Bài đăng có đoạn video | Sự kiện | Kênh |
|---|---|---|---|---|---|---|---|
| Tác giả | (✔) | ||||||
| Phạm vi cung cấp | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Thể loại chuẩn | (✔) | (✔) | (✔) | (✔) | |||
| Mã nhận dạng kênh | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Content ID | (✔) | ||||||
| Mức phân loại nội dung | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| DurationMillis | ✔ | ✔ | ✔ | (✔) | |||
| Số tập | ✔ | ||||||
| Tên 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ặt hàng | (✔) | (✔) | |||||
| Đang hoạt động | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| URI biểu trưng (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Mô tả nội dung biểu trưng (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Giá ưu đãi | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Tỷ lệ khung hình của ảnh bìa áp phích | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| URI hình ảnh áp phích | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| URI video xem trước | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Ngày phát hành | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
| Đánh giá điểm xếp hạng | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Kiểu đánh giá phân loại | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Số hiển thị của phần | ✔ | ✔ | |||||
| Mô tả ngắn | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Thời gian bắt đầu (tính bằng mili giây) theo giờ UTC (*) | ✔ | ✔ | ✔ | ✔ | |||
| Thời gian kết thúc theo mili giây (*) | ✔ | ✔ | ✔ | ✔ | |||
| Giá khởi điểm | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Tỷ lệ khung hình hình thu nhỏ | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| URI hình thu nhỏ | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Tiêu đề | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Chiều cao video | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Chiều rộng video | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Weight | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
Xem trước hình ảnh
Sau đây là kích thước đề xuất cho hình ảnh xem trước:
| 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ệ 16:9 hoặc 4:3 và có kích thước tối thiểu được chỉ định trong bảng này. Sử dụng biểu trưng mờ để mang lại trải nghiệm người dùng tốt nhất.
Bạn có thể chỉ định kích thước chính xác của video xem trước bằng cách sử dụng VIDEO_WIDTH
và VIDEO_HEIGHT.