동영상 프로그램 속성

동영상 프로그램의 속성은 콘텐츠 유형에 따라 다릅니다. 프로그램 유형은 UI가 적절히 채워질 수 있도록 시스템에 예상되는 메타데이터를 알려줍니다. 동영상 프로그램은 다음 유형 중 하나일 수 있습니다.

프로그램을 빌드하려면 PreviewProgram.Builder를 사용합니다. 각 필드에 가능한 값에 관한 자세한 내용은 Builder의 각 setter에 관한 참조 문서를 읽어보세요.

Kotlin

    val program = PreviewProgram.Builder()
            .setChannelId(channelId)
            .setTitle(clip.getTitle())
            .setDescription(clip.getDescription())
            .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
            // Set required attributes
            .build()
    

자바

    PreviewProgram program = new PreviewProgram.Builder()
            .setChannelId(channelId)
            .setTitle(clip.getTitle())
            .setDescription(clip.getDescription())
            .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
            // Set required attributes
            .build();
    

다음 표에는 각 유형의 동영상 프로그램에 할당할 수 있는 속성 및 PreviewProgram.Builder의 해당 setter 링크가 나와 있습니다. 로 표시된 속성은 필수이며 (✔)로 표시된 속성은 선택사항입니다.

속성 영화 TV 시리즈 TV 시즌 TV 에피소드 클립 일정 채널
Author (✔)
Availability (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Canonical Genres (✔)(✔)(✔)(✔)
Channel ID
Content ID (✔)
Content Ratings (✔)(✔) (✔)(✔) (✔)(✔)(✔)
DurationMillis (✔)
Episode Number
Episode Title (✔)
Genre (✔)(✔) (✔)(✔)
Intent URI
Interaction Count (✔)(✔)
Interaction Type (✔)(✔)
Internal Provider ID (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Item Count(✔) (✔)
Live (✔)(✔)(✔)(✔)(✔)
Logo URI (*) (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Logo Content Description (*) (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Offer Price (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Poster Art Aspect Ratio
Poster Art URI
Preview Video URI (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Release Date (✔)(✔)(✔)(✔)(✔)(✔)
Review Rating (✔)(✔)(✔)(✔)(✔)
Review Rating Style (✔)(✔)(✔)(✔)(✔)
Season Display Number
Short Description (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Start Time UTC Millis (*)
End Time UTC Millis (*)
Starting Price (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Thumbnail Aspect Ratio (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Thumbnail URI (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Title
Video Height (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Video Width (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Weight (✔)(✔)(✔)(✔)(✔)(✔)(✔)
미리보기 이미지

권장되는 미리보기 크기는 다음과 같습니다.

속성 가로세로 비율 너비 높이
ASPECT_RATIO_16_9 16:9 272dp 153dp
ASPECT_RATIO_3_2 3:2 229.5dp 153dp
ASPECT_RATIO_4_3 4:3 204dp 153dp
ASPECT_RATIO_1_1 1:1 153dp 153dp
ASPECT_RATIO_2_3 2:3 102dp 153dp
ASPECT_RATIO_MOVIE_POSTER 1:1.441 106dp 153dp

최적의 품질을 위해 미리보기 동영상은 16:9 또는 4:3이고 위 표에 지정된 크기 이상이어야 합니다. 또한 최상의 사용자 환경을 위해서는 로고가 불투명해야 합니다.

VIDEO_WIDTH 및 VIDEO_HEIGHT를 사용하여 정확한 미리보기 동영상 크기를 지정할 수 있습니다.