Akıllı ev İşlemleri için bildirimler

Bildirimler, smart home İşleminizin kullanmasına olanak tanır Kullanıcılarla önemli konular hakkında iletişim kurmak için Google Assistant ilişkili etkinlikler veya değişiklikler olabilir. Dikkat çekmek için Cihaz etkinliklerine zamanında ulaşması (örneğin, birisi kapıya geldiğinde veya istenen bir cihaz durumu değişikliğini (ör. kapı kilit sürgüsünün başarılı bir şekilde devre dışı bırakılmış veya kilitlenmiş.

smart home İşleminiz aşağıdaki türleri gönderebilir kullanıcılara bildirim gönderme:

• Proaktif bildirimler: Kullanıcıyı smart home konusunda uyarır herhangi bir kullanıcı talebi olmadan cihaz etkinliği (örneğin, kapı zili çalıyor.

• Takip yanıtları: Bir cihaz komut isteğinin onayı (örneğin, kapı kilitlendiğinde) başarılı veya başarısız olur. Bu uyarıları şunlar için kullanın: komut satırı oluşturmayı deneyin. Yanıt yanıtları Akıllı hoparlörlerden ve akıllı cihazlardan cihaz komutu istekleri gönderildiğinde desteklenir görüntüler.

Assistant, bu bildirimleri kullanıcılara şu şekilde sağlar: duyurulardan ve duyurulardan haberdar olun. Proaktif bildirimler varsayılan olarak devre dışıdır. Kullanıcılar, tüm proaktif bildirimleri şuradan açabilir veya kapatabilirler: Google Home app (GHA).

Bildirimleri tetikleyen etkinlikler

Cihaz etkinlikleri gerçekleştiğinde İşlem karşılama ayarınız bir bildirim isteği gönderir Google'a otomatik olarak gönderin. smart home işleminizin cihaz özellikleri desteği, ne tür bildirim etkinliklerinin kullanılabilir olduğunu belirler ve pek çok veri vardır.

Aşağıdaki özellikler proaktif bildirimleri destekler:

Aşağıdaki özellikler takip yanıtlarını destekler:

Tüm cihaz türleri, geçerli özelliklerle ilgili bildirimleri destekler.

Akıllı ev işleminiz için bildirimler oluşturma

smart home İşleminize şu aşamalarda bildirim ekleyin:

1. Cihazınızdan bildirimlerin etkinleştirilip etkinleştirilmediğini Google'a bildirin smart home cihaz uygulaması. Kullanıcıların bildirimleri etkinleştirmesi veya devre dışı bırakması uygulamanızda, cihaz değişikliğini Google'a bildirmek için bir SYNC isteği gönderin.
2. Cihazda bir etkinliği veya durumu tetikleyen alakalı bir cihaz etkinliği veya bildirimi almak için Report State reportStateAndNotification API. Öğe cihaz durumu değiştiyse hem durum hem de bildirim yükü gönderebilirsiniz Report State ve Bildirim çağrınızda birlikte kullanın.

Aşağıdaki bölümlerde bu adımlar daha ayrıntılı olarak ele alınmaktadır.

Uygulamanızda bildirimlerin etkinleştirilip etkinleştirilmediğini belirtin

Kullanıcılar, proaktif bildirim almak isteyip istemediklerini Bu özelliği GHA üzerinden etkinleştirebilirsiniz. Cihazınızda smart home kullanıyorsanız kullanıcıların cihazdan gelen bildirimleri açıkça değiştirmelerini (örneğin, Ayarlar'ı tıklayın.

Request SYNC çağrısı cihaz verilerini güncellemek için. Her zaman bunun gibi bir SYNC isteği göndermelisiniz Kullanıcılar uygulamanızda bu ayarı değiştirdiğinde.

SYNC yanıtınızda şu güncellemelerden birini gönderin:

• Kullanıcı, cihaz uygulamanızda bildirimleri açıkça açtıysa veya açma/kapatma seçeneği yoksa devices.notificationSupportedByAgent mülk true öğesine.
• Kullanıcı, cihaz uygulamanızda bildirimleri açıkça kapattıysa devices.notificationSupportedByAgent mülk false öğesine.

Aşağıdaki snippet'te SYNC yanıtınızı nasıl ayarlayacağınıza dair bir örnek gösterilmektedir:

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

Google'a bildirim istekleri gönderme

Assistant uygulamasında bildirimleri tetiklemek için sipariş karşılama, Google Home Graph cihazına bir bildirim yükü gönderir. Report State ve Notification API çağrısı ile.

Google HomeGraph API'yi etkinleştirme

1. Google Cloud Console uygulamasında HomeGraph API sayfasına gidin.

   HomeGraph API sayfasına gidin
2. smart home proje kimliğinizle eşleşen projeyi seçin.
3. ETKİNLEŞTİR'i tıklayın.

Hizmet Hesabı Anahtarı Oluşturma

Google Cloud Console öğesinden bir hizmet hesabı anahtarı oluşturmak için şu talimatları uygulayın:

1. Google Cloud Console sayfasında Hizmet hesabı anahtarı oluştur sayfasına gidin.

   Hizmet Hesabı Anahtarı Oluşturma sayfasına git
2. Hizmet hesabı listesinden Yeni hizmet hesabı.
3. Hizmet hesabı adı alanına bir ad girin.
4. Hizmet hesabı kimliği alanına bir kimlik girin.

5. Role (Rol) listesinden Service Accounts (Hizmet Hesapları) > Hizmet Hesabı Jetonu Oluşturucu.

6. Anahtar türü olarak JSON seçeneğini belirleyin.

7. Oluştur'u tıklayın. Anahtarınızı içeren bir JSON dosyası bilgisayarınıza indirilir.

Bildirimi gönder

Bildirim isteği çağrısını devices.reportStateAndNotification API. JSON isteğiniz, eventId tarafından oluşturulan benzersiz bir kimlik olan bildirimi tetikleyen etkinlik için platformunuza. eventId her bildirim isteği gönderdiğinizde farklı olan rastgele bir kimlik olmalıdır.

API çağrınızda ilettiğiniz notifications nesnesine bir Bildirimin nasıl sunulması gerektiğini tanımlayan priority değeri. Sizin notifications nesnesi, cihaza bağlı olarak farklı alanlar içerebilir çok önemlidir.

Yükü ayarlamak ve API'yi çağırmak için aşağıdaki yollardan birini izleyin:

• Proaktif bildirim yükü gönderme
• Takip yanıtı yükü gönderme

Proaktif bildirim yükü gönder

API'yi çağırmak için aşağıdaki sekmelerin birinden bir seçenek belirleyin:

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);
    

Takip yanıtı yükü gönderme

Takip yanıtının yükü, isteğin durumunu, hatayı etkinlik hataları için kodları (varsa) ve geçerli followUpToken, EXECUTE intent isteği sırasında sağlanır. followUpToken kullanılmalıdır geçerli kalmasını sağlamak ve yanıtı doğru şekilde ilişkilendirmek için beş dakika değiştirmelisiniz.

Aşağıdaki snippet'te bir EXECUTE istek yükü için followUpToken alanı.

{
  "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, bildirim çıkışını yalnızca cihazda yapmak için followUpToken özelliğini kullanır kullanıcı ilk olarak etkileşimde bulunmuş ve cihazlar.

API'yi çağırmak için aşağıdaki sekmelerin birinden bir seçenek belirleyin:

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);
    

Günlük Kaydı

Bildirimler, Cloud Logging ile etkinlik günlüklerine erişme başlıklı makalede özetlendiği şekilde etkinlik günlük kaydını destekler. Bu günlükler, belirli bir süre içinde bildirim kalitesini test etmek İşleminiz.

Aşağıda, bir notificationLog girişinin şeması bulunmaktadır:

status alanı, bildirim yükü. Bunlardan bazıları yalnızca üretime sunulmamıştır.

Durumlara örnek olarak şunlar verilebilir:

Tüm bildirimler için geçerli olan bu genel durumların yanı sıra status alanı, geçerli olduğu durumlarda özelliğe özgü durumlar da içerebilir (ör. OBJECT_DETECTION_DETECTION_TIMESTAMP_MISSING).