स्मार्ट होम ऐक्शन के लिए सूचनाएं

सूचनाएं, smart home Action को इस्तेमाल करने की अनुमति देती हैं उपयोगकर्ताओं से ज़रूरी ईमेल के बारे में बात करने के लिए Google Assistant डिवाइस से जुड़े इवेंट या बदलाव दिखेंगे. चेतावनी पाने के लिए, सूचनाएं पाने की सुविधा चालू की जा सकती है उपयोगकर्ता को समय-समय पर डिवाइस के इवेंट की जानकारी देता हो. उदाहरण के लिए, जब कोई दरवाज़े पर है या अनुरोध किए गए डिवाइस की स्थिति में बदलाव की रिपोर्ट पाना. जैसे, जब दरवाज़े के लॉक के बोल्ट में सफलतापूर्वक जुड़े हों या जाम हो गए हों.

आपका smart home Action इस तरह का डेटा भेज सकता है उपयोगकर्ताओं को दी जाने वाली सूचनाएं:

• अपने-आप मिलने वाली सूचनाएं: ये smart home के उपयोगकर्ता को सूचना देती हैं डिवाइस इवेंट, जिसमें उपयोगकर्ता के डिवाइस से पहले कोई अनुरोध नहीं किया गया है. जैसे दरवाज़े की घंटी बजने की आवाज़.

• फ़ॉलो-अप रिस्पॉन्स: इस बात की पुष्टि करने वाला कि डिवाइस को निर्देश देने का अनुरोध किया गया है सफल या असफल रहा, उदाहरण के लिए कोई दरवाज़ा लॉक करते समय. इन चेतावनियों का इस्तेमाल इसके लिए करें डिवाइस के ऐसे निर्देश जिन्हें पूरा होने में समय लगता है. फ़ॉलो-अप जवाब सिर्फ़ यह सुविधा तब काम करती है, जब स्मार्ट स्पीकर और स्मार्ट से डिवाइस के निर्देशों के अनुरोध भेजे जाते हैं दिखाएं.

Assistant, उपयोगकर्ताओं को ये सूचनाएं इस तौर पर देता है स्मार्ट स्पीकर और स्मार्ट डिसप्ले पर सूचनाएँ. अपने-आप मिलने वाली सूचनाएं डिफ़ॉल्ट रूप से बंद रहती हैं. उपयोगकर्ता Google Home app (GHA).

सूचनाएं ट्रिगर करने वाले इवेंट

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

ये लक्षण, अपने-आप मिलने वाली सूचनाओं की सुविधा देते हैं:

ये विशेषताएं, फ़ॉलो-अप जवाबों के लिए ज़रूरी होती हैं:

हर तरह के डिवाइस में, लागू होने वाले लक्षणों के बारे में सूचनाएं पाने की सुविधा काम करती है.

स्मार्ट होम ऐक्शन के लिए सूचनाएं तैयार करें

अपनी smart home कार्रवाई में इन चरणों में सूचनाएं जोड़ें:

1. Google को बताएं कि आपके डिवाइस से सूचना पाने की सुविधा चालू हो smart home डिवाइस ऐप्लिकेशन. अगर उपयोगकर्ता सूचनाएं चालू या बंद करते हैं तो Google को डिवाइस में हुए बदलाव की सूचना देने के लिए, SYNC का अनुरोध भेजें.
2. जब कोई डिवाइस इवेंट या स्थिति में बदलाव होता है, तो सूचना पाने के लिए, इस पर कॉल करके सूचना का अनुरोध भेजें Report State reportStateAndNotification एपीआई. अगर डिवाइस की स्थिति बदल गई है. आपके पास स्थिति और सूचना पेलोड, दोनों भेजने का विकल्प है Report State और सूचना कॉल में एक साथ.

इन सेक्शन में, इन चरणों के बारे में ज़्यादा जानकारी दी गई है.

यह बताना कि आपके ऐप्लिकेशन में सूचनाएं पाने की सुविधा चालू है या नहीं

उपयोगकर्ता इस तारीख तक अपने-आप सूचनाएं पाने का विकल्प चुन सकते हैं ने GHA में इस सुविधा को चालू किया है. ऐप्लिकेशन में smart home डिवाइस, आपके पास इनके लिए क्षमता जोड़ने का विकल्प भी है उपयोगकर्ताओं को डिवाइस से सूचनाओं को साफ़ तौर पर टॉगल करने के लिए सेट किया जाना चाहिए. उदाहरण के लिए, आपकी ऐप्लिकेशन सेटिंग.

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

अपने SYNC जवाब में, इनमें से कोई एक अपडेट भेजें:

• अगर उपयोगकर्ता ने साफ़ तौर पर आपके डिवाइस ऐप्लिकेशन में सूचनाओं को चालू किया है या अगर आपने टॉगल का विकल्प न दें, तो true के लिए devices.notificationSupportedByAgent प्रॉपर्टी.
• यदि उपयोगकर्ता ने स्पष्ट रूप से आपके डिवाइस ऐप्लिकेशन में नोटिफ़िकेशन बंद किया है, तो false के लिए devices.notificationSupportedByAgent प्रॉपर्टी.

