Class

TVTopShelfCarouselItem

An item containing images, video, and other information that you want to display using a carousel-based interface.

Declaration

@interface TVTopShelfCarouselItem : TVTopShelfItem

Overview

A TVTopShelfCarouselItem object offers a more dynamic way to present your content than section-based items. When a carousel item first appears, it displays either a static image or a short looping video as its background. When the navigation focus stops on the item, the system plays the video in the item's previewVideoURL property.

Create one or more TVTopShelfCarouselItem objects and fill them with information about your content. The system determines which properties of the object to display based on the content style. For the TVTopShelfCarouselContentStyleDetails style, the system displays all of the information in your carousel item. For the TVTopShelfCarouselContentStyleActions style, the system focuses on the actions associated with your item. To specify the actions for both styles, use the inherited playAction and displayAction properties of the object.

Topics

Specifying the Item Details

contextTitle

A localized string describing why the item is shown in the top shelf.

summary

A descriptive summary of a movie or show.

genre

The genre assigned to the movie or show.

duration

The length of the movie or show, in seconds.

creationDate

The original release date of the content.

Specifying the Content Previews

cinemagraphURL

The URL of a looping video to play, without sound, while the preview loads.

previewVideoURL

The URL for the content's trailer or preview.

Adding Media Badges

mediaOptions

Information about the media format and presentation options.

TVTopShelfCarouselItemMediaOptions

Constants indicating the item's audio and video capabilities.

Adding Custom Attributes

namedAttributes

Additional information to display for your content, such as a list of leading actors.

TVTopShelfNamedAttribute

An object you use to display additional information.

Relationships

Inherits From

See Also

Carousel Content

TVTopShelfCarouselContent

A set of items you present using a carousel-style interface in the top shelf.