Questa guida descrive il modello di dati e i passaggi di integrazione per la pubblicazione di contenuti video e TV in diretta utilizzando l'SDK Engage.
MovieEntity modello dei dati
MovieEntity rappresenta un film integrale. La tabella seguente riepiloga
i campi chiave.
| Metodi pubblici | Tipo | Requisito | Descrizione |
|---|---|---|---|
getName() |
Stringa | Obbligatorio | Il titolo del film (ad es. "Avengers: Endgame") |
getDescription() |
Stringa | Obbligatorio | Un riepilogo che fornisce il contesto visualizzato al passaggio del mouse |
getPosterImages() |
List<Image> | Obbligatorio | Un elenco di immagini utilizzate per la visualizzazione della locandina del film |
getPlatformSpecificPlaybackUris() |
List<PlatformSpecificUri> | Obbligatorio | Link diretti per la riproduzione su piattaforme specifiche |
getDurationMillis() |
Lungo | Obbligatorio | La durata totale del film in millisecondi |
getCallToAction |
Stringa | Obbligatorio (GTV) | Testo visualizzato per richiedere l'interazione dell'utente (ad es. "Guarda ora") |
getTags |
List<String> | Facoltativo | Parole chiave utilizzate per la categorizzazione (ad es. "Azione/Thriller") |
LiveTvProgramEntity modello dei dati
Il LiveTvProgramEntity rappresenta un programma in onda o la cui trasmissione è programmata su un canale specifico.
| Metodi pubblici | Tipo | Requisito | Descrizione |
|---|---|---|---|
getName() |
Stringa | Obbligatorio | Il titolo del programma (ad es. "NBC CT Late News") |
getDescription() |
Stringa | Obbligatorio | Un riepilogo che fornisce il contesto del programma |
getPosterImages() |
List<Image> | Obbligatorio | Immagini utilizzate per la visualizzazione del programma |
getAvailabilityTimeWindows() |
List<DisplayTimeWindow> | Obbligatorio | Le finestre temporali programmate per il programma |
getChannelId() |
Stringa | Obbligatorio | Identificatore univoco del canale TV |
getChannelName() |
Stringa | Obbligatorio | Nome del canale TV |
getChannelLogoImage() |
Immagine | Obbligatorio | Immagine del logo del canale TV |
getCallToAction() |
Stringa | Obbligatorio (GTV) | Testo del prompt di interazione |
getTags() |
List<String> | Facoltativo | Parole chiave utilizzate per la categorizzazione |
Esempi di utilizzo del generatore
Esempio di MovieEntity
Consulta MovieEntity.Builder.
MovieEntity movie = new MovieEntity.Builder()
.setName("La hora 25")
.setDescription("Brogan tiene 24 horas para revalorar su vida antes de ser encarcelado")
.addPosterImage(new Image.Builder()
.setImageUri(Uri.parse("https://www.example.com/movie_poster.png"))
.build())
.addPlatformSpecificPlaybackUri(new PlatformSpecificUri.Builder()
.setUri("https://www.example.com")
.setPlatformType(PlatformType.TYPE_TV)
.build())
.setDurationMillis(7200000L)
.setCallToAction("Watch Now")
.addTag("Action/Thriller")
.build();
Esempio di LiveTvProgramEntity
Vedi LiveTvProgramEntity.Builder.
LiveTvProgramEntity liveProgram = new LiveTvProgramEntity.Builder()
.setName("3:30AM: NBC CT Late News")
.setDescription("The latest local news, weather and investigative stories.")
.setChannelId("https://www.example.com")
.setChannelName("Tastemade")
.setChannelLogoImage(new Image.Builder()
.setImageUri(Uri.parse("https://example.com/v1/channels/logo.png"))
.build())
.addAvailabilityTimeWindow(new DisplayTimeWindow.Builder()
.setStartTimestampMillis(1756713600000L)
.setEndTimestampMillis(1756715400000L)
.build())
.addPosterImage(new Image.Builder()
.setImageUri(Uri.parse("https://example.com/v1/assets/image.jpg"))
.build())
.setCallToAction("Watch Now")
.addTag("News")
.build();
API
publishRecommendationClusters() verrà utilizzato per inviare i contenuti candidati al carosello delle funzionalità. Il tipo di cluster deve essere impostato su RecommendationClusterType.TYPE_PROVIDER_ROW.
Versione dell'SDK Engage
Prendi nota della versione minima dell'SDK Engage richiesta per questa integrazione:
engage-tv: 1.0.6