संपर्क

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

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

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

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

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

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

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

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

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

संपर्क बनाना

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

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

ध्यान दें: सबसे अच्छे नतीजे पाने के लिए, 640 x 360 पिक्सल की PNG आइकॉन इमेज का इस्तेमाल करें imageUrls के लिए एक पारदर्शी बैकग्राउंड.

रॉ एचटीटीपी

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 अपनी सेवा को नोटिफ़िकेशन फिर से भेजने का प्रयास करें.

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

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

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

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

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

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

1. यह जानकारी दें acceptCommands प्रॉपर्टी, जिस पर type:

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

2. 'आप कब और कैसे किसी जगह पर गए' की सूचनाएं पाने के लिए सदस्यता लें बोली को लेख में बदलने की सुविधा उपलब्ध है. आपके ग्लासवेयर को मिलता है ऐसा होने पर सूचना:

   {
     "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"}
     ]
   }
   

   ध्यान दें: जब आपको शेयर किया गया टाइमलाइन आइटम मिलता है, मौजूदा टाइमलाइन कार्ड को इससे अपडेट करें Timeline.update पर क्लिक करें.

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

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

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

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