नीचे दिया गया स्निपेट, सिंक करने के रिस्पॉन्स को सेट करने के तरीके का उदाहरण दिखाता है:

devices: [{
   id: 'device123',
   ...
   notificationSupportedByAgent: true,
}]

Google को सूचना के अनुरोध भेजें

Assistant पर सूचनाएं पाने के लिए, ऑर्डर पूरा होने पर, Google Home Graph को सूचना पेलोड भेजा जाता है Report State और Notification API कॉल के ज़रिए.

Google HomeGraph API को चालू करना

1. Google Cloud Console में, HomeGraph API पेज पर जाएं.

   HomeGraph API पेज पर जाएं
2. वह प्रोजेक्ट चुनें जो आपके smart home के प्रोजेक्ट आईडी से मेल खाता हो.
3. चालू करें पर क्लिक करें.

सेवा खाता कुंजी बनाना

Google Cloud Console से सेवा खाता कुंजी जनरेट करने के लिए, इन निर्देशों का पालन करें:

1. Google Cloud Console में, सेवा खाते की कुंजी बनाएं पेज पर जाएं.

   सेवा खाते के मुख्य पेज पर जाएं
2. सेवा खाता सूची से, चुनें नया सेवा खाता.
3. सेवा खाते का नाम फ़ील्ड में, कोई नाम डालें.
4. सेवा खाता आईडी फ़ील्ड में, आईडी डालें.

5. भूमिका सूची से सेवा खाते चुनें > सेवा खाते का टोकन क्रिएटर.

6. कुंजी टाइप के लिए, JSON विकल्प चुनें.

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

सूचना भेजें

सूचना का अनुरोध करने के लिए कॉल करें. इसके लिए, devices.reportStateAndNotification एपीआई. आपके JSON अनुरोध में eventId शामिल होना चाहिए, जो कि जनरेट किया गया यूनीक आईडी हो सूचना को ट्रिगर करने वाले इवेंट के लिए आपका प्लैटफ़ॉर्म. eventId को यह करना चाहिए एक रैंडम आईडी हो, जो हर बार सूचना का अनुरोध भेजने पर अलग-अलग होती है.

अपने एपीआई कॉल में पास किए जाने वाले notifications ऑब्जेक्ट में, priority वैल्यू, जो तय करती है कि सूचना किस तरह दिखाई जानी चाहिए. आपका डिवाइस के हिसाब से, notifications ऑब्जेक्ट में अलग-अलग फ़ील्ड शामिल हो सकते हैं विशेषता.

पेलोड सेट करने और एपीआई को कॉल करने के लिए, इनमें से कोई एक पाथ अपनाएं:

• अपने-आप मिलने वाली सूचना से जुड़ा पेलोड भेजना
• फ़ॉलो-अप रिस्पॉन्स पेलोड भेजें

अपने-आप मिलने वाली सूचना का पेलोड भेजें

API को कॉल करने के लिए, इनमें से किसी टैब में से कोई एक विकल्प चुनें:

const homegraphClient = homegraph({
  version: 'v1',
  auth: new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/homegraph'
  })
});

const res = await homegraphClient.devices.reportStateAndNotification({
  requestBody: {
    agentUserId: 'PLACEHOLDER-USER-ID',
    eventId: 'PLACEHOLDER-EVENT-ID',
    requestId: 'PLACEHOLDER-REQUEST-ID',
    payload: {
      devices: {
        notifications: {
          'PLACEHOLDER-DEVICE-ID': {
            ObjectDetection: {
              priority: 0,
              detectionTimestamp: 1534875126750,
              objects: {
                named: ['Alice'],
                unclassified: 2
              }
            }
          }
        }
      }
    }
  }
});
    

// Get Application Default credentials.
GoogleCredentials credentials =
    GoogleCredentials.getApplicationDefault()
        .createScoped(List.of("https://www.googleapis.com/auth/homegraph"));

// Create Home Graph service client.
HomeGraphService homegraphService =
    new HomeGraphService.Builder(
            GoogleNetHttpTransport.newTrustedTransport(),
            GsonFactory.getDefaultInstance(),
            new HttpCredentialsAdapter(credentials))
        .setApplicationName("HomeGraphExample/1.0")
        .build();

// Build device notification payload.
Map<?, ?> notifications =
    Map.of(
        "ObjectDetection",
        Map.of(
            "priority", 0,
            "detectionTimestamp", 1534875126,
            "objects", Map.of("named", List.of("Alice"), "unclassifed", 2)));

// Send notification.
ReportStateAndNotificationRequest request =
    new ReportStateAndNotificationRequest()
        .setRequestId("PLACEHOLDER-REQUEST-ID")
        .setAgentUserId("PLACEHOLDER-USER-ID")
        .setEventId("PLACEHOLDER-EVENT-ID")
        .setPayload(
            new StateAndNotificationPayload()
                .setDevices(
                    new ReportStateAndNotificationDevice()
                        .setNotifications(Map.of("PLACEHOLDER-DEVICE-ID", notifications))));
