Bu kılavuzda, Engage SDK'sını kullanarak video ve canlı TV içeriği yayınlamaya yönelik veri modeli ve entegrasyon adımları açıklanmaktadır.
MovieEntity veri modeli
MovieEntity simgesi, uzun metrajlı bir filmi ifade eder. Aşağıdaki tabloda temel alanlar özetlenmektedir.
| Herkese Açık Yöntemler | Tür | Şartlar | Açıklama |
|---|---|---|---|
getName() |
Dize | Zorunlu | Filmin başlığı (ör. "Avengers: Endgame") |
getDescription() |
Dize | Zorunlu | Fareyle üzerine gelindiğinde görünen, bağlam sağlayan bir özet |
getPosterImages() |
List<Image> | Zorunlu | Filmin poster gösterimi için kullanılan resimlerin listesi |
getPlatformSpecificPlaybackUris() |
List<PlatformSpecificUri> | Zorunlu | Belirli platformlarda oynatma için derin bağlantılar |
getDurationMillis() |
Uzun | Zorunlu | Filmin toplam süresi (milisaniye cinsinden) |
getCallToActionText() |
Dize | Zorunlu (GTV) | Kullanıcı etkileşimini teşvik etmek için gösterilen metin (ör. "Şimdi İzle") |
getTags() |
List<String> | İsteğe bağlı | Kategorizasyon için kullanılan anahtar kelimeler (ör. "Aksiyon/Gerilim") |
LiveTvProgramEntity veri modeli
LiveTvProgramEntity, belirli bir kanalda yayınlanan veya yayınlanması planlanan bir programı temsil eder.
| Herkese Açık Yöntemler | Tür | Şartlar | Açıklama |
|---|---|---|---|
getName() |
Dize | Zorunlu | Programın başlığı (ör. "NBC CT Late News") |
getDescription() |
Dize | Zorunlu | Program hakkında bilgi veren bir özet |
getPosterImages() |
List<Image> | Zorunlu | Programın gösterimi için kullanılan resimler |
getAvailabilityTimeWindows() |
List<DisplayTimeWindow> | Zorunlu | Program için planlanan zaman aralıkları |
getChannelId() |
Dize | Zorunlu | TV kanalının benzersiz tanımlayıcısı |
getChannelName() |
Dize | Zorunlu | TV kanalının adı |
getChannelLogoImage() |
Resim | Zorunlu | TV kanalı için logo resmi |
getCallToActionText() |
Dize | Zorunlu (GTV) | Etkileşim istemi metni |
getTags() |
List<String> | İsteğe bağlı | Kategorizasyon için kullanılan anahtar kelimeler |
Builder kullanım örnekleri
MovieEntity örnek
MovieEntity.Builder konusuna bakın.
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)
.setCallToActionText("Watch Now")
.addTag("Action/Thriller")
.build();
LiveTvProgramEntity örnek
LiveTvProgramEntity.Builder bölümüne bakın.
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())
.setCallToActionText("Watch Now")
.addTag("News")
.build();
API
publishRecommendationClusters(), Öne Çıkanlar Arşivi'ne aday içerik göndermek için kullanılır. Küme
türü RecommendationClusterType.TYPE_PROVIDER_ROW olarak ayarlanmalıdır.
Öğe sınırları ve hedefleme
- Öğe Sınırları: Öne Çıkan Öğeler Çarkı'nda en fazla 3 öğe gösterilir.
- Hedefleme: Öne Çıkan Öğeler Karusel içeriğini her bir cihaz için ayrı ayrı özelleştirebilirsiniz. İçerik, cihaza yüklenen istemci uygulamasından yayınlandığı için her kullanıcı veya cihaz için benzersiz ve kişiselleştirilmiş aday listeleriyle doldurabilirsiniz. Ancak Engage SDK yerleşik hedefleme desteği sağlamadığından bu hedefleme mantığını uygulamak sizin sorumluluğunuzdadır.
Engage SDK sürümü
Bu entegrasyon için gereken minimum Engage SDK sürümünü not edin:
engage-tv: 1.0.6