संपर्क

संपर्क आपके ग्लासवेयर को टाइमलाइन आइटम पाने देते हैं, जिन्हें उसने नहीं बनाया है. उपयोगकर्ताओं को कार्ड के शेयर करें मेन्यू आइटम पर टैप करके, आपके संपर्क के साथ टाइमलाइन आइटम को साफ़ तौर पर शेयर करना होगा.

इनके काम करने का तरीका

शेयर किया जाने वाला संपर्क बनाने के बाद, टाइमलाइन कार्ड शेयर करने का यह सामान्य तरीका है:

1. संपर्क बनाएं और ऐसे MIME टाइप तय करें जो आपके संपर्क में काम करते हों.
2. संपर्क को अपने उपयोगकर्ता की टाइमलाइन में शामिल करें.
3. उपयोगकर्ता को एक टाइमलाइन आइटम मिलता है, जिसमें शेयर करें मेन्यू आइटम होता है. ग्लासवेयर को साफ़ तौर पर उपयोगकर्ताओं को इस मेन्यू आइटम के साथ अपने आइटम शेयर करने की अनुमति देनी चाहिए.
4. उपयोगकर्ता, टाइमलाइन आइटम पर टैप करता है, शेयर करें मेन्यू आइटम को चुनता है, और आपका संपर्क चुनता है.
5. Mirror API, शेयर किए गए टाइमलाइन कार्ड की एक कॉपी बनाता है और आपके संपर्क को कॉपी का ऐक्सेस देता है. साथ ही, इस कॉपी को उपयोगकर्ता की टाइमलाइन में डालता है. आपका ग्लासवेयर मूल टाइमलाइन आइटम को ऐक्सेस नहीं कर सकता.
6. अगर आपने सूचनाएं शेयर करने की सदस्यता ली है, तो आपको टाइमलाइन कार्ड की पहचान से जुड़ी जानकारी वाला पेलोड मिलेगा. इसके बाद, Timeline.get की मदद से टाइमलाइन आइटम को वापस लाया जा सकता है.
7. शेयर किए गए टाइमलाइन कार्ड में बदलाव किया जा सकता है और मौजूदा टाइमलाइन कार्ड को Timeline.update की मदद से अपडेट किया जा सकता है.

इनका इस्तेमाल कब करना चाहिए

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

आपका Glassware दो मुख्य तरीकों से संपर्कों का इस्तेमाल कर सकता है:

• उपयोगकर्ताओं को अपनी टाइमलाइन के आइटम को दूसरे संपर्कों के साथ शेयर करने की अनुमति दें: किसी टाइमलाइन कार्ड में SHARE पहले से मौजूद मेन्यू आइटम जोड़ें. जब उपयोगकर्ता 'शेयर करें' मेन्यू आइटम पर टैप करते हैं, तब Glass उन संभावित संपर्कों की सूची दिखाता है जिनके साथ शेयर करना है.

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

संपर्क बनाना

उपयोगकर्ताओं को आपके ग्लासवेयर के साथ टाइमलाइन वाले आइटम शेयर करने की अनुमति देने के लिए, insert REST एंडपॉइंट पर किसी संपर्क का JSON फ़ॉर्मैट पोस्ट करके, संपर्क डालें.

सभी संपर्कों को एक id तय करना होगा, जो सूचनाओं को पाने वाले ग्लासवेयर से संपर्क की पहचान करता है. आपको एक displayName और कम से कम एक imageUrls भी बताना होगा, जिनका इस्तेमाल Glass उपयोगकर्ता को संपर्क जानकारी दिखाने के लिए किया जाता है.

POST /mirror/v1/contacts HTTP/1.1
Authorization: Bearer {auth token}
Content-Type: application/json
Content-Length: {length}

{
  "id": "harold"
  "displayName": "Harold Penguin",
  "iconUrl": "https://developers.google.com/glass/images/harold.jpg"
  "priority": 7
}

सूचनाएं शेयर करने के लिए सदस्यता लें

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

मिरर एपीआई से, उस एंडपॉइंट पर POST अनुरोध के तौर पर एक सूचना भेजी जाती है जिसकी सदस्यता ली गई है. इसमें JSON के अनुरोध का मुख्य हिस्सा होता है.

{
  "collection": "timeline",
  "itemId": "3hidvm0xez6r8_dacdb3103b8b604_h8rpllg",
  "operation": "INSERT",
  "userToken": "harold_penguin",
  "verifyToken": "random_hash_to_verify_referer",
  "userActions": [
    {
      "type": "SHARE"
    }
  ]
}

