Thuộc tính chương trình video

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.