Атрибуты видеопрограммы

Атрибуты видеопрограммы зависят от типа её контента. Тип программы указывает системе, какие метаданные следует ожидать, чтобы пользовательский интерфейс мог соответствующим образом заполнить информацию.

Видеопрограммы могут быть следующих типов:

• TYPE_MOVIE
• TYPE_TV_SERIES
• TYPE_TV_SEASON
• TYPE_TV_EPISODE
• TYPE_CLIP
• TYPE_EVENT
• TYPE_CHANNEL

Используйте PreviewProgram.Builder для создания программы. Подробнее о возможных значениях для каждого поля можно прочитать в справочной документации по каждому сеттеру в конструкторе.

Котлин

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();

В следующей таблице показаны атрибуты, которые можно присвоить каждому типу видеопрограммы. Каждый атрибут связан с соответствующим параметром в PreviewProgram.Builder . Атрибуты, отмеченные ✔, являются обязательными; атрибуты, отмеченные (✔), являются необязательными.

Атрибут	Фильм	Сериал	Телевизионный сезон	Эпизод телепередачи	Видеоклип	Событие	Канал
Автор					(✔)
Доступность	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
Канонические жанры	(✔)	(✔)	(✔)	(✔)
Идентификатор канала	✔	✔	✔	✔	✔	✔	✔
Идентификатор контента					(✔)
Рейтинги контента	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
DurationMillis	✔			✔	✔	(✔)
Номер эпизода				✔
Название эпизода				(✔)
Жанр	(✔)	(✔)	(✔)	(✔)
URI намерения	✔	✔	✔	✔	✔	✔	✔
Количество взаимодействий					(✔)	(✔)
Тип взаимодействия					(✔)	(✔)
Внутренний идентификатор поставщика	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
Количество товаров		(✔)	(✔)
Жить	(✔)			(✔)	(✔)	(✔)	(✔)
URI логотипа (*)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
Описание содержимого логотипа (*)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
Предложенная цена	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
Соотношение сторон плакатного изображения	✔	✔	✔	✔	✔	✔	✔
URI для плакатов	✔	✔	✔	✔	✔	✔	✔
URI предварительного просмотра видео	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
Дата выпуска	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
Рейтинг отзывов	(✔)	(✔)	(✔)	(✔)			(✔)
Стиль оценки отзывов	(✔)	(✔)	(✔)	(✔)			(✔)
Номер сезонного дисплея			✔	✔
Краткое описание	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
Время начала UTC Миллис (*)	✔			✔	✔	✔
Время окончания UTC Миллис (*)	✔			✔	✔	✔
Начальная цена	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
Соотношение сторон миниатюры	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
URI миниатюры	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
Заголовок	✔	✔	✔	✔	✔	✔	✔
Высота видео	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
Ширина видео	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)
Масса	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)	(✔)

Примечание: (*) LOGO_CONTENT_DESCRIPTION требуется при использовании LOGO_URI . Время START и END отображается на экране только тогда, когда атрибут LIVE имеет true .

Предварительный просмотр изображений

Рекомендуемые размеры для изображений предварительного просмотра следующие:

Атрибут	Соотношение сторон	Ширина	Высота
ASPECT_RATIO_16_9	16:9	272 дп	153 дп
ASPECT_RATIO_3_2	3:2	229,5 дп	153 дп
ASPECT_RATIO_4_3	4:3	204 дп	153 дп
ASPECT_RATIO_1_1	1:1	153 дп	153 дп
ASPECT_RATIO_2_3	2:3	102 дп	153 дп
ASPECT_RATIO_MOVIE_POSTER	1:1.441	106 дп	153 дп

Для наилучшего качества используйте предварительные видеоролики в формате 16:9 или 4:3, размер которых не меньше указанного в этой таблице. Для лучшего пользовательского опыта используйте непрозрачный логотип.

Точные размеры предварительного просмотра видео можно указать с помощью VIDEO_WIDTH и VIDEO_HEIGHT .