itemId एट्रिब्यूट, शेयर किए गए टाइमलाइन आइटम का ID है. टाइमलाइन आइटम को जानने के लिए, Timeline.get के साथ इस एट्रिब्यूट का इस्तेमाल किया जा सकता है. यहां दिए गए उदाहरण में, फ़ोटो अटैचमेंट के साथ एक सामान्य टाइमलाइन आइटम दिखाया गया है:

{
  "id": "3hidvm0xez6r8_dacdb3103b8b604_h8rpllg",
  "attachments": [
      {
          "contentType": "image/jpeg",
          "id": "<ATTACHMENT_ID>"
      }
  ],
  "recipients": [
      {
          "kind": "glass#contact",
          "source": "api:<SERVICE_ID>",
          "id": "<CONTACT_ID>",
          "displayName": "<CONTACT_DISPLAY_NAME>",
          "imageUrls": [
              "<CONTACT_ICON_URL>"
          ]
      }
  ]
}

अगर कोई गड़बड़ी नहीं होती है, तो आपकी सेवा को 200 OK एचटीटीपी स्टेटस कोड के साथ एपीआई का जवाब देना होगा. अगर आपकी सेवा के जवाब में गड़बड़ी कोड दिखता है, तो Mirror API आपकी सेवा को सूचना फिर से भेजने की कोशिश कर सकता है.

बोली को लेख में बदला जा रहा है

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

• "नोट करो"
• "अपडेट पोस्ट करना"

उदाहरण के लिए, कोई उपयोगकर्ता हमें इस वाक्य के साथ चिपोटी के आने वाले जन्मदिन के बारे में बता सकता है: "Ok Glass... इसके लिए अपडेट पोस्ट करो... कैट स्ट्रीम... चिपोटल का जन्मदिन कल है!"

बोलकर दिए जाने वाले निर्देशों का इस्तेमाल करने के लिए:

1. acceptCommands प्रॉपर्टी के साथ सही type बताएं:

   {
     ...
   
     "displayName": "Cat Stream",
     "id": "CAT_STREAM",
     "acceptCommands": [
       {"type": "POST_AN_UPDATE"}
     ]
   }
   

2. यह सूचना पाने के लिए कि बोले जा रहे शब्दों को टेक्स्ट में बदलने की सुविधा उपलब्ध है या नहीं, टाइमलाइन सूचनाओं की सदस्यता लें. ऐसा होने पर, आपके Glassware को एक सूचना मिलती है:

   {
     "collection": "timeline",
     "operation": "UPDATE",
     "userToken": "<USER_TOKEN>",
     "verifyToken": "<VERIFY_TOKEN>",
     "itemId": "<ITEM_ID>",
     "userActions": [
       {"type": "LAUNCH"}
     ]
   }
   

3. टाइमलाइन आइटम को फ़ेच करने के लिए, itemId का इस्तेमाल करें:

   {
     "id": "<ITEM_ID>",
     "text": "Chipotle's birthday is tomorrow",
     "recipients": [
       {"id": "CAT_STREAM"}
     ]
   }
   

4. अगर एक से ज़्यादा Glassware एक ही बोले गए निर्देश से किसी संपर्क को रजिस्टर करते हैं, तो Glass हर संपर्क के लिए displayName को दूसरे लेवल का मेन्यू दिखाता है. इसके बाद, उपयोगकर्ता अपनी पसंद का संपर्क बोल सकते हैं. अगर आपके संपर्क के displayName में बताने लायक वर्ण नहीं हैं या वह फ़ोनेटिक नहीं है, तो शेयर किए जाने वाले संपर्क के उच्चारण की सही जानकारी देने के लिए speakableName प्रॉपर्टी का इस्तेमाल करें.

शेयर की गई फ़ोटो के लिए कैप्शन

उपयोगकर्ता आपके ग्लासवेयर से फ़ोटो शेयर कर सकते हैं और साथ में कैप्शन भी होते हैं, जिसे वे बोली के साथ इनपुट करते हैं. सामान्य यूज़र फ़्लो है:

1. उपयोगकर्ता, फ़ोटो वाले टाइमलाइन आइटम पर टैप करता है. इसके बाद, शेयर करें मेन्यू आइटम चुनता है और आपका संपर्क चुनता है.
2. उपयोगकर्ता कुछ समय के अंदर फिर से टैप करके फ़ोटो में कैप्शन जोड़ता है.
3. उपयोगकर्ता कैप्शन बोलता है.
4. टाइमलाइन आइटम को आपके Glassware के साथ शेयर किया जाता है, जैसा कि पहले ये कैसे काम करते हैं में बताया गया है. इसके अलावा, टाइमलाइन आइटम की text प्रॉपर्टी, उपयोगकर्ता के ट्रांसक्राइब किए गए कैप्शन के साथ सेट होती है.