फ़ोल्ड किए जा सकने वाले डिवाइस, दर्शकों को वीडियो देखने का बेहतरीन अनुभव देते हैं. रीयर डिसप्ले मोड और ड्यूअल-स्क्रीन मोड में, फ़ोल्ड किए जा सकने वाले डिवाइस के लिए डिसप्ले की खास सुविधाएं उपलब्ध कराई जा सकती हैं रीयर कैमरा सेल्फ़ी की झलक और एक साथ कई, लेकिन अलग-अलग तरह के डिवाइस इनर और आउटर स्क्रीन पर दिखता है.
पीछे की तरफ़ मौजूद डिसप्ले का मोड
आम तौर पर, फ़ोल्ड किए गए डिवाइस को अनफ़ोल्ड करने पर, सिर्फ़ अंदर की स्क्रीन चालू होती है. रीयर डिसप्ले मोड की मदद से, किसी गतिविधि को फ़ोल्ड किए जा सकने वाले डिवाइस की आउटर स्क्रीन पर ले जाया जा सकता है ऐसा करना जो डिवाइस के अनफ़ोल्ड होने पर भी व्यक्ति के सामने न हो. अंदरूनी डिसप्ले अपने-आप बंद हो जाता है.
एक नया ऐप्लिकेशन है, कैमरे की झलक को आउटर स्क्रीन पर दिखाने के लिए. इसलिए, इसमें लोग पीछे के कैमरे से सेल्फ़ी ले सकते हैं. यह सुविधा आम तौर पर बहुत बेहतर है इसमें सामने वाले कैमरे की तुलना में ज़्यादा तस्वीरें लेने की सुविधा मिलती है.
रीयर डिसप्ले मोड को चालू करने के लिए, उपयोगकर्ता एक डायलॉग का जवाब देते हैं, ताकि ऐप्लिकेशन को ये काम करने की अनुमति मिल सके स्क्रीन स्विच करें, उदाहरण के लिए:

सिस्टम ही डायलॉग बनाता है, इसलिए आपको कुछ करने की ज़रूरत नहीं है. डिवाइस की स्थिति के आधार पर अलग-अलग डायलॉग दिखते हैं; उदाहरण के लिए, सिस्टम डिवाइस बंद होने पर, उपयोगकर्ताओं को डिवाइस अनफ़ोल्ड करने के निर्देश देती है. इन्हें अपनी पसंद के मुताबिक नहीं बनाया जा सकता और यह अलग-अलग OEM के डिवाइसों पर अलग-अलग हो सकता है.
Pixel Fold के कैमरा ऐप्लिकेशन में, रीयर डिसप्ले मोड आज़माया जा सकता है. Jetpack WindowManager की मदद से, फ़ोल्ड किए जा सकने वाले डिवाइसों पर अपने कैमरा ऐप्लिकेशन को ऑप्टिमाइज़ करना कोडलैब में, इसे लागू करने का सैंपल देखें.
ड्यूअल स्क्रीन मोड
ड्यूअल-स्क्रीन मोड से, फ़ोल्ड किए जा सकने वाले डिवाइस के दोनों डिसप्ले पर कॉन्टेंट दिखाया जा सकता है एक साथ. ड्यूअल-स्क्रीन मोड, Android 14 (एपीआई लेवल 34) या इसके बाद के वर्शन पर चलने वाले Pixel Fold पर उपलब्ध है.
प्रॉडक्ट के इस्तेमाल का एक उदाहरण, दो स्क्रीन पर काम करने वाला अनुवादक मोड है.

