افزودن برنامه‌ها به کانال «تماشای بعدی»

کانال «صف پخش» ردیف دومی است که در صفحه اصلی، بعداز ردیف برنامه‌ها، نشان داده می‌شود. سیستم این کانال را ایجاد و نگهداری می‌کند. برنامه شما می‌تواند برنامه‌هایی را به کانال «تماشای بعدی» اضافه کند: برنامه‌هایی که کاربر به‌عنوان جالب علامت‌گذاری کرده است، تماشای آن‌ها را در وسط متوقف کرده است، یا با محتوایی که کاربر درحال تماشا است مرتبط هستند (مانند قسمت بعدی در یک مجموعه یا فصل بعدی یک نمایش).

کانال «تماشای بعدی» محدودیت‌هایی دارد: برنامه شما نمی‌تواند ردیف کانال «تماشای بعدی» را جابه‌جا، حذف، یا پنهان کند.

قدم‌ها

درج برنامه‌ها در کانال «بعدی برای تماشا» مشابه درج برنامه‌ها در کانال خودتان است. برای جزئیات خاص «تماشای بعدی»، بخش‌های زیر را ببینید.

هنگام درج محتوا در کانال «تماشای بعدی»، باید این دستورالعمل‌ها را دنبال کنید:

نوع برنامه را انتخاب کنید

چهار نوع برنامه «بعدی برای تماشا» وجود دارد. نوع مناسب را انتخاب کنید:

نوع یادداشت‌ها
WATCH_NEXT_TYPE_CONTINUE کاربر هنگام تماشای محتوا متوقف شد.
WATCH_NEXT_TYPE_NEXT برنامه بعدی دردسترس در مجموعه‌ای که کاربر درحال تماشا است دردسترس باشد. برای مثال، اگر کاربر درحال تماشای قسمت ۳ از یک مجموعه باشد، برنامه می‌تواند پیشنهاد کند که قسمت ۴ را بعداز آن تماشا کند.
WATCH_NEXT_TYPE_NEW محتوای جدیدی که به‌وضوح از آنچه کاربر تماشا می‌کند پیروی می‌کند، اکنون دردسترس است. برای مثال، کاربر درحال تماشای قسمت ۵ از یک مجموعه است و قسمت ۶ برای تماشا دردسترس قرار می‌گیرد.
WATCH_NEXT_TYPE_WATCHLIST وقتی کاربر برنامه‌ای را ذخیره می‌کند، توسط سیستم یا برنامه درج می‌شود.

برای اطلاعات بیشتر، به ویژگی‌های «بعدی تماشا کنید» مراجعه کنید.

استفاده از سازنده WatchNextProgram

از WatchNextProgram.Builder استفاده کنید. برای اطلاعات بیشتر، به ویژگی‌های Watch Next مراجعه کنید.

val builder = WatchNextProgram.Builder()
builder.setType(TvContractCompat.WatchNextPrograms.TYPE_MOVIE)
    .setWatchNextType(TvContractCompat.WatchNextPrograms.WATCH_NEXT_TYPE_CONTINUE)
    .setLastEngagementTimeUtcMillis(time)
    .setTitle("Title")
    .setDescription("Program description")
    .setPosterArtUri(uri)
    .setIntentUri(uri)
    .setInternalProviderId(appProgramId)

val watchNextProgramUri = context.contentResolver
    .insert(
        TvContractCompat.WatchNextPrograms.CONTENT_URI,
        builder.build().toContentValues()
    )

از TvContractCompat.buildWatchNextProgramUri(long watchNextProgramId) برای ایجاد Uri موردنیاز برای به‌روزرسانی برنامه «بعدی برای تماشا» استفاده کنید.

وقتی کاربر برنامه‌ای را به کانال «بعدی تماشا کنید» اضافه می‌کند، سیستم برنامه را در ردیف کپی می‌کند. این برنامه هدف TvContractCompat.ACTION_PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT را ارسال می‌کند تا به برنامه اطلاع دهد که برنامه اضافه شده است. هدف شامل دو مورد اضافی است: شناسه برنامه که کپی شده است و شناسه برنامه ایجادشده برای برنامه در کانال «بعدی تماشا کنید».