Mengaktifkan fulfillment lokal untuk Action smart home

Mengaktifkan fulfillment lokal untuk Action smart home

Tentang codelab ini

Terakhir diperbarui Mar 12, 2021

Ditulis oleh Tim Actions on Google Developer Relation

1. Sebelum memulai

Integrasi smart home memungkinkan Asisten Google mengontrol perangkat terhubung di rumah pengguna. Untuk membuat Action smart home, Anda perlu menyediakan endpoint webhook cloud yang mampu menangani intent smart home. Misalnya, saat pengguna mengatakan, "Ok Google, nyalakan lampu", Asisten mengirimkan perintah ke fulfillment cloud Anda untuk memperbarui status perangkat.

Local Home SDK meningkatkan integrasi smart home Anda dengan menambahkan jalur lokal untuk merutekan intent smart home langsung ke perangkat Google Home, sehingga meningkatkan keandalan dan mengurangi latensi dalam memproses perintah pengguna. Fitur ini memungkinkan Anda menulis dan men-deploy aplikasi fulfillment lokal dalam TypeScript atau JavaScript yang mengidentifikasi perangkat dan mengeksekusi perintah di smart speaker Google Home atau layar smart Google Nest mana saja. Aplikasi Anda kemudian berkomunikasi langsung dengan perangkat smart pengguna yang ada melalui jaringan area lokal dengan menggunakan protokol standar saat ini untuk memenuhi perintah.

Prasyarat

• Panduan developer untuk membuat Action smart home
• Codelab Mesin Cuci Smart Home
• Panduan developer tentang fulfillment lokal

Yang akan Anda buat

Di codelab ini, Anda akan men-deploy integrasi smart home yang dibuat sebelumnya dengan Firebase, lalu menerapkan konfigurasi pemindaian di Konsol Actions, dan membuat aplikasi lokal menggunakan TypeScript untuk mengirim perintah yang ditulis dalam Node.js ke perangkat mesin cuci virtual.

Yang akan Anda pelajari

• Cara mengaktifkan dan mengonfigurasi fulfillment lokal di Konsol Actions.
• Cara menggunakan Local Home SDK untuk menulis aplikasi fulfillment lokal.
• Cara men-debug aplikasi fulfillment lokal yang dimuat di speaker Google Home atau layar smart Google Nest.

Yang dibutuhkan

• Versi terbaru Google Chrome
• Perangkat iOS atau Android dengan aplikasi Google Home
• Smart speaker Google Home atau layar smart Google Nest
• Node.js versi 10.16 atau yang lebih baru
• Akun Google
• Akun penagihan Google Cloud

2. Memulai

Mengaktifkan Kontrol aktivitas

Aktifkan Kontrol aktivitas berikut di Akun Google yang akan Anda gunakan dengan Asisten:

• Aktivitas Web & Aplikasi
• Informasi Perangkat
• Aktivitas Suara & Audio

Anda akan memerlukan Akun Google yang sama di ponsel Anda dengan di Konsol Actions untuk menjalankan project ini sepenuhnya.

Membuat project Action

1. Buka Actions di Google Developers Console.
2. Klik New Project, masukkan nama untuk project, dan klik CREATE PROJECT.

Memilih Aplikasi Smart Home

Pada layar Overview di Konsol Actions, pilih Smart home.

Pilih kartu pengalaman Smart home, lalu Anda akan diarahkan ke konsol project.

Project ini menggunakan Cloud Functions for Firebase, yang mengharuskan Anda mengaitkan sebuah akun penagihan ke project Anda. Secara default, project Action tidak membuat akun penagihan. Lihat Membuat akun penagihan baru untuk informasi selengkapnya.

Menginstal Firebase CLI

Antarmuka Command Line (CLI) Firebase akan memungkinkan Anda menyalurkan aplikasi web secara lokal dan men-deploy aplikasi web ke Firebase hosting.

Untuk menginstal CLI, Anda harus telah menginstal npm yang biasanya disertai dengan Node.js.

Untuk menginstal CLI, jalankan perintah npm berikut dari terminal:

npm install -g firebase-tools

Tidak berhasil? Mungkin Anda perlu mengubah izin npm.

Untuk memverifikasi bahwa CLI telah diinstal dengan benar, jalankan:

firebase --version

Otorisasikan Firebase CLI dengan Akun Google Anda dengan menjalankan:

firebase login

Mengaktifkan HomeGraph API

HomeGraph API memungkinkan penyimpanan dan pembuatan kueri perangkat dan statusnya dalam Home Graph pengguna. Untuk menggunakan API ini, terlebih dulu Anda harus membuka Google Cloud Console dan mengaktifkan HomeGraph API.

Di Google Cloud Console, pastikan memilih project yang cocok dengan Actions Anda <project-id>. Lalu, di layar API Library untuk HomeGraph API, klik Enable.

3. Menjalankan aplikasi pemicu

Kini, setelah lingkungan pengembangan disiapkan, Anda dapat men-deploy project pemicu untuk memverifikasi bahwa semuanya telah dikonfigurasi dengan benar.

Mendapatkan kode sumber

Klik link berikut untuk mendownload contoh codelab ini di mesin pengembangan Anda:

Download kode sumber

...atau Anda dapat meng-clone repositori GitHub dari command line:

git clone https://github.com/googlecodelabs/smarthome-local.git

Catatan: Repositori codelab berisi tiga direktori:

• app-start—Kode awal yang menjadi dasar pembuatan
• app-done—Kode lengkap untuk aplikasi fulfillment lokal yang sudah selesai
• virtual-device—Simulasi perangkat mesin cuci yang tertulis dalam Node.js

Jika Anda ingin menjalankan aplikasi fulfillment lokal yang sudah selesai, Anda harus membuat project di Konsol Actions.

Tentang project

Project pemicu berisi subdirektori berikut:

• public—UI web frontend untuk mengontrol dan memantau mesin cuci smart
• functions—Fungsi cloud yang menerapkan fulfillment cloud untuk Action smart home
• local—Kerangka project aplikasi fulfillment lokal dengan pengendali intent yang di-stub di index.ts

Fulfillment cloud yang disediakan mencakup fungsi berikut dalam index.js:

• fakeauth—Endpoint otorisasi untuk penautan akun
• faketoken—Endpoint token untuk penautan akun
• smarthome—Endpoint fulfillment intent smart home
• reportstate—Memanggil HomeGraph API pada perubahan status perangkat
• updateDevice—Endpoint yang digunakan oleh perangkat virtual untuk memicu Report State

Tips: Cari TODO penanda

Project pemicu memberikan petunjuk tentang tempat Anda harus mengubah atau menambahkan kode. Contoh:

// TODO: Implement local fulfillment

Menghubungkan ke Firebase

Buka direktori app-start, lalu siapkan Firebase CLI dengan project Actions Anda:

cd app-start
firebase use <project-id>

Tips: Jika tidak mengetahui project ID untuk Action smart home, Anda dapat menemukannya di Konsol Actions di bagian Setelan project.

Men-deploy ke Firebase

Buka folder functions dan instal semua dependensi yang dibutuhkan menggunakan npm.

cd functions
npm install

Kini, setelah dependensi sudah diinstal dan project Anda sudah dikonfigurasikan, Anda siap untuk menjalankan aplikasi untuk pertama kali.

firebase deploy

Ini adalah output konsol yang akan Anda lihat:

...

✔ Deploy complete!

Project Console: https://console.firebase.google.com/project/<project-id>/overview
Hosting URL: https://<project-id>.firebaseapp.com

Perintah ini men-deploy aplikasi web, bersama dengan beberapa Cloud Functions for Firebase.

