डिवाइस को खोजे जाने की सुविधा दें

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

Google को लोकल नेटवर्क पर आपके डिवाइस का पता लगाने और लोकल फ़ुलफ़िलमेंट पाथ सेट अप करने की अनुमति देने के लिए, आपको Actions console में डिवाइस का पता लगाने से जुड़ी जानकारी जोड़नी होगी. आपको क्लाउड फ़ुलफ़िलमेंट से मिले SYNC रिस्पॉन्स को भी अपडेट करना होगा, ताकि Google को स्थानीय तौर पर कंट्रोल किए जा सकने वाले डिवाइस के बारे में जानकारी मिल सके.

स्कैन कॉन्फ़िगरेशन की जानकारी सेट अप करना

खोज से जुड़ी जानकारी देने के लिए, यह तरीका अपनाएं:

  1. Google Home Developer Console में Cloud-to-cloud इंटिग्रेशन पर जाएं:

    Developer Console पर जाएं.

  2. स्क्रीन पर बाईं ओर, प्रोजेक्ट > क्लाउड-टू-क्लाउड पर जाएं. इसके बाद, इंटिग्रेशन के लिए बदलाव करें को चुनें. सेटअप और कॉन्फ़िगरेशन पेज पर, स्थानीय तौर पर ऑर्डर पूरा करना पर स्क्रोल करें और सेटिंग को चालू करें. हर टेस्ट यूआरएल फ़ील्ड में यह यूआरएल डालें, अपना प्रोजेक्ट आईडी डालें, और सेव करें पर क्लिक करें:

    https://<project-id>.web.app/local-home/index.html

  3. नया स्कैन कॉन्फ़िगरेशन जोड़ने के लिए, डिवाइस डिस्कवरी में जाकर, + स्कैन कॉन्फ़िगरेशन जोड़ें पर क्लिक करें.

  4. ड्रॉप-डाउन से, स्कैन मैचिंग प्रोटोकॉल टाइप चुनें. इसके बाद, Google के लिए स्कैन की जाने वाली वैल्यू डालें.

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

mDNS
एट्रिब्यूट ब्यौरा उदाहरण वैल्यू
सेवा का नाम ज़रूरी है. डिवाइस की ओर से पब्लिश की गई सेवा का नाम, service.domain फ़ॉर्मैट में होना चाहिए. _http._tcp.local
नाम

ज़रूरी है. instance.service.domain फ़ॉर्मैट में किसी यूनीक सर्विस इंस्टेंस के लिए फ़िल्टर करें.

प्लैटफ़ॉर्म इस वैल्यू को रेगुलर एक्सप्रेशन के तौर पर इस्तेमाल करता है और इससे मैच होने वाले डिवाइसों की जानकारी दिखाता है.
my-device-[0-9]{4}\._http\._tcp\.local
UPnP
एट्रिब्यूट ब्यौरा उदाहरण वैल्यू
सेवा प्रकार ज़रूरी है. domain:service:type:version फ़ॉर्मैट में, UPnP सेवा का पूरी तरह से क्वालिफ़ाइड आइडेंटिफ़ायर. schemas-upnp-org:service:SwitchPower:1
ओयूआई

ज़रूरी नहीं. संगठन का यूनीक आइडेंटिफ़ायर.

डिवाइस बनाने वाली कंपनी की पहचान करने वाली 24-बिट वैल्यू. आम तौर पर, डिवाइस के मैक पते के पहले तीन ऑक्टेट.
1A:2B:3C
यूडीपी
एट्रिब्यूट ब्यौरा उदाहरण वैल्यू
डिस्कवरी पता ज़रूरी है. यूडीपी ब्रॉडकास्ट के लिए डेस्टिनेशन आईपी पता. 255.255.255.255
ब्रॉडकास्टिंग पोर्ट ज़रूरी है. यूडीपी ब्रॉडकास्ट के लिए डेस्टिनेशन पोर्ट. 5555
लिसनिंग पोर्ट ज़रूरी है. यूडीपी डिस्कवरी रिस्पॉन्स के लिए लिसन पोर्ट. 5556
डिस्कवरी पैकेट

ज़रूरी है. यूडीपी ब्रॉडकास्ट में भेजा जाने वाला पेलोड.

इसे हेक्साडेसिमल कोड में बदली गई बाइट की स्ट्रिंग के तौर पर फ़ॉर्मैट किया जाता है.
48454C4C4F

क्लाउड फ़ुलफ़िलमेंट में SYNC रिस्पॉन्स को अपडेट करना

SYNC इंटेंट, Assistant को यह जानकारी देता है कि उपयोगकर्ता किन डिवाइसों को कंट्रोल करता है और उन डिवाइसों में कौनसी सुविधाएँ हैं.

लोकल फ़ुलफ़िलमेंट की सुविधा देने के लिए, Local Home प्लैटफ़ॉर्म आपके स्मार्ट होम ऐक्शन के क्लाउड फ़ुलफ़िलमेंट से मिले SYNC रिस्पॉन्स की जांच करता है. साथ ही, otherDeviceIds फ़ील्ड में मौजूद डिवाइस आईडी को, IDENTIFY हैंडलर से मिले पुष्टि करने वाले आईडी से मैच करने की कोशिश करता है. जिन डिवाइस एंट्री में otherDeviceIds फ़ील्ड नहीं होता है उन्हें लोकल फ़ुलफ़िलमेंट से बाहर रखा जाता है.

SYNC रिस्पॉन्स के otherDeviceIds फ़ील्ड में, आपको उन स्मार्ट होम डिवाइसों के डिवाइस आईडी सेट करने होंगे जिन्हें स्थानीय तौर पर कंट्रोल किया जा सकता है. यह फ़ील्ड, जवाब में device लेवल पर दिखता है. Google, दिए गए आईडी वाले किसी भी डिवाइस पर लोकल फ़ुलफ़िलमेंट पाथ सेट अप कर सकता है.

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

उदाहरण

यहां दिए गए स्निपेट में बताया गया है कि SYNC हैंडलर कैसे बनाया जा सकता है.

स्टैंडअलोन/हब
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [{
      "id": "123",
      "type": "action.devices.types.OUTLET",
      "traits": [
        "action.devices.traits.OnOff"
      ],
      "name": {
        "name": "Night light"
      },
      "willReportState": false,
      "otherDeviceIds": [{
        "deviceId": "local-device-id"
      }],
      "customData": {
        "port": 5555,
        "authToken": "..."
      }
    }]
  }
}