با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
سیستمعامل Android TV میلیونها تلویزیون، دستگاههای پخش جریانی و دستگاههای تلویزیون پرداخت را تامین میکند. Google TV یک تجربه کاملاً جدید است که ابتدا در Chromecast با Google TV و به مرور زمان برای دستگاههای بیشتری در دسترس است.
همه برنامههای ساخته شده برای Android TV روی دستگاههای دارای Google TV کار میکنند. برای ارائه بهترین تجربه کاربری در Google TV، توصیه می کنیم بهترین روش ها را در این راهنما اعمال کنید.
الزامات پایه
پشتیبانی از Google Cast: Google Cast به شما امکان میدهد برنامههای Android، iOS و Chrome خود را گسترش دهید تا پخش صدا و ویدیو را به تلویزیونهای Android و همچنین دستگاههای Chromecast و دستگاههای Assistant فعال کنید. برای اطلاعات بیشتر، به مستندات Google Cast مراجعه کنید.
از جلسات رسانه ای استفاده کنید: جلسات رسانه راهی جهانی برای تعامل با پخش کننده صوتی یا تصویری ارائه می دهد. هنگامی که یک برنامه به Android اطلاع می دهد که در حال پخش رسانه است، کنترل های پخش را می توان به برنامه واگذار کرد. ادغام با جلسه رسانه به یک برنامه امکان می دهد پخش رسانه را به صورت خارجی تبلیغ کند و دستورات پخش را از منابع خارجی دریافت کند. این منابع می توانند دکمه های فیزیکی مانند دکمه پخش روی هدست یا کنترل از راه دور تلویزیون یا دستورات غیر مستقیم مانند دستور "مکث" به دستیار Google باشند. سپس جلسه رسانه این دستورات را به برنامه واگذار می کند، که آنها را به پخش کننده رسانه ای که دستورات از آنجا منشا گرفته اند اعمال می کند. برای جزئیات بیشتر به استفاده از جلسه رسانه مراجعه کنید.
کشف محتوا در سراسر سطوح
ارائه فید کنشهای رسانهای: وقتی فید کنشهای رسانهای JSON را به Google ارائه میدهید، محتوای شما را میتوان از طریق توصیههای Google TV و سایر سطوح Google، مانند جستجوی Google، کشف کرد. پیوندهای عمیقی که ارائه می کنید به کاربران اجازه می دهد مستقیماً به پخش محتوای شما بپردازند تا تعامل را افزایش دهند. این فید همچنین جستجوی روی دستگاه و توانایی پخش رسانه با استفاده از دستورات صوتی دستیار Google را فعال می کند.
Google در یک زمان با تعداد محدودی از ارائه دهندگان کار می کند تا آنها را در این ویژگی ادغام کند. برای جزئیات بیشتر، به مستندات Media Actions مراجعه کنید.
ادغام Watch Next: Watch Next به کاربران امکان می دهد دوباره با محتوای برنامه شما درگیر شوند. هنگامی که کاربران برنامه شما را از طریق یک فیلم یا با یک مجموعه تلویزیونی در حال انجام ترک می کنند، می توانید آن محتوا را مستقیماً در صفحه اصلی Google TV با استفاده از Watch Next نمایش دهید. کاربر می تواند یک کاشی را برای پیوند عمیق مستقیماً برای پخش در برنامه شما انتخاب کند. توجه داشته باشید که ادغام Watch Next باید برای نمایش کیفیت در دستگاههای Google TV تأیید شود. برای جزئیات بیشتر به مستندات Watch Next مراجعه کنید.
صدا و نامزدی
پیوند دادن حساب پشتیبانی: پیوند حساب، پیوند یکپارچهای را بین حساب Google کاربر و حساب برنامه شما فراهم میکند تا یک تجربه کاربری ساده را برای کاربران فعلی و جدید برنامه شما تسهیل کند. پیوند دادن حساب یک پیش نیاز برای قابلیتهای دیگر مانند اشتراکهای بدون اصطکاک، همگامسازی حق، و ارسال صدا است.
همگامسازی حق پشتیبانی: اگر فید کنشهای رسانهای شما شامل رسانههایی با الزامات استحقاق است - برای مثال، یک کاربر برای دسترسی به محتوا باید اشتراک خاصی داشته باشد - میتوانید از همگامسازی حق پشتیبانی کنید تا اعلام کنید یک حساب پیوندی دارای کدام اشتراک است. برای جزئیات بیشتر به مستندات نقطه پایانی حقوق مراجعه کنید.
ارسال صوتی را پیشنهاد دهید: ارسال صوتی به کاربران شما امکان میدهد پخش رسانه را در دستگاههای Cast پشتیبانیشده از طریق «دستیار Google» آغاز کنند. میتوانید با ارائه فید کنشهای رسانه ، پشتیبانی از پیوند حساب و ایجاد گیرنده Cast ، این عملکرد را فعال کنید.
فعال کردن Cast Connect: با Cast Connect، برنامه Android TV شما میتواند به عنوان گیرنده Cast عمل کند. این به شما امکان می دهد تجربه غنی تری ارائه دهید و از تعامل با کنترل از راه دور پشتیبانی کنید. برای جزئیات بیشتر به نمای کلی گیرنده Android TV مراجعه کنید.
جذب کاربر
ادغام صورتحساب Google Play: از کتابخانه Play Billing برای پشتیبانی از خریدهای درونبرنامه و مدیریت اشتراکها در تلفن همراه و تلویزیون استفاده کنید. برای جزئیات بیشتر به اسناد صورتحساب مراجعه کنید.
برنامهای که برای سیستمعامل Android TV ساخته شده است برای همه دستگاههای موجود در اکوسیستم تلویزیون، از جمله دستگاههای جدید با مارک Google TV، کار میکند. برای دانستن اینکه آیا دستگاهی تجربه Google TV را ارائه می دهد، به عنوان مثال برای تجزیه و تحلیل، می توانید ویژگی سیستم com.google.android.feature.AMATI_EXPERIENCEرا ارزیابی یا فیلتر کنید .
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Best practices to drive engagement on Google TV\n\nAndroid TV OS powers millions of TVs, streaming devices, and PayTV set-top boxes.\nGoogle TV is a brand-new experience available first on the Chromecast with\nGoogle TV and to more devices over time.\n\nAll apps built for Android TV work on devices running Google TV. To\nprovide the best user experience on Google TV, we recommend that you\napply the best practices in this guide.\n| **Note:** To ensure a great user experience, all TV apps must meet specific requirements for usability before they are available for TVs on Google Play. For more information, see [TV app quality](/docs/quality-guidelines/tv-app-quality).\n\nBaseline requirements\n---------------------\n\n- **Support Google Cast:** Google Cast lets you extend your Android, iOS, and Chrome apps to enable audio and video streaming to Android TVs as well as Chromecast devices and Assistant devices. For more information, see the [Google Cast\n documentation](https://developers.google.com/cast/docs/developers).\n- **Use media sessions:** media sessions provide a universal way of interacting with an audio or video player. When an app informs Android that it is playing media, playback controls can be delegated to the app. Integrating with the media session lets an app advertise media playback externally and receive playback commands from external sources. These sources can be physical buttons, such as the play button on a headset or TV remote control, or indirect commands, such as instructing \"pause\" to Google Assistant. The media session then delegates these commands to the app, which applies them to the media player where the commands originated. See [Using a media session](/guide/topics/media-apps/working-with-a-media-session) for more details.\n\nContent discovery across surfaces\n---------------------------------\n\n- **Offer a media actions feed:** when you provide a JSON media actions feed to Google,\n your content can be discovered through Google TV recommendations and\n other Google surfaces, such as Google Search. The deep links you provide let\n users jump directly into playback of your content to increase engagement. The\n feed also enables on-device search and the ability to play media using Google\n Assistant voice commands.\n\n Google is working with a limited number of\n providers at a time to integrate them into this feature. For more details,\n see the\n [Media Actions documentation](https://developers.google.com/actions/media).\n- **Integrate Watch Next:** Watch Next lets users re-engage with the content in your\n app. When users leave your app partway through a movie or with a TV series in\n progress, you can surface that content directly on the Google TV home screen\n using Watch Next. The user can select a tile to deep link directly\n into playback within your app. Note that a Watch Next integration must be\n certified for quality to show on Google TV devices. See the [Watch Next\n documentation](/training/tv/discovery/watch-next-add-programs) for more details.\n\nVoice and engagement\n--------------------\n\n- **Support account linking:** account linking provides seamless linking between a user's Google Account and your app's account to facilitate a streamlined user experience for your app's existing and new users. [Account\n linking](https://developers.google.com/identity/account-linking) is a prerequisite for other capabilities such as frictionless subscriptions, entitlement sync, and voice casting.\n- **Support entitlement sync:** if your media actions feed includes media with entitlement requirements---for example, a user needs to have a particular subscription to access content---you can support entitlement sync to declare which subscriptions a linked account has. See the [entitlements endpoint\n documentation](https://developers.google.com/actions/media/concepts/access-requirements#entitlements-endpoint) for more details.\n- **Offer voice casting:** voice casting lets your users initiate media playback on supported Cast devices through Google Assistant. You can enable this functionality by providing a [media actions](https://developers.google.com/actions/media) feed, supporting [account linking](https://developers.google.com/identity/account-linking/oauth-with-sign-in-linking?oauth=implicit), and creating a [Cast receiver](https://developers.google.com/cast/docs/developers).\n- **Enable Cast Connect:** with Cast Connect, your Android TV app can act as a Cast receiver. This lets you provide a richer experience and support interaction with the remote control. See the [Android TV Receiver Overview](https://developers.google.com/cast/docs/android_tv_receiver) for more details.\n\nUser acquisition\n----------------\n\n- **Integrate Google Play Billing:** use the Play Billing library to support in-app purchases and manage subscriptions across both mobile and TV. See the [billing\n documentation](/google/play/billing) for more details.\n- **Provide frictionless subscriptions:** by combining [streamlined account linking](https://developers.google.com/identity/account-linking/oauth-with-sign-in-linking?oauth=implicit), [Play Billing](/google/play/billing) with [real time developer notifications](/google/play/billing/getting-ready#configure-rtdn), and [silent sign-in](https://developers.google.com/android/reference/com/google/android/gms/auth/api/signin/GoogleSignInClient.html#silentSignIn%28%29), you can provide a seamless purchase experience for your users. Watch the [Frictionless Subscriptions video](https://www.youtube.com/watch?v=ARuf97ncE4w&list=PLWz5rJ2EKKc-Z8NeBXJkf1bzUVhx3fvh4&index=4) for more details.\n\nGoogle TV feature evaluation\n----------------------------\n\nAn app built for Android TV OS works for all the devices in the TV ecosystem,\nincluding new Google TV branded devices. To know whether a device\noffers the Google TV experience, for instance for analytics, you can\n[evaluate or\nfilter](/guide/topics/manifest/uses-feature-element#market-feature-filtering)\non the system feature `com.google.android.feature.AMATI_EXPERIENCE`."]]