Buka URL Hosting di browser Anda (https://<project-id>.firebaseapp.com) untuk melihat aplikasi web. Anda akan melihat antarmuka berikut:

UI web ini mewakili platform pihak ketiga untuk melihat atau mengubah status perangkat. Untuk mulai mengisi database Anda dengan informasi perangkat, klik UPDATE. Anda tidak akan melihat perubahan apa pun di halaman ini, tapi status mesin cuci saat ini akan disimpan dalam database.

Catatan: Status perangkat virtual disimpan menggunakan Firebase Realtime Database. Anda dapat melihat isi database secara langsung menggunakan Firebase console. Di toolbar sebelah kiri, klik Develop > Database. Setiap pembaruan status mesin cuci akan tercermin di sini.

Sekarang saatnya menghubungkan layanan cloud yang telah Anda deploy ke Asisten Google menggunakan Konsol Actions.

Mengonfigurasi project Konsol Action Anda

Di bagian Overview > Build your Action, pilih Add Action(s). Masukkan URL untuk Cloud Function Anda yang menyediakan fulfillment untuk intent smart home, lalu klik Save.

https://us-central1-<project-id>.cloudfunctions.net/smarthome

Di tab Develop > Invocation, tambahkan Display Name untuk Action Anda, lalu klik Save. Nama ini akan muncul di aplikasi Google Home.

Untuk mengaktifkan penautan Akun, pilih opsi Develop > Account linking di navigasi sebelah kiri. Gunakan setelan penautan akun berikut:

Client ID	ABC123
Rahasia klien	DEF456
URL otorisasi	https://us-central1-.cloudfunctions.net/fakeauth
URL token	https://us-central1-.cloudfunctions.net/faketoken

Pastikan Anda memperbarui URL dengan project ID Anda.

Klik Save untuk menyimpan konfigurasi penautan akun Anda, lalu klik Test untuk mengaktifkan pengujian project Anda.

Anda akan dialihkan ke Simulator. Verifikasikan bahwa pengujian telah diaktifkan untuk project Anda dengan mengarahkan mouse ke ikon Testing on Device ( ).

Menautkan ke Asisten Google

Untuk menguji Action smart home, Anda harus menautkan project dengan Akun Google. Hal ini memungkinkan pengujian melalui platform Asisten Google dan aplikasi Google Home yang login ke akun yang sama.

Penting: Codelab ini mencakup penerapan penautan akun yang sebenarnya tidak memeriksa kredensial pengguna. Dalam sebuah sistem produksi, Anda harus menerapkan protokol OAuth 2.0 untuk menjaga keamanan perangkat.

1. Di ponsel, buka aplikasi Asisten Google. Perhatikan bahwa Anda harus login sebagai akun yang sama seperti di konsol.
2. Buka Google Assistant > Settings > Home Control (di bagian Asisten).
3. Klik ikon (+) di sudut kanan bawah
4. Anda akan melihat aplikasi pengujian dengan awalan [test] dan nama tampilan yang Anda tetapkan.
5. Pilih item tersebut. Kemudian, Asisten Google akan mengautentikasi dengan layanan Anda dan mengirimkan permintaan SYNC, meminta layanan Anda untuk memberikan daftar perangkat bagi pengguna.

Buka aplikasi Google Home dan verifikasikan bahwa Anda dapat melihat perangkat mesin cucinya.

Catatan: Jika mengalami masalah selama langkah penautan ini, Anda dapat memeriksa log error menggunakan Stackdriver.

Penting: Fulfillment lokal mengharuskan Anda mengonfigurasi perangkat Google Home dan mesin cuci di struktur Home Graph yang sama. Jika Anda mengonfigurasi lebih dari satu struktur rumah di aplikasi Google Home, pastikan Anda menambahkan kedua perangkat ke perangkat yang sama.

Verifikasikan Anda dapat mengontrol mesin cuci menggunakan perintah suara di aplikasi Google Home. Anda juga akan melihat perubahan status perangkat di UI web frontend dari fulfillment cloud Anda.

Sekarang Anda dapat mulai menambahkan fulfillment lokal ke Action.

4. Mengupdate fulfillment cloud

Untuk mendukung fulfillment lokal, Anda perlu menambahkan kolom per perangkat baru yang disebut otherDeviceIds ke respons SYNC cloud yang berisi ID lokal unik untuk perangkat. Kolom ini juga menunjukkan kemampuan untuk mengontrol perangkat tersebut secara lokal.

Tambahkan kolom otherDeviceIds ke respons SYNC seperti yang ditunjukkan dalam cuplikan kode berikut:

functions/index.js

app.onSync((body) => {
  return {
    requestId: body.requestId,
    payload: {
      agentUserId: '123',
      devices: [{
        id: 'washer',
        type: 'action.devices.types.WASHER',
        traits: [ ... ],
        name: { ... },
        deviceInfo: { ... },
        willReportState: true,
        attributes: {
          pausable: true,
        },
        otherDeviceIds: [{
          deviceId: 'deviceid123',
        }],
      }],
    },
  };
});

Deploy project yang telah diupdate ke Firebase:

firebase deploy --only functions

Setelah deployment selesai, buka UI web dan klik tombol Refresh di toolbar. Tindakan ini memicu operasi Request Sync sehingga Asisten menerima data respons SYNC yang diupdate.

Catatan: Anda dapat memverifikasi keberhasilan eksekusi permintaan sinkronisasi di log Firebase console.

5. Mengonfigurasi fulfillment lokal

Di bagian ini, Anda akan menambahkan opsi konfigurasi yang diperlukan untuk fulfillment lokal ke Action smart home Anda. Selama pengembangan, Anda akan memublikasikan aplikasi fulfillment lokal ke Firebase Hosting, dan di sana perangkat Google Home dapat mengakses dan mendownloadnya.

Di Actions console, pilih Develop > Actions dan temukan bagian Configure local home SDK. Masukkan URL berikut ke dalam kolom URL pengujian, masukkan project ID Anda, dan klik Save:

https://<project-id>.firebaseapp.com/local-home/index.html

Catatan: Anda akan memublikasikan aplikasi Local Home pada URL yang sama di bagian berikutnya.

Selanjutnya, kita perlu menentukan bagaimana perangkat Google Home harus menemukan perangkat smart lokal. Platform Local Home mendukung beberapa protokol untuk penemuan perangkat, termasuk siaran mDNS, UPnP, dan UDP. Anda akan menggunakan siaran UDP untuk menemukan mesin cuci smart.

Klik New scan config di bagian Device scan configuration untuk menambahkan konfigurasi pemindaian baru. Pilih UDP sebagai protokol, dan isi atribut berikut:

Kolom	Deskripsi	Nilai yang disarankan
Broadcast address	Alamat siaran UDP	255.255.255.255
Broadcast port	Port tempat Google Home mengirimkan siaran UDP	3311
Listen port	Port tempat Google Home mendengarkan respons	3312
Discovery packet	Payload data siaran UDP	48656c6c6f4c6f63616c486f6d6553444b

Tips: Nilai 48656c6c6f4c6f63616c486f6d6553444b adalah versi dienkode heksadesimal dari string HelloLocalHomeSDK.

Terakhir, klik Save di atas jendela untuk memublikasikan perubahan Anda.

Catatan: Konsol Actions dapat membutuhkan waktu hingga 20 menit untuk menerapkan perubahan konfigurasi ke perangkat Google Home.

6. Menerapkan fulfillment lokal

Anda akan mengembangkan aplikasi fulfillment lokal di TypeScript menggunakan paket mengetik Local Home SDK. Lihat kerangka yang disediakan di project awal:

local/index.ts

/// <reference types="@google/local-home-sdk" />

import App = smarthome.App;
import Constants = smarthome.Constants;
import DataFlow = smarthome.DataFlow;
import Execute = smarthome.Execute;
import Intents = smarthome.Intents;
import IntentFlow = smarthome.IntentFlow;

...

class LocalExecutionApp {

  constructor(private readonly app: App) { }

  identifyHandler(request: IntentFlow.IdentifyRequest):
      Promise<IntentFlow.IdentifyResponse> {
    // TODO: Implement device identification
  }

  executeHandler(request: IntentFlow.ExecuteRequest):
      Promise<IntentFlow.ExecuteResponse> {
    // TODO: Implement local fulfillment
  }

  ...
}

const localHomeSdk = new App('1.0.0');
const localApp = new LocalExecutionApp(localHomeSdk);
localHomeSdk
  .onIdentify(localApp.identifyHandler.bind(localApp))
  .onExecute(localApp.executeHandler.bind(localApp))
  .listen()
  .then(() => console.log('Ready'))
  .catch((e: Error) => console.error(e));

Komponen inti fulfillment lokal adalah kelas smarthome.App. Project pemicu melampirkan pengendali untuk intent IDENTIFY dan EXECUTE, lalu memanggil metode listen() untuk memberi tahu Local Home SDK bahwa aplikasi sudah siap.

Menambahkan pengendali IDENTIFY

Local Home SDK memicu pengendali IDENTIFY Anda saat perangkat Google Home menemukan perangkat yang belum diverifikasi di jaringan lokal berdasarkan konfigurasi pemindaian yang disediakan di Konsol Actions.

Sementara itu, platform memanggil identifyHandler dengan data pemindaian yang dihasilkan saat Google menemukan perangkat yang cocok. Di aplikasi Anda, pemindaian dilakukan menggunakan siaran UDP dan data pemindaian yang diberikan ke pengendali IDENTIFY menyertakan payload respons yang dikirim oleh perangkat lokal.

Pengendali menghasilkan instance IdentifyResponse yang berisi ID unik untuk perangkat lokal. Tambahkan kode berikut ke metode identifyHandler Anda untuk memproses respons UDP yang berasal dari perangkat lokal dan menentukan ID perangkat lokal yang sesuai:

local/index .ts

identifyHandler(request: IntentFlow.IdentifyRequest):
    Promise<IntentFlow.IdentifyResponse> {
  console.log("IDENTIFY intent: " + JSON.stringify(request, null, 2));

  const scanData = request.inputs[0].payload.device.udpScanData;
  if (!scanData) {
    const err = new IntentFlow.HandlerError(request.requestId,
        'invalid_request', 'Invalid scan data');
    return Promise.reject(err);
  }

  // In this codelab, the scan data contains only local device id.
  const localDeviceId = Buffer.from(scanData.data, 'hex');

  const response: IntentFlow.IdentifyResponse = {
    intent: Intents.IDENTIFY,
    requestId: request.requestId,
    payload: {
      device: {
        id: 'washer',
        verificationId: localDeviceId.toString(),
      }
    }
  };
  console.log("IDENTIFY response: " + JSON.stringify(response, null, 2));

  return Promise.resolve(response);
}

Perhatikan bahwa kolom verificationId harus cocok dengan salah satu nilai otherDeviceIds di respons SYNC Anda, yang menandai perangkat sebagai tersedia untuk fulfillment lokal di Home Graph pengguna. Setelah Google menemukan kecocokan, perangkat tersebut dianggap terverifikasi dan siap untuk fulfillment lokal.

Catatan: Jika perangkat Anda berfungsi sebagai hub untuk perangkat smart lain yang terhubung, lihat bagian Mendukung perangkat di balik hub di panduan fulfillment lokal.

Menambahkan pengendali EXECUTE

Local Home SDK memicu pengendali EXECUTE Anda saat perangkat yang mendukung fulfillment lokal menerima perintah. Konten intent lokal sama dengan intent EXECUTE yang dikirim ke fulfillment cloud Anda, sehingga logika untuk memproses lokal intent menyerupai cara Anda menanganinya di cloud.

Aplikasi dapat menggunakan soket TCP/UDP atau permintaan HTTP(S) untuk berkomunikasi dengan perangkat lokal. Dalam codelab ini, HTTP berfungsi sebagai protokol yang digunakan untuk mengontrol perangkat virtual. Nomor port ditetapkan dalam index.ts sebagai variabel SERVER_PORT.

Tambahkan kode berikut ke metode executeHandler Anda untuk memproses perintah masuk dan mengirimkannya ke perangkat lokal melalui HTTP:

local/index.ts

executeHandler(request: IntentFlow.ExecuteRequest):
    Promise<IntentFlow.ExecuteResponse> {
  console.log("EXECUTE intent: " + JSON.stringify(request, null, 2));

  const command = request.inputs[0].payload.commands[0];
  const execution = command.execution[0];
  const response = new Execute.Response.Builder()
    .setRequestId(request.requestId);

  const promises: Array<Promise<void>> = command.devices.map((device) => {
    console.log("Handling EXECUTE intent for device: " + JSON.stringify(device));

    // Convert execution params to a string for the local device
    const params = execution.params as IWasherParams;
    const payload = this.getDataForCommand(execution.command, params);

    // Create a command to send over the local network
    const radioCommand = new DataFlow.HttpRequestData();
    radioCommand.requestId = request.requestId;
    radioCommand.deviceId = device.id;
    radioCommand.data = JSON.stringify(payload);
    radioCommand.dataType = 'application/json';
    radioCommand.port = SERVER_PORT;
    radioCommand.method = Constants.HttpOperation.POST;
    radioCommand.isSecure = false;

    console.log("Sending request to the smart home device:", payload);

    return this.app.getDeviceManager()
      .send(radioCommand)
      .then(() => {
        const state = {online: true};
        response.setSuccessState(device.id, Object.assign(state, params));
        console.log(`Command successfully sent to ${device.id}`);
      })
      .catch((e: IntentFlow.HandlerError) => {
        e.errorCode = e.errorCode || 'invalid_request';
        response.setErrorState(device.id, e.errorCode);
        console.error('An error occurred sending the command', e.errorCode);
      });
  });

  return Promise.all(promises)
    .then(() => {
      return response.build();
    })
    .catch((e) => {
      const err = new IntentFlow.HandlerError(request.requestId,
          'invalid_request', e.message);
      return Promise.reject(err);
    });
}

Tips: Antarmuka DeviceManager secara internal memetakan ID perangkat ke alamat yang diperlukan untuk berkomunikasi dengan perangkat tersebut melalui jaringan lokal.

Mengompilasi aplikasi TypeScript

Buka direktori local/ dan jalankan perintah berikut untuk mendownload compiler TypeScript dan mengompilasi aplikasi:

cd local
npm install
npm run build

Ini akan mengompilasi sumber index.ts (TypeScript) dan menempatkan konten berikut ke direktori public/local-home/:

• bundle.js—Output JavaScript yang dikompilasi yang berisi aplikasi lokal dan dependensi.
• index.html—Halaman hosting lokal yang digunakan untuk menayangkan aplikasi pada pengujian perangkat.

Catatan: Setelah deployment, Anda dapat menemukan halaman index.html yang dihosting di URL pengujian yang sebelumnya Anda berikan di bagian Mengonfigurasi Local Home SDK di Konsol Actions.

Men-deploy project uji

Deploy file project yang telah diupdate ke Firebase Hosting sehingga Anda dapat mengaksesnya dari perangkat Google Home.

firebase deploy --only hosting

7. Memulai mesin cuci smart

Sekarang saatnya menguji komunikasi antara aplikasi fulfillment lokal Anda dengan mesin cuci smart! Project codelab pemicu mencakup mesin cuci smart virtual—yang ditulis dalam Node.js—yang menyimulasikan mesin cuci smart yang dapat dikontrol secara lokal oleh pengguna.

Mengonfigurasi perangkat

Anda perlu mengonfigurasi perangkat virtual untuk menggunakan parameter UDP yang sama dengan yang Anda terapkan pada konfigurasi pemindaian untuk penemuan perangkat di Konsol Actions. Selain itu, Anda perlu memberi tahu perangkat virtual ID perangkat lokal mana yang akan dilaporkan dan ID project Actions yang akan digunakan untuk peristiwa Report State saat status perangkat berubah.

Parameter	Nilai yang disarankan
deviceId	deviceid123
discoveryPortOut	3311
discoveryPacket	HelloLocalHomeSDK
projectId	ID project Actions Anda

Memulai perangkat

Buka direktori virtual-device/ dan jalankan skrip perangkat, meneruskan parameter konfigurasi sebagai argumen:

cd virtual-device
npm install
npm start -- \
  --deviceId=deviceid123 --projectId=<project-id> \
  --discoveryPortOut=3311 --discoveryPacket=HelloLocalHomeSDK

Verifikasikan bahwa skrip perangkat berjalan dengan parameter yang ditentukan:

(...): UDP Server listening on 3311
(...): Device listening on port 3388
(...): Report State successful

8. Men-debug aplikasi TypeScript

Di bagian berikut, Anda akan memverifikasi bahwa perangkat Google Home dapat memindai, mengidentifikasi, dan mengirim perintah ke mesin cuci smart virtual dengan benar melalui jaringan lokal. Anda dapat menggunakan Developer Tools Google Chrome untuk terhubung ke perangkat Google Home, melihat log konsol, dan men-debug aplikasi TypeScript.

Catatan: Anda harus menghubungkan mesin pengembangan dan perangkat Google Home ke jaringan Wi-Fi yang sama agar Developer Tools Chrome dapat menampilkan perangkat dengan benar di UI.

Menghubungkan Developer Tools Chrome

Untuk menghubungkan debugger ke aplikasi fulfillment lokal Anda, ikuti langkah-langkah berikut:

1. Pastikan Anda telah menautkan perangkat Google Home ke pengguna dengan izin untuk mengakses project Konsol Actions.
2. Mulai ulang perangkat Google Home Anda, yang akan memungkinkan perangkat memperoleh URL HTML Anda, serta konfigurasi pemindaian yang Anda masukkan di Konsol Actions.
3. Luncurkan Chrome di mesin pengembangan Anda.
4. Buka tab Chrome baru dan masukkan chrome://inspect di kolom alamat untuk meluncurkan inspector.

Anda akan melihat daftar perangkat di halaman tersebut dan URL aplikasi Anda akan muncul di bawah nama perangkat Google Home Anda.

Penting: Jika URL tidak muncul, batalkan tautan dan tautkan kembali project Actions on Google, lalu mulai ulang perangkat Google Home Anda. Diperlukan waktu hingga 20 menit untuk setelan di Konsol Actions diterapkan.

Meluncurkan inspector

Klik Inspect di bawah URL aplikasi Anda untuk meluncurkan Developer Tools Chrome. Pilih tab Console dan verifikasikan Anda dapat melihat konten intent IDENTIFY yang dicetak aplikasi TypeScript.

Tips: Perangkat Google Home mengirim discovery packet secara berkala di seluruh jaringan selama memindai. Setiap hasil pemindaian akan memicu intent IDENTIFY sampai aplikasi Anda memverifikasi ID perangkat yang ditemukan.

Output ini berarti bahwa aplikasi fulfillment lokal Anda berhasil menemukan dan mengidentifikasi perangkat virtual.

Menguji fulfillment lokal

Kirim perintah ke perangkat Anda menggunakan kontrol sentuh di aplikasi Google Home atau melalui perintah suara ke perangkat Google Home, seperti:

"Ok Google, nyalakan mesin cuci".

"Ok Google, mulai mesin cuci saya".

"Ok Google, hentikan mesin cuci saya".

Perintah ini akan memicu platform untuk mengirim intent EXECUTE ke aplikasi TypeScript Anda.

Verifikasikan Anda dapat melihat perubahan status lokal mesin cuci smart dengan setiap perintah.

...
***** The washer is RUNNING *****
...
***** The washer is STOPPED *****

Catatan: Karena perangkat menerapkan Report State, Anda juga akan melihat perubahan status perangkat di UI web frontend.

9. Selamat

Selamat! Anda berhasil menggunakan Local Home SDK untuk mengintegrasikan fulfillment lokal ke smart home Action.

Selengkapnya

Berikut beberapa hal lain yang dapat Anda coba:

• Ubah konfigurasi pemindaian untuk membuatnya berfungsi. Misalnya, coba gunakan port UDP atau discovery packet yang berbeda.
• Ubah codebase perangkat smart virtual untuk dijalankan pada perangkat yang tersemat—seperti Raspberry Pi—dan gunakan LED atau layar untuk memvisualisasikan status saat ini.