प्रोग्राम के हिसाब से मोड चालू करना
Jetpack के ज़रिए, रीयर डिसप्ले मोड और ड्यूअल-स्क्रीन मोड को ऐक्सेस किया जा सकता है WindowManager एपीआई, जिनमें लाइब्रेरी के वर्शन 1.2.0-beta03 से शुरू होते हैं.
अपने ऐप्लिकेशन के मॉड्यूल build.gradle
फ़ाइल में WindowManager डिपेंडेंसी जोड़ें:
ग्रूवी
dependencies { implementation "androidx.window:window:1.2.0-beta03" }
Kotlin
dependencies { implementation("androidx.window:window:1.2.0-beta03") }
एंट्री पॉइंट WindowAreaController
है. यह विंडो को एक डिसप्ले से दूसरे डिसप्ले पर या किसी डिवाइस के डिसप्ले एरिया के बीच ले जाने से जुड़ी जानकारी और व्यवहार देता है. WindowAreaController
की मदद से, उपलब्ध WindowAreaInfo
ऑब्जेक्ट की सूची के बारे में क्वेरी की जा सकती है.
WindowAreaInfo
का इस्तेमाल करके WindowAreaSession
को ऐक्सेस करें. यह एक ऐसा इंटरफ़ेस है जो
ऐक्टिव विंडो एरिया की सुविधा को दिखाता है. किसी खास WindowAreaCapability
की उपलब्धता का पता लगाने के लिए, WindowAreaSession
का इस्तेमाल करें.
हर सुविधा, किसी खास WindowAreaCapability.Operation
से जुड़ी होती है.
1.2.0-beta03 वर्शन में, Jetpack WindowManager दो तरह की कार्रवाइयों के साथ काम करता है:
WindowAreaCapability.Operation.OPERATION_PRESENT_ON_AREA
, यानी कि ड्यूअल-स्क्रीन मोड को चालू करने के लिए इस्तेमाल किया गयाWindowAreaCapability.Operation.OPERATION_TRANSFER_ACTIVITY_TO_AREA
, जिसका इस्तेमाल रीयर डिसप्ले मोड को चालू करने के लिए किया जाता है
यहां ऐप्लिकेशन की मुख्य गतिविधि में, पीछे के डिसप्ले मोड और ड्यूअल-स्क्रीन मोड के लिए वैरिएबल का एलान करने का उदाहरण दिया गया है:
Kotlin
private lateinit var windowAreaController: WindowAreaController private lateinit var displayExecutor: Executor private var windowAreaSession: WindowAreaSession? = null private var windowAreaInfo: WindowAreaInfo? = null private var capabilityStatus: WindowAreaCapability.Status = WindowAreaCapability.Status.WINDOW_AREA_STATUS_UNSUPPORTED private val dualScreenOperation = WindowAreaCapability.Operation.OPERATION_PRESENT_ON_AREA private val rearDisplayOperation = WindowAreaCapability.Operation.OPERATION_TRANSFER_ACTIVITY_TO_AREA
Java
private WindowAreaControllerCallbackAdapter windowAreaController = null; private Executor displayExecutor = null; private WindowAreaSessionPresenter windowAreaSession = null; private WindowAreaInfo windowAreaInfo = null; private WindowAreaCapability.Status capabilityStatus = WindowAreaCapability.Status.WINDOW_AREA_STATUS_UNSUPPORTED; private WindowAreaCapability.Operation dualScreenOperation = WindowAreaCapability.Operation.OPERATION_PRESENT_ON_AREA; private WindowAreaCapability.Operation rearDisplayOperation = WindowAreaCapability.Operation.OPERATION_TRANSFER_ACTIVITY_TO_AREA;
यहां बताया गया है कि वैरिएबल की शुरुआत कैसे करें onCreate()
गतिविधि:
Kotlin
displayExecutor = ContextCompat.getMainExecutor(this) windowAreaController = WindowAreaController.getOrCreate() lifecycleScope.launch(Dispatchers.Main) { lifecycle.repeatOnLifecycle(Lifecycle.State.STARTED) { windowAreaController.windowAreaInfos .map { info -> info.firstOrNull { it.type == WindowAreaInfo.Type.TYPE_REAR_FACING } } .onEach { info -> windowAreaInfo = info } .map { it?.getCapability(operation)?.status ?: WindowAreaCapability.Status.WINDOW_AREA_STATUS_UNSUPPORTED } .distinctUntilChanged() .collect { capabilityStatus = it } } }
Java
displayExecutor = ContextCompat.getMainExecutor(this); windowAreaController = new WindowAreaControllerCallbackAdapter(WindowAreaController.getOrCreate()); windowAreaController.addWindowAreaInfoListListener(displayExecutor, this); windowAreaController.addWindowAreaInfoListListener(displayExecutor, windowAreaInfos -> { for(WindowAreaInfo newInfo : windowAreaInfos){ if(newInfo.getType().equals(WindowAreaInfo.Type.TYPE_REAR_FACING)){ windowAreaInfo = newInfo; capabilityStatus = newInfo.getCapability(presentOperation).getStatus(); break; } } });
कोई कार्रवाई शुरू करने से पहले, उस सुविधा की उपलब्धता देखें:
Kotlin
when (capabilityStatus) { WindowAreaCapability.Status.WINDOW_AREA_STATUS_UNSUPPORTED -> { // The selected display mode is not supported on this device. } WindowAreaCapability.Status.WINDOW_AREA_STATUS_UNAVAILABLE -> { // The selected display mode is not available. } WindowAreaCapability.Status.WINDOW_AREA_STATUS_AVAILABLE -> { // The selected display mode is available and can be enabled. } WindowAreaCapability.Status.WINDOW_AREA_STATUS_ACTIVE -> { // The selected display mode is already active. } else -> { // The selected display mode status is unknown. } }
Java
if (capabilityStatus.equals(WindowAreaCapability.Status.WINDOW_AREA_STATUS_UNSUPPORTED)) { // The selected display mode is not supported on this device. } else if (capabilityStatus.equals(WindowAreaCapability.Status.WINDOW_AREA_STATUS_UNAVAILABLE)) { // The selected display mode is not available. } else if (capabilityStatus.equals(WindowAreaCapability.Status.WINDOW_AREA_STATUS_AVAILABLE)) { // The selected display mode is available and can be enabled. } else if (capabilityStatus.equals(WindowAreaCapability.Status.WINDOW_AREA_STATUS_ACTIVE)) { // The selected display mode is already active. } else { // The selected display mode status is unknown. }
ड्यूअल-स्क्रीन मोड
अगर सुविधा पहले से ही चालू है, तो यहां दिए गए उदाहरण में सेशन को बंद कर दिया जाएगा या
ऐसा नहीं है, तो presentContentOnWindowArea()
फ़ंक्शन को कॉल करता है:
Kotlin
fun toggleDualScreenMode() { if (windowAreaSession != null) { windowAreaSession?.close() } else { windowAreaInfo?.token?.let { token -> windowAreaController.presentContentOnWindowArea( token = token, activity = this, executor = displayExecutor, windowAreaPresentationSessionCallback = this ) } } }
Java
private void toggleDualScreenMode() { if(windowAreaSession != null) { windowAreaSession.close(); } else { Binder token = windowAreaInfo.getToken(); windowAreaController.presentContentOnWindowArea( token, this, displayExecutor, this); } }
ऐप्लिकेशन की मुख्य गतिविधि को
WindowAreaPresentationSessionCallback
आर्ग्युमेंट.
एपीआई, लिसनर वाले तरीके का इस्तेमाल करता है: जब कॉन्टेंट प्रज़ेंट करने का अनुरोध किया जाता है
फ़ोल्ड किए जा सकने वाले डिवाइस के दूसरे डिसप्ले से कनेक्ट करने पर, एक सेशन शुरू हो जाता है.
लिसनर के onSessionStarted()
तरीके से. इसे बंद करने पर
सेशन के लिए, आपको onSessionEnded()
तरीके में पुष्टि का मैसेज मिलता है.
लिसनर बनाने के लिए, WindowAreaPresentationSessionCallback
इंटरफ़ेस लागू करें:
Kotlin
class MainActivity : AppCompatActivity(), windowAreaPresentationSessionCallback
Java
public class MainActivity extends AppCompatActivity implements WindowAreaPresentationSessionCallback
सुनने वाले को onSessionStarted()
, onSessionEnded(),
लागू करनी होंगी
और onContainerVisibilityChanged()
तरीके. कॉलबैक के तरीकों से आपको सूचना मिलती है
आपको सेशन की स्थिति के बारे में बताना होगा. साथ ही, ऐप्लिकेशन को उसके मुताबिक अपडेट किया जा सकेगा.
onSessionStarted()
कॉलबैक को इस तौर पर WindowAreaSessionPresenter
मिलता है
एक तर्क दिया गया है. आर्ग्युमेंट वह कंटेनर होता है जिसकी मदद से, विंडो के किसी हिस्से को ऐक्सेस किया जा सकता है और कॉन्टेंट दिखाया जा सकता है. जब उपयोगकर्ता प्राइमरी ऐप्लिकेशन विंडो से बाहर निकलता है, तो सिस्टम प्रज़ेंटेशन को अपने-आप बंद कर सकता है. इसके अलावा, WindowAreaSessionPresenter#close()
को कॉल करके भी प्रज़ेंटेशन को बंद किया जा सकता है.
अन्य कॉलबैक के लिए, आसानी से किसी भी तरह की गड़बड़ी का पता लगाने के लिए, फ़ंक्शन बॉडी में जाकर देखें और स्टेटस को लॉग करें:
Kotlin
override fun onSessionStarted(session: WindowAreaSessionPresenter) { windowAreaSession = session val view = TextView(session.context) view.text = "Hello world!" session.setContentView(view) } override fun onSessionEnded(t: Throwable?) { if(t != null) { Log.e(logTag, "Something was broken: ${t.message}") } } override fun onContainerVisibilityChanged(isVisible: Boolean) { Log.d(logTag, "onContainerVisibilityChanged. isVisible = $isVisible") }
Java
@Override public void onSessionStarted(@NonNull WindowAreaSessionPresenter session) { windowAreaSession = session; TextView view = new TextView(session.getContext()); view.setText("Hello world, from the other screen!"); session.setContentView(view); } @Override public void onSessionEnded(@Nullable Throwable t) { if(t != null) { Log.e(logTag, "Something was broken: ${t.message}"); } } @Override public void onContainerVisibilityChanged(boolean isVisible) { Log.d(logTag, "onContainerVisibilityChanged. isVisible = " + isVisible); }
पूरे नेटवर्क पर एक जैसा अनुभव देने के लिए, Dual Screen के आधिकारिक आइकॉन का इस्तेमाल करें. इससे, उपयोगकर्ताओं को यह पता चलेगा कि ड्यूअल-स्क्रीन मोड को कैसे चालू या बंद किया जा सकता है.
काम करने वाला सैंपल देखने के लिए, DualScreenActivity.kt देखें.
रीयर डिसप्ले मोड
ड्यूअल-स्क्रीन मोड की तरह ही, नीचे दिया गया उदाहरण
toggleRearDisplayMode()
फ़ंक्शन सेशन को बंद कर देता है, अगर उसकी क्षमता
पहले से चालू है या किसी अन्य तरीके से transferActivityToWindowArea()
को कॉल करता है
फ़ंक्शन:
Kotlin
fun toggleRearDisplayMode() { if(capabilityStatus == WindowAreaCapability.Status.WINDOW_AREA_STATUS_ACTIVE) { if(windowAreaSession == null) { windowAreaSession = windowAreaInfo?.getActiveSession( operation ) } windowAreaSession?.close() } else { windowAreaInfo?.token?.let { token -> windowAreaController.transferActivityToWindowArea( token = token, activity = this, executor = displayExecutor, windowAreaSessionCallback = this ) } } }
Java
void toggleDualScreenMode() { if(capabilityStatus == WindowAreaCapability.Status.WINDOW_AREA_STATUS_ACTIVE) { if(windowAreaSession == null) { windowAreaSession = windowAreaInfo.getActiveSession( operation ) } windowAreaSession.close() } else { Binder token = windowAreaInfo.getToken(); windowAreaController.transferActivityToWindowArea(token, this, displayExecutor, this); } }
इस मामले में, दिखाई गई गतिविधि का इस्तेमाल WindowAreaSessionCallback
के तौर पर किया जाता है. इसे लागू करना आसान होता है, क्योंकि कॉलबैक को कोई ऐसा प्रज़ेंटर नहीं मिलता जिससे विंडो के किसी हिस्से पर कॉन्टेंट दिखाया जा सके. इसके बजाय, पूरी गतिविधि को किसी दूसरे हिस्से पर ट्रांसफ़र किया जाता है:
Kotlin
override fun onSessionStarted() { Log.d(logTag, "onSessionStarted") } override fun onSessionEnded(t: Throwable?) { if(t != null) { Log.e(logTag, "Something was broken: ${t.message}") } }
Java
@Override public void onSessionStarted(){ Log.d(logTag, "onSessionStarted"); } @Override public void onSessionEnded(@Nullable Throwable t) { if(t != null) { Log.e(logTag, "Something was broken: ${t.message}"); } }
पूरे नेटवर्क पर एक जैसा अनुभव देने के लिए, रियर कैमरा के आधिकारिक आइकॉन का इस्तेमाल करें. इससे, उपयोगकर्ताओं को यह पता चलेगा कि रियर डिसप्ले मोड को कैसे चालू या बंद किया जा सकता है.
अन्य संसाधन
- Jetpack WindowManager की मदद से, फ़ोल्ड किए जा सकने वाले डिवाइसों पर अपने कैमरा ऐप्लिकेशन को ऑप्टिमाइज़ करना कोडलैब
androidx.window.area
पैकेज की खास जानकारी- Jetpack WindowManager सैंपल कोड: