फ़ोन की तरह ही, ऑडियो ग्लास और डिसप्ले ग्लास पर कैमरे जैसे संवेदनशील हार्डवेयर को ऐक्सेस करने के लिए, उपयोगकर्ता की साफ़ तौर पर सहमति ज़रूरी है. इन्हें स्मार्ट ग्लास के लिए खास अनुमतियां माना जाता है. आपके ऐप्लिकेशन को रनटाइम के दौरान इनके लिए अनुरोध करना होगा. भले ही, फ़ोन पर पहले से ही ये अनुमतियां मौजूद हों.
अपने ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइल में अनुमतियों का एलान करना
अनुमतियों का अनुरोध करने से पहले, आपको <uses-permission> एलिमेंट का इस्तेमाल करके, अपने ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइल में उनका एलान करना होगा. यह एलान तब भी एक जैसा रहता है, जब अनुमति किसी फ़ोन या स्मार्ट ग्लास की सुविधा के लिए हो. हालांकि, आपको स्मार्ट ग्लास के हार्डवेयर या फ़ंक्शन के लिए, साफ़ तौर पर अनुरोध करना होगा.
<manifest ...>
<!-- Only declare permissions that your app actually needs. In this example,
we declare permissions for the camera. -->
<uses-permission android:name="android.permission.CAMERA"/>
<application ...>
...
</application>
</manifest>
स्मार्ट ग्लास की अनुमतियों का अनुरोध करने से पहले
अनुमति से जुड़े सिद्धांतों और वर्कफ़्लो की समीक्षा करें, ताकि यह पक्का किया जा सके कि उपयोगकर्ताओं को सबसे अच्छा अनुभव मिले. जैसे, यह देखना कि उपयोगकर्ता ने आपके ऐप्लिकेशन के लिए ज़रूरी रनटाइम की अनुमतियां पहले ही दे दी हैं या नहीं. साथ ही, यह देखना कि स्मार्ट ग्लास से जुड़ी अनुमतियों का अनुरोध करने से पहले, आपके ऐप्लिकेशन को उपयोगकर्ता को कोई वजह बतानी चाहिए या नहीं.
अनुमति से जुड़े अलग-अलग मामले
ऑडियो और डिसप्ले ग्लास पर खतरनाक रनटाइम अनुमतियों का अनुरोध करते समय, आपको अलग-अलग स्थितियों का सामना करना पड़ सकता है:
- प्रोजेक्ट की गई गतिविधि से रनटाइम की अनुमतियों का अनुरोध करना
- फ़ोन की किसी गतिविधि से रनटाइम की अनुमतियों का अनुरोध करना
हर स्थिति के बारे में ज़्यादा जानने के लिए, इस गाइड में दिए गए ये सेक्शन देखें.
प्रोजेक्ट की गई किसी गतिविधि से रनटाइम की अनुमतियों का अनुरोध करना
प्रोजेक्ट की गई किसी गतिविधि से, ऑडियो या डिसप्ले ग्लास के लिए रनटाइम की अनुमतियों का अनुरोध करने के लिए, ProjectedActivityCompat.requestPermissions तरीके का इस्तेमाल करें.
इस तरीके को कॉल करने से, ग्लास और होस्ट फ़ोन, दोनों पर एक साथ यूज़र फ़्लो ट्रिगर होता है.
- स्मार्ट ग्लास पर: सिस्टम, स्मार्ट ग्लास पर एक कंपैनियन ऐक्टिविटी खोलता है. इसमें उपयोगकर्ता को अनुमति के अनुरोध का जवाब देने के लिए, अपने फ़ोन को देखने का निर्देश दिया जाता है.
- फ़ोन पर: फ़ोन की स्क्रीन पर, Android सिस्टम की अनुमति वाला डायलॉग बॉक्स दिखता है. डायलॉग बॉक्स से साफ़ तौर पर पता चलता है कि उपयोगकर्ता, फ़ोन के बजाय स्मार्ट ग्लास को अनुमति दे रहा है. इसके बाद, उपयोगकर्ता अनुरोध को स्वीकार या अस्वीकार कर सकता है.
यहां दिए गए उदाहरण में, प्रोजेक्ट की गई गतिविधि से स्मार्ट ग्लास की अनुमतियों का अनुरोध करने का तरीका बताया गया है:
@RequiresApi(Build.VERSION_CODES.VANILLA_ICE_CREAM) private fun requestCameraPermission() { lifecycleScope.launch { try { ProjectedActivityCompat.requestPermissions( this@PermissionsFromProjectedActivity, arrayOf(Manifest.permission.CAMERA), // CAMERA_PERMISSION_REQUEST_CODE is a developer defined constant CAMERA_PERMISSION_REQUEST_CODE, ) } catch (e: IllegalStateException) { // Thrown when the projected system service can't be bound. Log.e(TAG, "Camera permission request failed: projected service unavailable.", e) } } }
कोड के बारे में अहम बातें
- स्टैंडर्ड
ActivityCompatतरीके के बजाय,ProjectedActivityCompat.requestPermissionsका इस्तेमाल करें. यह तरीका, होस्ट फ़ोन के बजाय ऑडियो और डिसप्ले ग्लास के लिए, रनटाइम की अनुमतियों को साफ़ तौर पर टारगेट करता है.
अनुमति के नतीजों को मैनेज करना
जब उपयोगकर्ता फ़ोन पर अनुमति वाले डायलॉग का जवाब देता है, तो उसका फ़ैसला onRequestPermissionsResult कॉलबैक को शुरू करके आपके ऐप्लिकेशन को भेज दिया जाता है.
सिस्टम, प्रोजेक्ट की गई कंपैनियन ऐक्टिविटी को अपने-आप बंद कर देता है. ऑडियो ग्लास पर, यह ऑडियो चेतावनी के खत्म होने के बाद होता है. डिसप्ले ग्लास पर, ऐसा तब होता है, जब उपयोगकर्ता अनुमति वाले सभी डायलॉग बॉक्स का जवाब दे देता है.
रिस्पॉन्स को मैनेज करने के लिए, अनुमति का अनुरोध शुरू करने वाले Activity इंस्टेंस में onRequestPermissionsResult() को बदलें.
यहां दिए गए कोड स्निपेट से पता चलता है कि कॉलबैक को कैसे मैनेज किया जाए और यह कैसे पुष्टि की जाए कि उपयोगकर्ता ने अनुरोध की गई अनुमतियां दी हैं या नहीं:
@RequiresApi(Build.VERSION_CODES.VANILLA_ICE_CREAM) override fun onRequestPermissionsResult( requestCode: Int, permissions: Array<String>, grantResults: IntArray, deviceId: Int, ) { super.onRequestPermissionsResult(requestCode, permissions, grantResults, deviceId) if (requestCode != CAMERA_PERMISSION_REQUEST_CODE) return val isCameraGranted = grantResults.getOrNull(permissions.indexOf(Manifest.permission.CAMERA)) == PackageManager.PERMISSION_GRANTED if (isCameraGranted) { initializeCameraFeatures() } else { onCameraPermissionDenied() } }
कोड के बारे में अहम बातें
onRequestPermissionsResultकॉलबैक के साथdeviceIdओवरलोड का इस्तेमाल करें. इससे यह पक्का किया जा सकेगा कि अनुमति की स्थिति, होस्ट फ़ोन के बजाय ऑडियो या डिसप्ले ग्लास जैसे खास कॉन्टेक्स्ट के साथ सही तरीके से मैप की गई है.- आपके ऐप्लिकेशन को अनुमति मिलने और न मिलने, दोनों ही स्थितियों को सही तरीके से मैनेज करना चाहिए.
फ़ोन की किसी गतिविधि में रनटाइम की अनुमतियों का अनुरोध करना
अगर आपका ऐप्लिकेशन किसी फ़ोन पर चल रहा है, लेकिन उसे ऑडियो या डिसप्ले ग्लास के लिए अनुमतियों की ज़रूरत है, तो डिवाइस के हिसाब से Activity#requestPermissions(permissions, requestCode,
deviceId) तरीके का इस्तेमाल करके अनुमतियों का अनुरोध करें. उदाहरण के लिए, किसी उपयोगकर्ता को वीडियो स्ट्रीम को स्मार्ट ग्लास के कैमरे पर स्विच करने की अनुमति देना, ताकि वह फ़र्स्ट-पर्सन पॉइंट ऑफ़ व्यू से वीडियो देख सके:
// Request the projected permission from phone activity requestPermissions( arrayOf(Manifest.permission.CAMERA), // REQUEST_CODE_GLASSES_CAMERA is a developer-defined constant REQUEST_CODE_GLASSES_CAMERA, projectedDeviceId )
कोड के बारे में अहम बातें
- ऑडियो और डिसप्ले ग्लास को टारगेट करने के लिए, उस प्रोजेक्टेड कॉन्टेक्स्ट से सही डिवाइस आईडी हासिल करें जिसे आपने
createProjectedDeviceContextका इस्तेमाल करके बनाया है. इस आईडी कोrequestPermissionsतरीके के कॉल के साथ पास करें.
अनुमति के नतीजों को मैनेज करना
जब उपयोगकर्ता फ़ोन पर अनुमति वाले डायलॉग का जवाब देता है, तो उसका फ़ैसला onRequestPermissionsResult कॉलबैक को शुरू करके आपके ऐप्लिकेशन को भेज दिया जाता है.
रिस्पॉन्स को मैनेज करने के लिए, अनुमति का अनुरोध करने वाले Activity इंस्टेंस में onRequestPermissionsResult को बदलें.
यहां दिए गए कोड स्निपेट से पता चलता है कि कॉलबैक को कैसे मैनेज किया जाए और यह कैसे पुष्टि की जाए कि उपयोगकर्ता ने अनुरोध की गई अनुमतियां दी हैं या नहीं:
@RequiresApi(Build.VERSION_CODES.VANILLA_ICE_CREAM) override fun onRequestPermissionsResult( requestCode: Int, permissions: Array<String>, grantResults: IntArray, deviceId: Int, ) { super.onRequestPermissionsResult(requestCode, permissions, grantResults, deviceId) if (requestCode != CAMERA_PERMISSION_REQUEST_CODE) return val isCameraGranted = grantResults.getOrNull(permissions.indexOf(Manifest.permission.CAMERA)) == PackageManager.PERMISSION_GRANTED if (isCameraGranted) { initializeCameraFeatures() } else { onCameraPermissionDenied() } }
कोड के बारे में अहम बातें
onRequestPermissionsResultकॉलबैक के साथdeviceIdओवरलोड का इस्तेमाल करें. इससे यह पक्का किया जा सकेगा कि अनुमति की स्थिति, होस्ट फ़ोन के बजाय ऑडियो या डिसप्ले ग्लास जैसे खास संदर्भ के साथ सही तरीके से मैप की गई हो.- आपके ऐप्लिकेशन को अनुमति मिलने और न मिलने, दोनों ही स्थितियों को सही तरीके से मैनेज करना चाहिए.