با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Ambient Mode یک محافظ صفحه نمایش است که در Google TV و Android TV تعبیه شده است. هدف آن جلوگیری از نمایش تصاویر ثابت برای مدت طولانی است. این برای فناوری‌های نمایشگر، مانند OLED، که ممکن است مستعد سوختن صفحه نمایش باشند، مهم است.
سیستم عامل پس از 10 دقیقه عدم فعالیت کاربر، دستگاه را در حالت محیطی قرار می دهد. پس از مدتی دیگر از عدم فعالیت کاربر (که توسط تنظیمات صرفه جویی انرژی دستگاه تعریف شده است) سیستم عامل وارد حالت صرفه جویی در انرژی می شود و نمایشگر را خاموش می کند. برنامه‌های پخش رسانه ممکن است از ورود دستگاه به حالت محیطی جلوگیری کنند، علیرغم عدم تعامل کاربر با آن، مثلاً در هنگام تماشای یک فیلم.
اگر کاربر ظرف 30 دقیقه پس از ورود به حالت محیطی با دستگاه تعامل داشته باشد، برنامه ای که در هنگام ورود به حالت محیطی فعال بوده بازیابی می شود. اگر کاربر بیش از 30 دقیقه پس از ورود به حالت محیطی با دستگاه تعامل داشته باشد، به صفحه اصلی باز می گردد. هنگامی که کاربر دستگاه را با استفاده از دکمه روشن/خاموش در حالی که در حالت ذخیره انرژی است راه اندازی می کند، به صفحه اصلی منتقل می شود. از طرف دیگر، اگر کاربر دستگاه را در حالی که در حالت صرفه جویی انرژی است با استفاده از دکمه های برنامه خاص (مثلاً YouTube) راه اندازی کند، مستقیماً به آن برنامه منتقل می شود.
برای پخش صدا، برنامه ها نباید از حالت محیطی در حین پخش جلوگیری کنند ، مگر اینکه محافظ صفحه نمایش خود را با تصاویر غیر ایستا اجرا کنند. تا زمانی که حالت محیطی فعال است، پخش صدا ادامه خواهد یافت.
پخش صوت در Android به طور ضمنی یک wake lock جزئی را نگه می‌دارد. این مانع از ورود دستگاه به حالت محیطی نمی شود، اما از انتقال بعدی به حالت ذخیره انرژی جلوگیری می کند . بنابراین پخش حتی پس از ورود دستگاه به حالت محیطی ادامه خواهد داشت، اما از خوابیدن دستگاه جلوگیری می‌شود تا امکان پخش بدون وقفه فراهم شود.
جلوگیری از حالت محیطی
می توان از قرار دادن دستگاه در حالت محیطی توسط سیستم عامل جلوگیری کرد، اما این باید مطابق با الزامات حالت محیطی استفاده شود. توسعه دهندگان برنامه نمی توانند از ورود دستگاه به حالت ذخیره انرژی جلوگیری کنند.
برنامه ها می توانند با تنظیم یک پرچم روی Window از خاموش شدن صفحه جلوگیری کنند:
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Ambient Mode is a screensaver built into Google TV and Android TV. Its purpose\nis to avoid displaying static images for extended periods. This is important\nfor display technologies, such as OLED, which may be susceptible to screen burn.\n\nThe OS will put the device into Ambient Mode after 10 minutes of user\ninactivity. After a further period of user inactivity (defined by the device\nEnergy Saver setting) the OS will enter Energy Saver mode,\npowering the display off. Media playback apps may prevent the device\nfrom entering Ambient Mode, despite the user not interacting with it, for\nexample, while watching a movie.\n\nIf the user interacts with the device within 30 minutes of entering Ambient\nMode, the app that was active when Ambient Mode was entered will be restored.\nIf the user interacts with the device more than 30 minutes after entering\nAmbient Mode, they will be returned to the Home screen.\nWhen the user starts the device using the power button while it's in Energy\nSaver mode, they will be taken to the Home screen. Alternatively, if the user\nstarts the device while it's in Energy Saver mode using specific app buttons\n(for example, YouTube) they will be taken directly to that app.\n| **Note:** It is important to ensure that your app meets [the Ambient Mode requirements](/docs/quality-guidelines/tv-app-quality#ambient-mode) when submitting it to Google Play.\n\nVideo playback\n--------------\n\nFor video playback, it's important to [prevent the device entering Ambient Mode\nduring user-initiated playback](/docs/quality-guidelines/tv-app-quality#TV-BU)\nto provide an uninterrupted viewing experience. However, apps should *not*\nprevent devices from entering Ambient Mode when playback is stopped or paused.\n\nAudio playback\n--------------\n\nFor audio playback, apps\n[should not prevent Ambient Mode during playback](/docs/quality-guidelines/tv-app-quality#TV-BA)\nunless they implement their own screensaver with non-static imagery.\nAudio playback will continue while Ambient Mode is active.\n\nAudio playback on Android will implicitly hold a\n[partial wake lock](/reference/android/os/PowerManager#PARTIAL_WAKE_LOCK).\nThis will *not* prevent the device from entering Ambient Mode, but *will*\nprevent the subsequent transition to Energy Saver mode. Playback will therefore\ncontinue even after the device enters Ambient Mode, but the device will be\nprevented from going to sleep to allow uninterrupted playback.\n\nPreventing Ambient Mode\n-----------------------\n\nIt is possible to prevent the OS from putting the device into Ambient Mode, but\nthis must be used in accordance with\n[Ambient Mode requirements](/docs/quality-guidelines/tv-app-quality#ambient-mode).\nApp developers cannot prevent the device from entering\nEnergy Saver mode.\n\nApps can prevent the screen from turning off by setting a flag on the\n[`Window`](/reference/android/view/Window): \n\n### Kotlin\n\n```kotlin\nrequireActivity().window.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)\n```\n\n### Java\n\n```java\nrequireActivity().getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);\n```\n\nAmbient Mode will be disabled while this flag is set. To re-enable it you must\nclear the flag: \n\n### Kotlin\n\n```kotlin\nrequireActivity().window.clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)\n```\n\n### Java\n\n```java\nrequireActivity().getWindow().clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);\n```\n| **Note:** You must only prevent the device from entering Ambient Mode for user-initiated playback sessions. If your app is [automatically playing video or animations](/docs/quality-guidelines/tv-app-quality#TV-BY), you must *not* set the [`FLAG_KEEP_SCREEN_ON`](/reference/android/view/WindowManager.LayoutParams#FLAG_KEEP_SCREEN_ON) flag."]]
