'जारी रखें' सुविधा, आपके लिए नए तरीके और क्लास उपलब्ध कराती है. इससे आपको यह बताने में मदद मिलती है कि आपका ऐप्लिकेशन इस सुविधा के साथ काम करता है. साथ ही, इससे आपको ज़रूरी डेटा उपलब्ध कराने में मदद मिलती है. इससे, आपको रिसीव करने वाले डिवाइस पर उपयोगकर्ता अनुभव को सही तरीके से फिर से शुरू करने में मदद मिलती है.
काम करने की अनुमति देता है
'जारी रखें' सुविधा (डिफ़ॉल्ट रूप से बंद) के लिए सहायता, हर गतिविधि के हिसाब से लागू की जानी चाहिए. इस सुविधा को चालू करने के लिए, setHandoffEnabled को कॉल करें. इससे मौजूदा गतिविधि को हैंडऑफ़ के लिए तैयार के तौर पर मार्क किया जा सकेगा. setHandoffEnabled(true, null) को कॉल करने के बाद, गतिविधि को किसी भी समय हैंडऑफ़ किया जा सकता है. इसलिए, इसे सिर्फ़ तब कॉल करें, जब गतिविधि हैंडऑफ़ के लिए तैयार हो.
यह देखने के लिए कि गतिविधि के लिए, 'जारी रखें' सुविधा चालू है या नहीं, isHandoffEnabled पर जाएं. अगर किसी गतिविधि में हैंडऑफ़ की सुविधा चालू है, तो उसे onHandoffActivityDataRequested को भी लागू करना होगा. इससे यह पक्का किया जा सकेगा कि वह शून्य के अलावा, कोई ऐसी वैल्यू दिखाए जो HandoffActivityData न हो. ऐसा इसलिए, क्योंकि कोई डिफ़ॉल्ट ऐक्शन और सेटिंग लागू नहीं की गई है.
class MyHandoffActivity : Activity() {
...
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// Do stuff
...
// Enable handoff
setHandoffEnabled(true, null)
}
// Override and implement onHandoffActivityDataRequested
override fun onHandoffActivityDataRequested(handoffRequestInfo: HandoffActivityDataRequestInfo) : HandoffActivityData {
// Create and return handoff data
}
}
HandoffActivityData ऑब्जेक्ट को किसी भी काम की अतिरिक्त जानकारी और फ़ॉलबैक यूआरआई के साथ कॉन्फ़िगर करें. इससे, Continue On को यह जानकारी मिलती है कि डेटा पाने वाले डिवाइस को हैंडऑफ़ कैसे करना है.
सिस्टम को इस डेटा की ज़रूरत दो स्थितियों में होती है:
- गतिविधि बैकग्राउंड में जा रही है और ज़रूरी डेटा सेव किया जाना चाहिए.
- गतिविधि फ़ोरग्राउंड में हो और हैंडऑफ़ का अनुरोध किया गया हो. आपके पास हैंडऑफ़ के अनुरोध की स्थिति देखने का विकल्प होता है.
स्टेटस देखें
HandoffActivityDataRequestInfo क्लास, किसी गतिविधि को हैंडऑफ़ करने के मौजूदा अनुरोध के बारे में जानकारी देती है. isActiveRequest का इस्तेमाल करके, यह तय करें कि अनुरोध फ़िलहाल चालू है या नहीं. अगर यह तरीका
- true, मौजूदा गतिविधि फ़ोरग्राउंड में है और उपयोगकर्ता ने दूसरे डिवाइस पर जारी रखने का अनुरोध किया है. हालांकि, अगर
- false, गतिविधि बंद हो गई है और बैकग्राउंड में है. हालांकि, उपयोगकर्ता आने वाले समय में हैंडऑफ़ का अनुरोध कर सकता है.
अगर आपको फ़ाइल भेजने वाले डिवाइस पर, उपयोगकर्ता को यह दिखाने के लिए यूज़र इंटरफ़ेस (यूआई) दिखाना है कि हैंडऑफ़ हो गया है या जारी है, तो किसी चालू अनुरोध के लिए isActiveRequest को देखा जा सकता है. हालांकि, इस कोड को onHandoffActivityDataRequested के हिस्से के तौर पर सिंक्रोनस तरीके से लागू न करें. इसके बजाय, किसी भी कोड को एसिंक्रोनस तरीके से चलाने के लिए सूची में डालें, ताकि हैंडऑफ़ को ब्लॉक या देर न हो.
// Override and implement onHandoffActivityDataRequested
override fun onHandoffActivityDataRequested(handoffRequestInfo: HandoffActivityDataRequestInfo) : HandoffActivityData {
// Check whether the handoff request is active
if (handoffRequestInfo.isActiveRequest()) {
// Asynchronously show UI to let users know a handoff is in progress
}
// Create and return handoff data
}
हैंडऑफ़ डेटा बनाना
'जारी रखें' सुविधा की मदद से हैंडऑफ़ के दौरान, ज़रूरी और काम का सारा डेटा पास हो, इसके लिए आपको HandoffActivityData ऑब्जेक्ट में डेटा शामिल करना होगा.
HandoffActivityData क्लास, किसी गतिविधि से जुड़े हैंडऑफ़ डेटा को दिखाती है. HandoffActivityData, Continue On को यह जानकारी देता है कि गतिविधि को पाने वाले डिवाइस पर, उसे कैसे मैनेज और फिर से शुरू करना है. हैंडऑफ़ डेटा में यह जानकारी शामिल होती है:
- कॉम्पोनेंट का नाम (ज़रूरी है): जिस डिवाइस पर टास्क को ट्रांसफ़र किया जा रहा है उस पर लॉन्च की जाने वाली गतिविधि का
ComponentName, ताकि टास्क ट्रांसफ़र होने के बाद उपयोगकर्ता अपना काम जारी रख सके. ज़्यादातर मामलों में और गतिविधि की सटीक डुप्लीकेट कॉपी बनाने के लिए, यहHandoffActivityDataबनाने वाली गतिविधि के कॉम्पोनेंट का नाम होगा. - Extras (ज़रूरी नहीं): ऐसी अतिरिक्त जानकारी दी जा सकती है जिसे गतिविधि की शुरुआत
Intentमें शामिल किया जाएगा. यह एकPersistableBundleहै. इसका इस्तेमाल, कॉम्पोनेंट को ज़्यादा जानकारी देने के लिए किया जा सकता है. अतिरिक्त फ़ाइलों का साइज़ 50 केबी से कम होना चाहिए.
HandoffActivityData ऑब्जेक्ट बनाने के लिए, बिल्डर क्लास HandoffActivityData.Builder का इस्तेमाल करें. हैंडऑफ़ पाने वाली गतिविधि का ComponentName पास करके, एक नया बिल्डर बनाएं. उदाहरण के लिए, मौजूदा Activity के लिए this.getComponentName या साफ़ तौर पर बताया गया ComponentName(this, TargetActivity::class.java). इसके बाद, ज़रूरत के हिसाब से अतिरिक्त जानकारी देने के लिए, setExtras तरीके का इस्तेमाल करें. आखिर में, HandoffActivityData ऑब्जेक्ट बनाने के लिए, build को कॉल करें.
// Override and implement onHandoffActivityDataRequested
override fun onHandoffActivityDataRequested(handoffRequestInfo: HandoffActivityDataRequestInfo) : HandoffActivityData {
// Check whether the handoff request is active
if (handoffRequestInfo.isActiveRequest()) {
// Asynchronously show UI to let users know a handoff is in progress
}
val extras: PersistableBundle = PersistableBundle()
// Put relevant and necessary values into extras (e.g. scroll position)
extras.putString("data_id", getDataId())
extras.putInt("scroll_position", getScrollPosition())
// Create and return handoff data
return HandoffActivityData.Builder(getComponentName()) // Designate handoff to the same activity
.setExtras(extras)
.build()
}
वेब फ़ॉलबैक विकल्प सेट करना
अगर रिसीव करने वाले डिवाइस पर, तय की गई गतिविधि शुरू नहीं की जा सकती, तो आपके पास setFallbackUri का इस्तेमाल करके, फ़ॉलबैक यूआरएल सेट करने का विकल्प भी होता है. यह यूआरएल, उपयोगकर्ता के डिफ़ॉल्ट ब्राउज़र में डिवाइस पर खोला जाता है.
जिन डिवाइसों पर आपका ऐप्लिकेशन इंस्टॉल नहीं है उन पर 'जारी रखें' सुविधा का सुझाव दिखाने के लिए, setHandoffEnabled को कॉल करते समय HandoffActivityParams इंस्टेंस को पास करें. साथ ही, setAllowHandoffWithoutPackageInstalled को true पर सेट करें:
setHandoffEnabled(
true,
HandoffActivityParams.Builder()
.setAllowHandoffWithoutPackageInstalled(true)
.build()
)
इसके बाद, अपने HandoffActivityData में फ़ॉलबैक यूआरएल शामिल करें:
val fallbackWebLink: Uri = Uri.parse("https://myapp.com/fallback?query=" + paramVal)
val handoffData: HandoffActivityData = HandoffActivityData.Builder(getComponentName())
.setExtras(extras)
.setFallbackUri(fallbackWebLink)
.build()
वेब पर सीधे तौर पर लागू करना
इसके अलावा, डायरेक्ट-टू-वेब हैंडऑफ़ को लागू करने के लिए, HandoffActivityParams को setAllowHandoffWithoutPackageInstalled(true) के साथ setHandoffEnabled पर पास करें. साथ ही, HandoffActivityData जनरेट करने के लिए, HandoffActivityData.createWebHandoff तरीके का इस्तेमाल करें:
val webHandoffLink: Uri = Uri.parse("https://myapp.com/handoff?query=" + paramVal)
val handoffData: HandoffActivityData = HandoffActivityData.createWebHandoff(webHandoffLink)
हैंडऑफ़ इंटेंट पाना और उसे मैनेज करना
डेटा पाने वाले डिवाइस पर, आपके ऐप्लिकेशन को हैंडऑफ़ को मैनेज करना होगा. साथ ही, डेटा भेजने वाले डिवाइस से उपयोगकर्ता के अनुभव को फिर से बनाना होगा. खास तौर पर, onHandoffActivityDataRequested से मिले HandoffActivityData में बताई गई गतिविधि में, आपको इंटेंट को मैनेज करना होगा. साथ ही, आपको ऐसी अतिरिक्त जानकारी हासिल करनी होगी जिसमें गतिविधि को सही तरीके से फिर से बनाने के बारे में जानकारी हो.
अगर आपने उसी गतिविधि को हैंडऑफ़ करने के लिए चुना है, तो आपको गतिविधि के onCreate तरीके में इंटेंट मिल सकता है. इससे डेटा को वापस पाया जा सकता है और उपयोगकर्ता के लिए, अपने-आप जानकारी भरी जा सकती है.
class MyHandoffActivity : Activity() {
...
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// Do stuff
...
// Get the launch intent and retrieve extras
val intent: Intent = getIntent()
if (intent != null && intent.hasExtra("data_id")) {
val dataID: String = intent.getStringExtra("data_id")
// Retrieve the data that corresponds to the data ID
...
// Populate activity UI with relevant data
...
if (intent.hasExtra("scroll_position")) {
val scrollPosition: Int = intent.getIntExtra("scroll_position", 0)
// Move the page to the scroll position
...
}
}
}
}