सबसे अच्छे तरीके

इस दस्तावेज़ में, डिज़ाइन और जानकारी डिलीवर करने के कुछ सबसे सही तरीकों के बारे में बताया गया है. बेहतरीन उपयोगकर्ता अनुभव पाने के लिए, लागू होने पर इन दिशा-निर्देशों का पालन करें.

पहले डिज़ाइन करें, फिर कोड डालें

Glass पर डेवलप करने से पहले डिज़ाइन के सिद्धांतों और पैटर्न के बारे में जानें. ज़्यादा जानकारी के लिए, डिज़ाइन गाइड पढ़ें.

शुरुआती डिज़ाइन के बारे में सुझाव, राय या शिकायत पाने के लिए, अपना ग्लासवेयर फ़्लो डिज़ाइन बनाएं और इसे समीक्षा टीम को सबमिट करें.

पिन किए गए टाइमलाइन आइटम को लॉन्चर के तौर पर इस्तेमाल न करें

उपयोगकर्ताओं के लिए ग्लासवेयर और इसकी सुविधाओं को शुरू करने के दो मुख्य तरीके हैं. इसके लिए, ok Glass के मुख्य मेन्यू में बोलकर या टाइमलाइन कार्ड के संदर्भ मेन्यू से बोलकर या टच कमांड का इस्तेमाल किया जा सकता है.

आपको ग्लासवेयर लॉन्च करने के लिए, उपयोगकर्ताओं को मेन्यू आइटम वाले टाइमलाइन कार्ड को पिन करने के लिए कभी ज़बरदस्ती नहीं करनी चाहिए. मिरर एपीआई को समय-समय पर मिलने वाली सूचनाओं के लिए बनाया गया है. यह उपयोगकर्ताओं की कॉन्फ़िगर की गई सेटिंग के आधार पर तय होता है.

GDK ग्लासवेयर लॉन्च करने या मिरर एपीआई को कॉल करने के लिए, मेन्यू आइटम देना तब तक ठीक है, जब तक अनुभव समय-समय पर मिलने वाली सूचनाओं के डिज़ाइन पैटर्न से मेल खाता हो. साथ ही, तुरंत इंटरैक्ट करने के लिए मिरर एपीआई का इस्तेमाल नहीं किया जाना चाहिए.

उदाहरण के लिए, पालतू जानवरों को गोद लेने वाले ग्लासवेयर में टाइमलाइन कार्ड नहीं डालना चाहिए और उपयोगकर्ताओं को बाद में सुविधाओं को ऐक्सेस करने के लिए पिन करने के लिए कहना चाहिए (उदाहरण के लिए, "कुत्तों को खोजें", "बिल्लियों को खोजें", "पक्षियों को खोजें" वगैरह). इसके बजाय, ग्लासवेयर से उपयोगकर्ता अपने पसंदीदा पालतू जानवरों के लिए ज़रूरी शर्तें सेट कर सकते हैं और समय-समय पर ऐसे कार्ड डिलीवर कर सकते हैं जो इन शर्तों को पूरा करते हों. इन कार्ड में "जानकारी पढ़ें" और "पालतू जानवरों को गोद लें" जैसी कार्रवाइयां करने के लिए, मेन्यू आइटम शामिल हो सकते हैं.

स्टैंडर्ड कार्ड डिज़ाइन और टेंप्लेट फ़ॉलो करें

जब हो सके, तब ऐसे कार्ड के डिज़ाइन और टेंप्लेट इस्तेमाल करें जिन्हें मंज़ूरी मिली हो. अगर टेंप्लेट काम नहीं करते हैं, तो:

• अगर मिरर एपीआई का इस्तेमाल किया जा रहा है, तो base_style.css में स्टाइल का इस्तेमाल करें.
• पहले से मौजूद टेंप्लेट के तौर पर पैडिंग (जगह) और स्पेसिंग के लिए, सामान्य नियमों का पालन करें.

मीडिया से जुड़ी ज़रूरी शर्तों को पूरा करें

मीडिया शेयर करते समय, इन दिशा-निर्देशों का पालन करें:

• सभी सार्वजनिक वीडियो स्ट्रीम किए जाते हैं और टाइमलाइन आइटम के साथ अटैच नहीं होते.
• वीडियो का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) 16:9 है.
• वीडियो का रिज़ॉल्यूशन 640 × 360 पिक्सल है.
• H.264 फ़ॉर्मैट

बंडल करें और पेज पर नंबर डालें

बंडल और पेज पर नंबर डालकर, कार्ड को एक साथ ग्रुप किया जा सकता है. हालांकि, आपको नीचे दी गई स्थितियों में उनका सही तरीके से इस्तेमाल करना चाहिए.

Bundles

• कार्ड के ऐसे ग्रुप के लिए बंडल का इस्तेमाल करें जो एक जैसे हैं, लेकिन एक ही कार्ड पर नहीं होने चाहिए.
• बंडल के कवर वाले कार्ड ऐसे डाइजेस्ट के तौर पर डिज़ाइन करें जो बंडल में मौजूद कार्ड से अलग दिखते हों.
• हर बंडल के लिए, सूचना की आवाज़ के साथ उपयोगकर्ता को सिर्फ़ एक बार सूचना दें.

ऐसे मामले जहां बंडल अच्छे काम करते हैं:

• ईमेल या छोटे मैसेज का थ्रेड
• एक ही व्यक्ति के बीच तीन मैसेज (एसएमएस)
• एक-दूसरे की एक घंटे के भीतर ली गईं पांच फ़ोटो
• मिलते-जुलते लेख, सभी को एक साथ शामिल कर दिए गए हैं
• खेल-कूद के किसी चल रहे गेम के मुख्य इवेंट और स्कोर के अपडेट की सूची

ऐसे मामले जहां बंडल ठीक से काम नहीं करते हैं:

• आपकी सेवा से मिली सभी सामग्री
• एक दिन में Glass को कई मुख्य समाचार भेजे गए

खोज नतीजों को पेजों में बांटना

उन टाइमलाइन आइटम के लिए पेज पर नंबर डालें जो जगह की कमी की वजह से एक कार्ड पर फ़िट नहीं होते. हालांकि, बाकी आइटम एक ही कार्ड पर होने चाहिए.

ऐसे मामले जहां पेज नंबर सही तरीके से काम करते हैं:

• कोई ईमेल, खबर या मिलता-जुलता कॉन्टेंट, जो एक कार्ड में फ़िट नहीं होता

ऐसे मामले जहां पेज नंबर सही से काम नहीं करता:

• अलग-अलग तरह के कार्ड का ग्रुप, जैसे कि एक से ज़्यादा खबरें या ईमेल

मेन्यू के स्टैंडर्ड डिज़ाइन को फ़ॉलो करें

कस्टम मेन्यू आइटम

• मेन्यू आइटम से जुड़ी हर कार्रवाई का आइकॉन 50 × 50 का होना चाहिए. Glass यूज़र इंटरफ़ेस (यूआई) से एक जैसा बने रहने के लिए ग्लास मेन्यू आइकॉन का इस्तेमाल करें.
• अगर हो सके, तो डिसप्ले नेम को कुछ शब्दों तक सीमित रखें. किसी ऑब्जेक्ट के साथ या उसके बिना, इंपेरेटिव वर्ब का इस्तेमाल करें.
• पहले से मौजूद मेन्यू आइटम के लिए डिफ़ॉल्ट आइकॉन और डिसप्ले नेम का इस्तेमाल करें. ऐसा तब तक करें, जब तक कि आप मेन्यू आइटम का इस्तेमाल किसी बहुत अलग चीज़ के लिए न कर रहे हों.
• आइकॉन पूरी तरह सफ़ेद रंग के हैं और उनका बैकग्राउंड पारदर्शी है.
• मेन्यू के छोटे और कार्रवाई करने लायक डिसप्ले नेम का इस्तेमाल करें. ऑब्जेक्ट के साथ या उसके बिना, इंपेरेटिव वर्ब (इंसिडेंटल) क्रिया बहुत अच्छी तरह काम करती हैं, जैसा कि इन उदाहरणों में बताया गया है.
• "खारिज करें" मेन्यू आइटम टाइमलाइन कार्ड को सिर्फ़ टाइमलाइन से हटाएं, इसलिए इसके लिए कस्टम मेन्यू आइटम बनाएं, अगर आपको इसकी ज़रूरत हो. आम तौर पर, आपको समय के साथ टाइमलाइन आइटम को अपने-आप खराब होने देना चाहिए. साथ ही, उपयोगकर्ताओं को आपके ऐप्लिकेशन को बेहतर तरीके से मैनेज करने की ज़रूरत नहीं पड़नी चाहिए.
• नाम को 15 या उससे कम वर्णों का रखें. उदाहरण के लिए:

खराब	पसंद आया
रिकॉर्डिंग का दायरा बढ़ाएं	वीडियो की अवधि बढ़ाएं
राम को मैसेज भेजो	मैसेज भेजें

पहले से मौजूद मेन्यू आइटम

• सभी को जवाब दें या सभी को जवाब दें - बोलकर दिए जाने वाले जवाबों का मकसद, बोलकर दिए जाने वाले जवाब की सुविधा देना है. विकल्पों के सीमित सेट को कैप्चर करने के लिए, बोलकर जवाब देने की सुविधा का इस्तेमाल न करें. जैसे, गेम में संभावित मूव.

• मिटाएं - टाइमलाइन कार्ड को खारिज कर देता है और टाइमलाइन कार्ड से संबंधित कॉन्टेंट को हर जगह सेव करता है (लोकल और सर्वर स्टोरेज). अगर आपकी दी जाने वाली सुविधा "खारिज करें" है, तो "मिटाएं" मेन्यू आइटम ऑफ़र करके लोगों को भ्रम में न डालें.

तुरंत इंटरैक्ट करने के लिए, Mirror API का इस्तेमाल न करें

Mirror API को उपयोगकर्ताओं के अनुरोध पाने और रीयल-टाइम में जवाब देने के लिए या इंतज़ार के समय को कम करने के लिए नहीं बनाया गया है. अगर ऐसा करना ज़रूरी है, तो GDK का इस्तेमाल करें.

उदाहरण के लिए, Mirror API ग्लासवेयर "नोट लें" कमांड के साथ अच्छे से काम करता है, क्योंकि उपयोगकर्ताओं को कमांड चालू करने के बाद, ग्लासवेयर के जवाब का इंतज़ार नहीं करना पड़ता.

इसके उलट, "Find a एसडीके, स्पैगेटी", Mirror API ग्लासवेयर के साथ ठीक से काम नहीं करता. ऐसा इसलिए, क्योंकि उपयोगकर्ता उम्मीद करते हैं कि खोज के नतीजे तुरंत दिखें. Mirror API के साथ, उपयोगकर्ताओं को ग्लासवेयर का इस्तेमाल जारी रखने के लिए टाइमलाइन में कार्ड डाले जाने में कुछ समय इंतज़ार करना पड़ता है.

यह कंस्ट्रेंट Glass Home कार्ड पर मुख्य वॉइस कमांड के साथ ही कार्ड और इमर्शन के मेन्यू आइटम पर लागू होता है.

कॉन्टेंट सही तरीके से बनाएं

अपने कार्ड के लिए कॉन्टेंट बनाते समय, हर कार्ड छोटा होना चाहिए और उसमें एक लॉजिकल जानकारी होनी चाहिए. इसके अलावा:

• जब हो सके, टेक्स्ट के बजाय इमेज का इस्तेमाल करें
• इमेज को उनके मूल आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) में दिखाएं (काटा जाना ठीक है).
• कार्ड के फ़ुटर का बीच वाला हिस्सा खाली रखें. यहां ok Glass संदर्भ वाला वॉइस मेन्यू दिखता है और यह उसके नीचे मौजूद किसी भी कॉन्टेंट को ब्लॉक कर देता है.
• अगर आप चाहें, तो कॉन्टेंट के हिसाब से फ़ॉन्ट का साइज़ अपने-आप बदलने के लिए, auto-resize सीएसएस क्लास का इस्तेमाल करें.
• लिखने से जुड़े हमारे दिशा-निर्देशों का पालन करें.