IoT Platform：Pesan siaran

Batasan

• Pesan hanya dapat disiarkan ke perangkat online dalam suatu produk.
• Saat Anda menyiarkan pesan ke perangkat online tertentu, Anda harus menentukan topik siaran yang dilanggan oleh perangkat tersebut. Dalam hal ini, Anda dapat memanggil operasi PubBroadcast sekali per detik.
• Saat Anda menyiarkan pesan ke semua perangkat online, perangkat tidak perlu berlangganan ke topik siaran. Dalam hal ini, Anda dapat memanggil operasi PubBroadcast sekali per menit.
• Ukuran badan pesan dapat mencapai hingga 64 KB.

Menyiapkan lingkungan pengembangan

Dalam contoh ini, perangkat dan IoT Platform menggunakan SDK untuk Java. Oleh karena itu, Anda harus menyiapkan lingkungan pengembangan Java. Anda dapat mengunduh Java dari situs resmi Java dan menyebarkan lingkungan pengembangan Java.

Menambahkan dependensi ke proyek Maven

Buat proyek di Maven. Tambahkan dependensi berikut ke file pom.xml dari proyek Maven:

<dependencies>
  <dependency>
     <groupId>com.aliyun.alink.linksdk</groupId>
     <artifactId>iot-linkkit-java</artifactId>
     <version>1.2.0.1</version>
     <scope>compile</scope>
  </dependency>
  <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>aliyun-java-sdk-core</artifactId>
      <version>4.5.6</version>
  </dependency>
  <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>aliyun-java-sdk-iot</artifactId>
      <version>7.41.0</version>
  </dependency>
  <dependency>
    <groupId>com.aliyun.openservices</groupId>
    <artifactId>iot-client-message</artifactId>
    <version>1.1.2</version>
  </dependency>
</dependencies>

Membuat produk dan perangkat

1. Masuk ke konsol IoT Platform.

2. Di halaman Overview, klik All environment. Pada tab All environment, temukan instance yang ingin Anda kelola dan klik ID instance atau nama instance.

3. Di panel navigasi sisi kiri, pilih Devices > Products.
4. Klik Create Product untuk membuat produk kunci pintu pintar. Untuk informasi lebih lanjut, lihat Membuat Produk.
5. Di panel navigasi sisi kiri, pilih Devices > Devices. Anda dapat membuat tiga perangkat kunci pintu pintar dalam produk yang telah dibuat. Untuk informasi lebih lanjut, lihat Membuat Beberapa Perangkat Sekaligus.

Mengonfigurasi SDK perangkat

• Menghubungkan Perangkat ke IoT Platform.
  • Tentukan informasi sertifikat perangkat.

    final String productKey = "<yourProductKey>";
    final String deviceName = "<yourDeviceName>";
    final String deviceSecret = "<yourDeviceSecret>";
    final String region = "<yourRegionID>";

    Informasi sertifikat perangkat ditentukan oleh parameter berikut: productKey, deviceName, dan deviceSecret. Untuk melihat informasi tersebut, lakukan langkah-langkah berikut: Masuk ke konsol IoT Platform. Di halaman Overview, klik kartu instance tempat perangkat tersebut berada. Di halaman navigasi sisi kiri, pilih Devices > Devices. Di halaman yang muncul, temukan perangkat dan klik View di kolom Actions. Informasi tersebut ditampilkan di halaman Device Details.

    region: ID wilayah tempat perangkat berada. Untuk informasi lebih lanjut tentang format nilai parameter region, lihat Regions.

  • Konfigurasikan parameter untuk menginisialisasi koneksi. Parameter tersebut mencakup parameter koneksi Message Queuing Telemetry Transport (MQTT), informasi perangkat, dan status awal perangkat.

    LinkKitInitParams params = new LinkKitInitParams();
    // Konfigurasikan parameter koneksi MQTT. Link SDK menggunakan MQTT sebagai protokol dasar.
    IoTMqttClientConfig config = new IoTMqttClientConfig();
    config.productKey = productKey;
    config.deviceName = deviceName;
    config.deviceSecret = deviceSecret;
    config.channelHost = productKey + ".iot-as-mqtt." + region + ".aliyuncs.com:1883";
    // Tentukan informasi perangkat.
    DeviceInfo deviceInfo = new DeviceInfo();
    deviceInfo.productKey = productKey;
    deviceInfo.deviceName = deviceName;
    deviceInfo.deviceSecret = deviceSecret;
    // Tentukan status awal perangkat.
    Map<String, ValueWrapper> propertyValues = new HashMap<String, ValueWrapper>();
    params.mqttClientConfig = config;
    params.deviceInfo = deviceInfo;
    params.propertyValues = propertyValues;

    channelHost menentukan titik akhir untuk koneksi MQTT ke instance. Untuk informasi tentang cara memperoleh titik akhir instance publik dan instance Enterprise Edition, lihat Kelola Titik Akhir Suatu Instance.

  • Inisialisasi koneksi.

    // Inisialisasi koneksi dan konfigurasikan fungsi panggilan balik yang digunakan setelah koneksi diinisialisasi.
    LinkKit.getInstance().init(params, new ILinkKitConnectListener() {
         @Override
         public void onError(AError aError) {
             System.out.println("Init error:" + aError);
         }
         // Implementasikan fungsi panggilan balik.
         @Override
         public void onInitDone(InitResult initResult) {
             System.out.println("Init done:" + initResult);
         }
     });

