Android के लिए Maps SDK टूल का इस्तेमाल करके, मैप पर आधारित पहने जाने वाला ऐप्लिकेशन बनाया जा सकता है जो सीधे Wear OS by Google डिवाइसों पर काम करते हों. आपके ऐप्लिकेशन के उपयोगकर्ता सिर्फ़ उनकी कलाई पर नज़र डालकर अपनी जगह की जानकारी मैप पर देख सकते हैं. वे ये काम कर सकते हैं उदाहरण के लिए, किसी रास्ते पर अपनी जगह प्लॉट करें, फिर विवरण के लिए ज़ूम इन करें या मार्कर का इस्तेमाल करें.
इस पेज पर वियर डिवाइस के लिए उपलब्ध एपीआई की सुविधा के बारे में बताया गया है और आपको अपना ऐप्लिकेशन बनाना शुरू करने में मदद करता है.
Wear OS इस्तेमाल करना शुरू करें
Android के लिए Maps SDK टूल की मदद से, पहने जाने वाले ऐप्लिकेशन बनाना मूल रूप से किसी अन्य Android डिवाइस के लिए Google Maps ऐप्लिकेशन बनाने के समान है. अंतर, स्मार्टवॉच के छोटे फ़ॉर्म फ़ैक्टर के लिए आपके डिज़ाइन में है. इससे ऐप्लिकेशन के इस्तेमाल और परफ़ॉर्मेंस को ऑप्टिमाइज़ किया जा सकता है.
Wear OS ऐप्लिकेशन बनाने के लिए, Android Studio का सुझाव दिया जाता है. ऐसा इसलिए है, क्योंकि यह प्रोजेक्ट सेटअप करने, लाइब्रेरी शामिल करने, और पैकेजिंग करने में आसानी से मदद करता है.
स्मार्टवॉच के लिए ऐप्लिकेशन डिज़ाइन करने से जुड़ी सामान्य मदद पाने के लिए, Wear OS के डिज़ाइन से जुड़े दिशा-निर्देश देखें. पहने जाने वाले डिवाइस के लिए अपना पहला ऐप्लिकेशन बनाने में मदद पाने के लिए, पहने जाने वाले डिवाइसों के लिए ऐप्लिकेशन बनाने से जुड़ी गाइड देखें.
Wear OS पर अपना पहला मैप ऐप्लिकेशन बनाना
इस क्विक गाइड में यह माना गया है कि आपको Maps SDK for Android के बारे में पता है. साथ ही, आपने अपने ऐप्लिकेशन में पहने जा सकने वाले डिवाइस के लिए मॉड्यूल बनाने के लिए, Wear OS की गाइड का पालन किया है. अब आपको पहने जा सकने वाले डिवाइस के मॉड्यूल में मैप जोड़ना है.
Wear मॉड्यूल के लिए डिपेंडेंसी जोड़ना
पक्का करें कि आपके ऐप्लिकेशन के Wear OS मॉड्यूल की build.gradle.kts फ़ाइल में ये डिपेंडेंसी शामिल हों:
dependencies { // ... compileOnly("com.google.android.wearable:wearable:2.9.0") implementation("com.google.android.support:wearable:2.9.0") implementation("com.google.android.gms:play-services-maps:19.0.0") // This dependency is necessary for ambient mode implementation("androidx.wear:wear:1.3.0") }
डिपेंडेंसी के बारे में ज़्यादा जानकारी के लिए, आपके मौजूदा प्रोजेक्ट में Wear OS मॉड्यूल.
स्वाइप करके हटाने की सुविधा लागू करना और बैकग्राउंड का शुरुआती रंग सेट करना
हमारा सुझाव है कि स्मार्टवॉच पर मैप दिखाने के लिए, SwipeDismissFrameLayout का इस्तेमाल करें. SwipeDismissFrameLayout क्लास का इस्तेमाल करके, ये काम किए जा सकते हैं
स्वाइप-टू-डिमिस जेस्चर लागू करके उपयोगकर्ताओं को
स्क्रीन के सबसे बाएं किनारे से स्वाइप करके ऐप से बाहर निकलने का तरीका.
बैकग्राउंड के लिए अपनी पसंद का शुरुआती रंग सेट करने के लिए, map:backgroundColor एक्सएमएल का इस्तेमाल करें
विशेषता का इस्तेमाल करें.
अपने लेआउट में SwipeDismissFrameLayout और backgroundColor एलिमेंट जोड़ें
SupportMapFragment के कंटेनर के तौर पर परिभाषा:
<androidx.wear.widget.SwipeDismissFrameLayout
android:id="@+id/map_container"
android:layout_width="match_parent"
android:layout_height="match_parent">
<fragment
android:id="@+id/map"
android:name="com.google.android.gms.maps.SupportMapFragment"
android:layout_width="match_parent"
android:layout_height="match_parent"
map:backgroundColor="#fff0b2dd" />
</androidx.wear.widget.SwipeDismissFrameLayout>जब आपको अपनी गतिविधि में SwipeDismissFrameLayout ऑब्जेक्ट मिल जाए, तो
कॉलबैक करें और ज़रूरी खारिज करने के लिए कॉलबैक का व्यवहार सेट करें
कार्रवाई करें, जैसा कि नीचे दिखाया गया है:
Kotlin
class MainActivity : AppCompatActivity(), OnMapReadyCallback, AmbientModeSupport.AmbientCallbackProvider { public override fun onCreate(savedState: Bundle?) { super.onCreate(savedState) // Set the layout. It only contains a SupportMapFragment and a DismissOverlay. setContentView(R.layout.activity_main) // Enable ambient support, so the map remains visible in simplified, low-color display // when the user is no longer actively using the app but the app is still visible on the // watch face. val controller = AmbientModeSupport.attach(this) Log.d(MainActivity::class.java.simpleName, "Is ambient enabled: " + controller.isAmbient) // Retrieve the containers for the root of the layout and the map. Margins will need to be // set on them to account for the system window insets. val mapFrameLayout = findViewById<SwipeDismissFrameLayout>(R.id.map_container) mapFrameLayout.addCallback(object : SwipeDismissFrameLayout.Callback() { override fun onDismissed(layout: SwipeDismissFrameLayout) { onBackPressed() } }) // Obtain the MapFragment and set the async listener to be notified when the map is ready. mapFragment = supportFragmentManager .findFragmentById(R.id.map) as SupportMapFragment mapFragment.getMapAsync(this) } // ... }
Java
public class MainActivity extends AppCompatActivity implements OnMapReadyCallback, AmbientModeSupport.AmbientCallbackProvider { public void onCreate(Bundle savedState) { super.onCreate(savedState); // Set the layout. It only contains a SupportMapFragment and a DismissOverlay. setContentView(R.layout.activity_main); // Enable ambient support, so the map remains visible in simplified, low-color display // when the user is no longer actively using the app but the app is still visible on the // watch face. AmbientModeSupport.AmbientController controller = AmbientModeSupport.attach(this); Log.d(MainActivity.class.getSimpleName(), "Is ambient enabled: " + controller.isAmbient()); // Retrieve the containers for the root of the layout and the map. Margins will need to be // set on them to account for the system window insets. final SwipeDismissFrameLayout mapFrameLayout = (SwipeDismissFrameLayout) findViewById( R.id.map_container); mapFrameLayout.addCallback(new SwipeDismissFrameLayout.Callback() { @Override public void onDismissed(SwipeDismissFrameLayout layout) { onBackPressed(); } }); // Obtain the MapFragment and set the async listener to be notified when the map is ready. mapFragment = (SupportMapFragment) getSupportFragmentManager() .findFragmentById(R.id.map); mapFragment.getMapAsync(this); } // ... }
मैप जोड़ना
हमेशा की तरह, onMapReady(GoogleMap) कॉलबैक का तरीका इस्तेमाल करें,
GoogleMap ऑब्जेक्ट का हैंडल पाने के लिए. कॉलबैक है
यह तब ट्रिगर होगा, जब मैप उपयोग के लिए तैयार हो. कॉलबैक वाले तरीके में, ये काम किए जा सकते हैं
मैप पर मार्कर या पॉलीलाइन जोड़ें, लिसनर जोड़ें या कैमरे को मूव करें. यहां दिए गए उदाहरण में, सिडनी ओपेरा हाउस के पास एक मार्कर जोड़ा गया है:
Kotlin
private val sydney = LatLng(-33.85704, 151.21522) override fun onMapReady(googleMap: GoogleMap) { // Add a marker with a title that is shown in its info window. googleMap.addMarker( MarkerOptions().position(sydney) .title("Sydney Opera House") ) // Move the camera to show the marker. googleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(sydney, 10f)) }
Java
private static final LatLng SYDNEY = new LatLng(-33.85704, 151.21522); @Override public void onMapReady(@NonNull GoogleMap googleMap) { // Add a marker with a title that is shown in its info window. googleMap.addMarker(new MarkerOptions().position(SYDNEY) .title("Sydney Opera House")); // Move the camera to show the marker. googleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(SYDNEY, 10)); }
ऐंबियंट मोड चालू करना
Android के लिए Maps SDK टूल, पहने जाने वाले डिवाइसों पर काम करने वाले ऐप्लिकेशन के लिए, ऐंबियंट मोड की सुविधा के साथ काम करता है. ऐंबियंट मोड के साथ काम करने वाले ऐप्लिकेशन, कभी-कभी हमेशा चालू रहने वाले ऐप्लिकेशन कहलाते हैं. ऐंबियंट मोड तब चालू हो जाता है, जब उपयोगकर्ता फ़िलहाल ऐप्लिकेशन का इस्तेमाल नहीं कर रहा होता है, साथ ही, पहने जाने वाले डिवाइस पर ऐप्लिकेशन दिखता रहता है.
Android के लिए Maps SDK टूल, ऐंबियंट मोड में इस्तेमाल करने के लिए, मैप को कम रंगों में और आसानी से रेंडर करता है. साथ ही, डिवाइस के इंटरैक्टिव मोड से ऐंबियंट मोड पर स्विच करने पर, मैप का स्टाइल अपने-आप अडजस्ट हो जाता है. सभी मार्कर, ऑब्जेक्ट, और यूज़र इंटरफ़ेस (यूआई) ऐंबियंट मोड में कंट्रोल गायब हो जाते हैं. इससे आपके ऐप्लिकेशन की बिजली की खपत कम होती है. साथ ही, यह पक्का होता है कि ऐंबियंट डिसप्ले वाले दूसरे ऐप्लिकेशन, जैसे कि स्मार्टवॉच की होम स्क्रीन एक जैसी दिखें.
यह पक्का करने के लिए कि आपका ऐप्लिकेशन, मैप के ऐंबियंट मोड का इस्तेमाल करता है, यह तरीका अपनाएं:
- अपने Android SDK टूल को अपडेट करें, ताकि Android 6.0 (एपीआई 23) या उसके बाद के वर्शन वाले प्लैटफ़ॉर्म को शामिल किया जा सके. इस वर्शन में ऐसे एपीआई उपलब्ध होते हैं जिनकी मदद से गतिविधियों को ऐंबियंट मोड में चलाया जा सकता है. SDK टूल को अपडेट करने के बारे में जानने के लिए, Android का दस्तावेज़ देखें SDK टूल के पैकेज जोड़ने के बारे में जानकारी.
- अपनी प्रोजेक्ट रिपोर्ट में,
ऐप्लिकेशन मेनिफ़ेस्ट में
targetSdkVersionसे 23 या उससे ज़्यादा. - अपने ऐप्लिकेशन की
build.gradle.ktsफ़ाइल में, पहने जाने वाले डिवाइस डिपेंडेंसी जोड़ें. इस पेज पर सैंपल देखें. - पहने जाने वाले डिवाइस की शेयर की गई लाइब्रेरी की एंट्री को, पहने जाने वाले ऐप्लिकेशन मेनिफ़ेस्ट में इस तरह जोड़ें Android ट्रेनिंग क्लास में बताई गई ऐप्लिकेशन को लोगों तक पहुंचाने के लिए.
- अपने ऐप्लिकेशन को दिखते रहने के बारे में Android ट्रेनिंग क्लास में बताए गए तरीके के मुताबिक,
WAKE_LOCKअनुमति को हैंडहेल्ड और पहने जाने वाले डिवाइसों के ऐप्लिकेशन मेनिफ़ेस्ट में जोड़ें. - अपनी गतिविधि के
onCreate()तरीके में,AmbientModeSupport.attach()तरीका कॉल करें. इससे ऑपरेटिंग सिस्टम को पता चलता है कि ऐप्लिकेशन हमेशा चालू रहता है. इससे, डिवाइस के बंद होने पर, स्मार्टवॉच की होम स्क्रीन पर वापस जाने के बजाय, ऐंबियंट मोड चालू हो जाता है. - अपनी गतिविधि में
AmbientModeSupport.AmbientCallbackProviderइंटरफ़ेस लागू करें, ताकि ऐंबियंट मोड की स्थिति में हुए बदलावों की जानकारी मिल सके. - अपने मैप को आस-पास की आवाज़ सुनाने वाले मोड के साथ काम करने के लिए सेट करें. ऐसा करने के लिए,
गतिविधि की एक्सएमएल लेआउट फ़ाइल में एट्रिब्यूट
map:ambientEnabled="true", या यह करेंGoogleMapOptions.ambientEnabled(true)को सेट करके, इसे प्रोग्राम के हिसाब से अपने-आप किया जाता है. यह सेटिंग, एपीआई को बताती है कि उसे आस-पास की आवाज़ सुनाने वाले मोड में इस्तेमाल करें. - जब गतिविधि को ऐंबियंट मोड में स्विच किया जाता है, तो सिस्टम
AmbientCallbackमें आपनेonEnterAmbient()तरीका चुना है उपलब्ध कराएँ.onEnterAmbient()को बदलें औरSupportMapFragment.onEnterAmbient(ambientDetails)याMapView.onEnterAmbient(ambientDetails)को कॉल करें. यह एपीआई, मैप की नॉन-इंटरैक्टिव और कम रंगों वाली रेंडरिंग. - इसी तरह,
onExitAmbient()में कॉल करने के लिए,SupportMapFragment.onExitAmbient()याMapView.onExitAmbient()को चुनें. एपीआई, मैप के सामान्य रेंडरिंग पर स्विच कर देता है.
यहां दिया गया कोड सैंपल, गतिविधि में ऐंबियंट मोड चालू करता है:
Kotlin
class AmbientActivity : AppCompatActivity(), AmbientModeSupport.AmbientCallbackProvider { private lateinit var mapFragment: SupportMapFragment public override fun onCreate(savedState: Bundle?) { super.onCreate(savedState) // Set the layout. It only contains a SupportMapFragment and a DismissOverlay. setContentView(R.layout.activity_main) // Enable ambient support, so the map remains visible in simplified, low-color display // when the user is no longer actively using the app but the app is still visible on the // watch face. val controller = AmbientModeSupport.attach(this) Log.d(AmbientActivity::class.java.simpleName, "Is ambient enabled: " + controller.isAmbient) // Obtain the MapFragment and set the async listener to be notified when the map is ready. mapFragment = supportFragmentManager .findFragmentById(R.id.map) as SupportMapFragment } override fun getAmbientCallback(): AmbientModeSupport.AmbientCallback { return object : AmbientModeSupport.AmbientCallback() { /** * Starts ambient mode on the map. * The API swaps to a non-interactive and low-color rendering of the map when the user is no * longer actively using the app. */ override fun onEnterAmbient(ambientDetails: Bundle) { super.onEnterAmbient(ambientDetails) mapFragment.onEnterAmbient(ambientDetails) } /** * Exits ambient mode on the map. * The API swaps to the normal rendering of the map when the user starts actively using the app. */ override fun onExitAmbient() { super.onExitAmbient() mapFragment.onExitAmbient() } } } }
Java
public class AmbientActivity extends AppCompatActivity implements AmbientModeSupport.AmbientCallbackProvider { private SupportMapFragment mapFragment; public void onCreate(Bundle savedState) { super.onCreate(savedState); // Set the layout. It only contains a SupportMapFragment and a DismissOverlay. setContentView(R.layout.activity_main); // Enable ambient support, so the map remains visible in simplified, low-color display // when the user is no longer actively using the app but the app is still visible on the // watch face. AmbientModeSupport.AmbientController controller = AmbientModeSupport.attach(this); Log.d(AmbientActivity.class.getSimpleName(), "Is ambient enabled: " + controller.isAmbient()); // Obtain the MapFragment and set the async listener to be notified when the map is ready. mapFragment = (SupportMapFragment) getSupportFragmentManager() .findFragmentById(R.id.map); } @Override public AmbientCallback getAmbientCallback() { return new AmbientCallback() { /** * Starts ambient mode on the map. * The API swaps to a non-interactive and low-color rendering of the map when the user is no * longer actively using the app. */ @Override public void onEnterAmbient(Bundle ambientDetails) { super.onEnterAmbient(ambientDetails); mapFragment.onEnterAmbient(ambientDetails); } /** * Exits ambient mode on the map. * The API swaps to the normal rendering of the map when the user starts actively using the app. */ @Override public void onExitAmbient() { super.onExitAmbient(); mapFragment.onExitAmbient(); } }; } }
ऐप्लिकेशन के ऐंबियंट मोड में होने पर भी, स्क्रीन को अपडेट किया जा सकता है. कॉन्टेंट अपडेट करने और ऐंबियंट मोड के बारे में ज़्यादा जानने के लिए, अपने ऐप्लिकेशन को ऐंबियंट मोड में दिखाने के बारे में Android ट्रेनिंग क्लास देखें.
Wear OS पर Street View का इस्तेमाल करना
Street View, पहने जाने वाले डिवाइसों पर पूरी तरह से काम करता है.
Street View पैनोरामा देखते समय, उपयोगकर्ताओं को ऐप्लिकेशन से बाहर निकलने की अनुमति देने के लिए,
StreetViewPanorama.OnStreetViewPanoramaLongClickListener
देर तक क्लिक करने के जेस्चर को सुनने के लिए इंटरफ़ेस. जब कोई उपयोगकर्ता, Street View इमेज पर कहीं पर लंबे समय तक क्लिक करता है, तो आपको एक onStreetViewPanoramaLongClick(StreetViewPanoramaOrientation) इवेंट मिलेगा. कॉल करें
'बाहर निकलें' बटन दिखाने के लिए DismissOverlayView.show().
नमूना कोड
GitHub पर एक सैंपल ऐप्लिकेशन उपलब्ध है. इसका इस्तेमाल, अपने ऐप्लिकेशन के लिए शुरुआती बिंदु के तौर पर किया जा सकता है. इस सैंपल में, Wear OS पर Google Maps का बुनियादी वर्शन सेट अप करने का तरीका बताया गया है.
Wear OS पर Maps API के साथ काम करने वाली सुविधाएं
यह सेक्शन, Maps पर काम करने वाले फ़ंक्शन में अंतर के बारे में बताता है हैंडहेल्ड डिवाइसों (फ़ोन और टैबलेट) की तुलना में पहने जाने वाले डिवाइस. यहां बताई गई एपीआई की सभी सुविधाएं, एपीआई के पूरे दस्तावेज़ में बताए गए तरीके से काम करनी चाहिए.
| फ़ंक्शन | |
|---|---|
| पूरी तरह से इंटरैक्टिव मोड और लाइट मोड | Android के लिए Maps SDK टूल का इस्तेमाल पूरी तरह से इंटरैक्टिव मोड में किया जा सकता है या लाइट मोड में होना चाहिए. परफ़ॉर्मेंस को ऑप्टिमाइज़ करने के लिए, लाइट मोड का इस्तेमाल करें पहने जाने वाले डिवाइस और आपके ऐप्लिकेशन को जेस्चर, यानी मैप को पैन और ज़ूम करने जैसे इंटरैक्शन. लाइट मोड में, जब उपयोगकर्ता मैप पर टैप करता है, तो Google Maps मोबाइल ऐप्लिकेशन को शुरू करने का इंटेंट बंद होता है. साथ ही, इसे स्मार्टवॉच पर चालू नहीं किया जा सकता. लाइट मोड और पूरी तरह इंटरैक्टिव मोड के बीच के अंतर की पूरी सूची के लिए, लाइट मोड के दस्तावेज़ देखें. |
| मैप टूलबार | map टूलबार बंद है और इसे पहने जाने वाला डिवाइस. |
| यूज़र इंटरफ़ेस (यूआई) कंट्रोल | पहने जा सकने वाले डिवाइसों पर, यूज़र इंटरफ़ेस (यूआई)
कंट्रोल डिफ़ॉल्ट रूप से बंद रहते हैं. इसमें ये कंट्रोल शामिल हैं:
ज़ूम, कंपास, और मेरी जगह की जानकारी. इन्हें चालू करने के लिए इनका इस्तेमाल करें:
UiSettings
सामान्य रूप से क्लास में शामिल होते हैं.
|
| हाथ के जेस्चर | सिंगल-टच हाथ के जेस्चर उम्मीद के मुताबिक काम करते हैं. उदाहरण के लिए, मैप को पैन करने के लिए उसे छूकर खींचें और छोड़ें, ज़ूम इन करने के लिए दो बार टैप करें, और ज़ूम आउट करने के लिए दो उंगलियों से टैप करें. उपयोगकर्ता के डिवाइस के हिसाब से, मल्टी-टच जेस्चर की सुविधा अलग-अलग डिवाइसों पर काम करती है. मल्टी-टच जेस्चर के उदाहरणों में मैप को झुकाने के लिए दो उंगलियों से पुश करना, ज़ूम करने और दो उंगलियों से घुमाने के लिए पिंच करना. |
| इनडोर मैप और इमारतें |
स्मार्टवॉच पर, इनडोर मैप की सुविधा डिफ़ॉल्ट रूप से बंद होती है. इन्हें चालू करने के लिए,
GoogleMap.setIndoorEnabled(true) को कॉल करें. अगर इनडोर मैप
चालू करने पर, मैप में डिफ़ॉल्ट फ़्लोर लेवल दिखेगा.
लेवल
पिकर यूज़र इंटरफ़ेस (यूआई) एलिमेंट, पहने जाने वाले डिवाइसों पर काम नहीं करता. |
| टाइल ओवरले | स्मार्टवॉच पर, टाइल ओवरले का इस्तेमाल नहीं किया जा सकता. |
Wear OS पर Maps API का इस्तेमाल करके ऐप्लिकेशन डेवलप करने के सबसे सही तरीके
अपने ऐप्लिकेशन में सबसे अच्छा उपयोगकर्ता अनुभव देने का तरीका:
- मैप, स्क्रीन के बड़े हिस्से में दिखना चाहिए. यह ज़रूरी है, ताकि पहने जा सकने वाले डिवाइस के छोटे फ़ॉर्म फ़ैक्टर पर, मैप को इस्तेमाल करने की सुविधा को ऑप्टिमाइज़ किया जा सके.
- अपने ऐप्लिकेशन का उपयोगकर्ता अनुभव डिज़ाइन करते समय, इस बात का ध्यान रखें यह जानकारी कि पहने जाने वाले डिवाइस में कम बैटरी पावर है. स्क्रीन को चालू रखना और मैप को दिखने से बैटरी की परफ़ॉर्मेंस पर असर पड़ेगा.