คู่มือนี้อธิบายโมเดลข้อมูลและขั้นตอนการผสานรวมสำหรับการเผยแพร่วิดีโอและรายการทีวีสดโดยใช้ Engage SDK
โมเดลข้อมูล MovieEntity
MovieEntity หมายถึงภาพยนตร์แบบเต็มเรื่อง ตารางต่อไปนี้สรุป
ฟิลด์หลัก
| เมธอดสาธารณะ | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
getName() |
สตริง | ต้องระบุ | ชื่อภาพยนตร์ (เช่น "Avengers: Endgame") |
getDescription() |
สตริง | ต้องระบุ | ข้อมูลสรุปที่ให้บริบทซึ่งจะปรากฏเมื่อวางเมาส์เหนือ |
getPosterImages() |
List<Image> | ต้องระบุ | รายการรูปภาพที่ใช้สำหรับแสดงโปสเตอร์ของภาพยนตร์ |
getPlatformSpecificPlaybackUris() |
List<PlatformSpecificUri> | ต้องระบุ | Deep Link สำหรับการเล่นบนแพลตฟอร์มที่เฉพาะเจาะจง |
getDurationMillis() |
ยาว | ต้องระบุ | ระยะเวลาทั้งหมดของภาพยนตร์เป็นมิลลิวินาที |
getCallToAction |
สตริง | ต้องระบุ (GTV) | ข้อความที่แสดงเพื่อกระตุ้นการโต้ตอบของผู้ใช้ (เช่น "ดูเลย") |
getTags |
List<String> | ไม่บังคับ | คีย์เวิร์ดที่ใช้ในการจัดหมวดหมู่ (เช่น "แอ็กชัน/ระทึกขวัญ") |
โมเดลข้อมูล LiveTvProgramEntity
LiveTvProgramEntity แสดงถึงรายการที่กำลังออกอากาศหรือมีกำหนดออกอากาศในช่องที่เฉพาะเจาะจง
| เมธอดสาธารณะ | ประเภท | ข้อกำหนด | คำอธิบาย |
|---|---|---|---|
getName() |
สตริง | ต้องระบุ | ชื่อของรายการ (เช่น "NBC CT Late News") |
getDescription() |
สตริง | ต้องระบุ | ข้อมูลสรุปที่ให้บริบทเกี่ยวกับโปรแกรม |
getPosterImages() |
List<Image> | ต้องระบุ | รูปภาพที่ใช้สำหรับการแสดงผลของโปรแกรม |
getAvailabilityTimeWindows() |
List<DisplayTimeWindow> | ต้องระบุ | กรอบเวลาที่กำหนดไว้สำหรับโปรแกรม |
getChannelId() |
สตริง | ต้องระบุ | ตัวระบุที่ไม่ซ้ำกันสำหรับช่องทีวี |
getChannelName() |
สตริง | ต้องระบุ | ชื่อช่องทีวี |
getChannelLogoImage() |
รูปภาพ | ต้องระบุ | รูปภาพโลโก้สำหรับช่องทีวี |
getCallToAction() |
สตริง | ต้องระบุ (GTV) | ข้อความพรอมต์การโต้ตอบ |
getTags() |
List<String> | ไม่บังคับ | คีย์เวิร์ดที่ใช้สำหรับการจัดหมวดหมู่ |
ตัวอย่างการใช้งาน Builder
ตัวอย่าง MovieEntity
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();
ตัวอย่าง LiveTvProgramEntity
ดู 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() จะใช้เพื่อส่งเนื้อหาที่แนะนำไปยังฟีเจอร์แครอเซล ประเภทคลัสเตอร์ควรตั้งค่าเป็น RecommendationClusterType.TYPE_PROVIDER_ROW
เวอร์ชัน Engage SDK
โปรดทราบว่าการผสานรวมนี้ต้องใช้ Engage SDK เวอร์ชันขั้นต่ำต่อไปนี้
engage-tv: 1.0.6