این راهنما مدل داده و مراحل ادغام برای انتشار محتوای ویدیو و تلویزیون زنده بااستفاده از Engage SDK را شرح میدهد.
مدل داده MovieEntity
MovieEntity نشاندهنده فیلم کامل است. جدول زیر فیلدهای کلیدی را خلاصه میکند.
| روشهای عمومی | نوع | الزام | شرح |
|---|---|---|---|
getName() |
رشته | الزامی | عنوان فیلم (مثلاً «انتقامجویان: پایان بازی») |
getDescription() |
رشته | الزامی | خلاصهای که بافت را ارائه میدهد و با نگه داشتن نشانگر روی آن ظاهر میشود |
getPosterImages() |
List<Image> | الزامی | فهرستی از تصاویر استفادهشده برای نمایش پوستر فیلم |
getPlatformSpecificPlaybackUris() |
List<PlatformSpecificUri> | الزامی | پیوندهای عمیق برای بازپخش در پلاتفرمهای خاص |
getDurationMillis() |
بلند | الزامی | مدتزمان کل فیلم برحسب میلیثانیه |
getCallToActionText() |
رشته | الزامی (ارزش ناخالص تراکنشها) | نوشتار نمایشدادهشده برای درخواست تعامل کاربر (مثلاً «اکنون تماشا کنید») |
getTags() |
List<String> | اختیاری | کلیدواژههای استفادهشده برای دستهبندی (مثلاً «اکشن/هیجانی») |
مدل داده LiveTvProgramEntity
LiveTvProgramEntity نشاندهنده برنامهای است که درحال پخش است یا برای پخش در کانال خاصی زمانبندی شده است.
| روشهای عمومی | نوع | الزام | شرح |
|---|---|---|---|
getName() |
رشته | الزامی | عنوان برنامه (مثلاً «NBC CT Late News») |
getDescription() |
رشته | الزامی | خلاصهای که بافت برنامه را ارائه میدهد |
getPosterImages() |
List<Image> | الزامی | تصاویر استفادهشده برای نمایش برنامه |
getAvailabilityTimeWindows() |
List<DisplayTimeWindow> | الزامی | پنجرههای زمانی زمانبندیشده برای برنامه |
getChannelId() |
رشته | الزامی | شناسه یکتای کانال تلویزیونی |
getChannelName() |
رشته | الزامی | نام کانال تلویزیونی |
getChannelLogoImage() |
تصویر | الزامی | تصویر نشانواره کانال تلویزیونی |
getCallToActionText() |
رشته | الزامی (ارزش ناخالص تراکنشها) | نوشتار پیامواره تعامل |
getTags() |
List<String> | اختیاری | کلیدواژههای استفادهشده برای دستهبندی |
مثالهایی از کاربرد Builder
MovieEntity مثال
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()
.setActionUri(Uri.parse("https://www.example.com"))
.setPlatformType(PlatformType.TYPE_ANDROID_TV)
.build())
.setDurationMillis(7200000L)
.setCallToActionText("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())
.setCallToActionText("Watch Now")
.addTag("News")
.build();
API
از publishRecommendationClusters() برای ارسال محتوای نامزد به «گردونه ویژگی» استفاده خواهد شد. نوع
خوشه باید روی RecommendationClusterType.TYPE_PROVIDER_ROW تنظیم شود.
محدودیتهای مورد و هدفیابی
- محدودیتهای مورد: «گردونه ویژه» حداکثر ۳ مورد را نمایش میدهد.
- هدفیابی: میتوانید محتوای «گردونه ویژه» را برای هر دستگاه بهطور جداگانه سفارشیسازی کنید. ازآنجاییکه محتوا از برنامه کارخواه نصبشده در دستگاه منتشر میشود، میتوانید آن را با فهرستهای نامزد منحصربهفرد و شخصیسازیشده برای هر کاربر یا دستگاه پر کنید. بااینحال، شما مسئول پیادهسازی این منطق هدفیابی هستید، زیرا Engage SDK پشتیبانی هدفیابی داخلی ارائه نمیدهد.
نسخه Engage SDK
به حداقل نسخه Engage SDK موردنیاز برای این ادغام توجه کنید:
engage-tv: 1.0.6