homegraphService.devices().reportStateAndNotification(request);
    

फ़ॉलो-अप रिस्पॉन्स पेलोड भेजें

फ़ॉलो-अप रिस्पॉन्स के पेलोड में अनुरोध की स्थिति और गड़बड़ी शामिल होती है अगर लागू हो, तो इवेंट पूरे न होने के कोड और मान्य followUpToken, EXECUTE इंटेंट के अनुरोध के दौरान दिया गया था. followUpToken का इस्तेमाल करना ज़रूरी है पांच मिनट के अंदर मान्य बने रहने और जवाब को सही तरीके से जोड़ने के लिए शामिल नहीं किया जा सकता.

इस स्निपेट में, EXECUTE के अनुरोध पेलोड का उदाहरण दिया गया है. इसमें followUpToken फ़ील्ड.

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [{
    "intent": "action.devices.EXECUTE",
    "payload": {
      "commands": [{
        "devices": [{
          "id": "123",
        }],
        "execution": [{
          "command": "action.devices.commands.TestNetworkSpeed",
          "params": {
            "testDownloadSpeed": true,
            "testUploadSpeed": false,
            "followUpToken": "PLACEHOLDER"
          }
        }]
      }]
    }
  }]
};

Google सिर्फ़ डिवाइस पर सूचना दिखाने के लिए, followUpToken का इस्तेमाल करता है उपयोगकर्ता मूल रूप से इनसे इंटरैक्ट कर रहा था और उसे पूरे उपयोगकर्ता के डिवाइस पर.

API को कॉल करने के लिए, इनमें से किसी टैब में से कोई एक विकल्प चुनें:

const followUpToken = executionRequest.inputs[0].payload.commands[0].execution[0].params.followUpToken;

const homegraphClient = homegraph({
  version: 'v1',
  auth: new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/homegraph'
  })
});

const res = await homegraphClient.devices.reportStateAndNotification({
  requestBody: {
    agentUserId: 'PLACEHOLDER-USER-ID',
    eventId: 'PLACEHOLDER-EVENT-ID',
    requestId: 'PLACEHOLDER-REQUEST-ID',
    payload: {
      devices: {
        notifications: {
          'PLACEHOLDER-DEVICE-ID': {
            NetworkControl: {
              priority: 0,
              followUpResponse: {
                status: 'SUCCESS',
                followUpToken,
                networkDownloadSpeedMbps: 23.3,
                networkUploadSpeedMbps: 10.2,
              }
            }
          }
        }
      }
    }
  }
});
    

// Get Application Default credentials.
GoogleCredentials credentials =
    GoogleCredentials.getApplicationDefault()
        .createScoped(List.of("https://www.googleapis.com/auth/homegraph"));

// Create Home Graph service client.
HomeGraphService homegraphService =
    new HomeGraphService.Builder(
            GoogleNetHttpTransport.newTrustedTransport(),
            GsonFactory.getDefaultInstance(),
            new HttpCredentialsAdapter(credentials))
        .setApplicationName("HomeGraphExample/1.0")
        .build();

// Extract follow-up token.
ExecuteRequest.Inputs executeInputs = (Inputs) executeRequest.getInputs()[0];
String followUpToken =
    (String)
        executeInputs
            .getPayload()
            .getCommands()[0]
            .getExecution()[0]
            .getParams()
            .get("followUpToken");

// Build device follow-up response payload.
Map<?, ?> followUpResponse =
    Map.of(
        "NetworkControl",
        Map.of(
            "priority",
            0,
            "followUpResponse",
            Map.of(
                "status",
                "SUCCESS",
                "followUpToken",
                followUpToken,
                "networkDownloadSpeedMbps",
                23.3,
                "networkUploadSpeedMbps",
                10.2)));

// Send follow-up response.
ReportStateAndNotificationRequest request =
    new ReportStateAndNotificationRequest()
        .setRequestId("PLACEHOLDER-REQUEST-ID")
        .setAgentUserId("PLACEHOLDER-USER-ID")
        .setEventId("PLACEHOLDER-EVENT-ID")
        .setPayload(
            new StateAndNotificationPayload()
                .setDevices(
                    new ReportStateAndNotificationDevice()
                        .setNotifications(Map.of("PLACEHOLDER-DEVICE-ID", followUpResponse))));
homegraphService.devices().reportStateAndNotification(request);
    

लॉग इन हो रहा है

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

notificationLog एंट्री का स्कीमा यह है:

status फ़ील्ड में ऐसी कई स्थितियां होती हैं जो सूचना पेलोड. इनमें से कुछ सिर्फ़ उन कार्रवाइयों में उपलब्ध हो सकते हैं जिनमें जिसे प्रोडक्शन में लॉन्च नहीं किया गया है.

स्टेटस के उदाहरण:

सभी सूचनाओं पर लागू होने वाली इन सामान्य स्थितियों के अलावा, status फ़ील्ड में लक्षण की खास स्थितियां भी शामिल हो सकती हैं. उदाहरण के लिए, OBJECT_DETECTION_DETECTION_TIMESTAMP_MISSING.