highlightGroups
An array containing groups of individual highlights in a media item.
Declaration
var highlightGroups: [TVMediaItem.HighlightGroup] { get }Discussion
The highlightGroups property enables you to show several groups highlights from a stream. Each highlight group in the array contains a list of highlights. Each highlight is an object with the following properties: highlightDescription, localizedName, imageURL, and TVMediaItem.TimeRange.
For example, consider a video of a baseball game, which is the media item. You can create a highlight group containing the video for each home run —each highlight— in the game. You create another highlight group containing all of the errors. You put these highlight groups into the highlightGroups property.