• Fungsi panggilan balik onInitDone() menggunakan awalan untuk mengidentifikasi topik siaran. Sintaks awalan topik adalah /sys/${productKey}/${deviceName}/broadcast/request/.

  public void onInitDone(InitResult initResult) {
  
                  // Konfigurasikan fungsi panggilan balik yang digunakan saat pesan downstream dikirim.
                  IConnectNotifyListener notifyListener = new IConnectNotifyListener() {
                      // Konfigurasikan fungsi panggilan balik yang digunakan setelah pesan downstream diterima.
                      @Override
                      public void onNotify(String connectId, String topic, AMessage aMessage) {
  
                          // Filter pesan yang diterima untuk mendapatkan pesan siaran.
                          if(topic.startsWith(broadcastTopic)){
                              System.out.println(
                                      "received broadcast message from topic=" + topic + ",\npayload=" + new String((byte[])aMessage.getData()));
                          }
  
                      }
  
                      @Override
                      public boolean shouldHandle(String s, String s1) {
                          return false;
                      }
  
                      @Override
                      public void onConnectStateChange(String s, ConnectState connectState) {
  
                      }
                  };
                  LinkKit.getInstance().registerOnNotifyListener(notifyListener);
              }

Mengonfigurasi SDK IoT Platform

Konfigurasikan SDK IoT Platform untuk Java untuk menyiarkan pesan.

• Tentukan informasi identitas untuk verifikasi.

   String regionId = "<yourRegionID>";
   String accessKey = "<yourAccessKey>";
   String accessSecret = "<yourAccessSecret>";
   final String productKey = "<yourProductKey>";

• Panggil operasi PubBroadcast dari IoT Platform untuk menyiarkan pesan.

  // Konfigurasikan parameter klien.
  DefaultProfile profile = DefaultProfile.getProfile(regionId, accessKey, accessSecret);
  IAcsClient client = new DefaultAcsClient(profile);
  PubBroadcastRequest request = new PubBroadcastRequest();
  // Konfigurasikan parameter productKey dari produk.
  request.setProductKey(productKey);
  // Konfigurasikan parameter MessageContent. Konten pesan harus dikodekan dalam Base64. Jika tidak, konten pesan akan ditampilkan sebagai karakter acak.
  request.setMessageContent(Base64.encode("{\"pwd\":\"2892nd6Y\"}"));
  // Tentukan ID instance.
  request.setIotInstanceId("iot-cn-***");

• Siarkan pesan.

  try {
      PubBroadcastResponse response = client.getAcsResponse(request);
  System.out.println("broadcast pub success: broadcastId =" + response.getMessageId());
  } catch (Exception e) {
      System.out.println(e);
  }

Verifikasi operasi

Konfigurasikan Link SDK pada perangkat untuk menghubungkan perangkat ke IoT Platform. Kemudian, konfigurasikan SDK IoT Platform untuk memanggil operasi PubBroadcast untuk menyiarkan pesan ke perangkat.

Gunakan SDK IoT Platform untuk mengirim pesan berikut ke perangkat: "{\"pwd\":\"2892nd6Y\"}".

Pesan berikut muncul di log lokal perangkat: {\"pwd\":\"2892nd6Y\"}.

Kunci Pintu 1:

Kunci Pintu 2:

Kunci Pintu 3:

Lampiran: Contoh kode

Anda dapat melihat contoh kode berikut dari SDK IoT Platform dan SDK perangkat:

• PubBroadcastDemo. Contoh kode digunakan untuk menyiarkan pesan ke semua perangkat online.
• BroadcastDemo. Contoh kode digunakan untuk menyiarkan pesan ke semua perangkat yang berlangganan ke topik tertentu.