Mulai Cepat: Menyiapkan pemberitahuan push di hub pemberitahuan

Microsoft Azure Notification Hubs menyediakan mesin push yang mudah digunakan dan yang meluaskan skala. Gunakan Notification Hubs untuk mengirim pemberitahuan ke platform apa pun (iOS, Android, Windows, Baidu) dan dari ujung belakang apa pun (cloud atau lokal). Untuk informasi selengkapnya, lihat Apa itu Microsoft Azure Notification Hubs?.

Dalam panduan mulai cepat ini, Anda akan menggunakan pengaturan sistem pemberitahuan platform (PNS) di Notification Hubs untuk mengatur pemberitahuan push di beberapa platform. Panduan mulai cepat ini menunjukkan langkah-langkah yang harus diambil di portal Microsoft Azure. Google Firebase Cloud Messaging menyertakan instruksi untuk menggunakan Azure CLI.

Catatan

Untuk informasi tentang langkah-langkah penghentian dan migrasi Firebase Cloud Messaging, lihat migrasi Google Firebase Cloud Messaging.

Jika Anda belum membuat hub pemberitahuan, buat sekarang. Untuk informasi selengkapnya, lihat Membuat hub pemberitahuan Azure di portal Microsoft Azure atau Membuat hub pemberitahuan Azure menggunakan Azure CLI.

Layanan Pemberitahuan Push Apple

Untuk mengatur Layanan Pemberitahuan Push Apple (APNS):

1. Di portal Microsoft Azure, pada halaman Hub Pemberitahuan, pilih Apple (APNS) dari menu sebelah kiri.

2. Untuk Mode Autentikasi, pilih Sertifikat atau Token.

   a. Jika Anda memilih Sertifikat:

   • Pilih ikon file, lalu pilih file .p12 yang ingin diunggah.

   • Masukkan kata sandi.

   • Pilih mode Kotak pasir. Jika Anda ingin mengirim pemberitahuan push kepada pengguna yang membeli aplikasi Anda dari toko, pilih mode Produksi.

     

   b. Jika Anda memilih Token:

   • Masukkan nilai untuk ID Kunci, ID Bundel, ID Tim, serta Token.

   • Pilih mode Kotak pasir. Jika Anda ingin mengirim pemberitahuan push kepada pengguna yang membeli aplikasi Anda dari toko, pilih mode Produksi.

     

Untuk informasi selengkapnya, lihat Mengirim pemberitahuan push ke aplikasi iOS menggunakan Microsoft Azure Notification Hubs.

Google Firebase Cloud Messaging (FCM)

Portal

Untuk menyiapkan pemberitahuan push untuk Google FCM:

1. Di portal Microsoft Azure, pada halaman Notification Hub, pilih Google (GCM/FCM) dari menu sebelah kiri.

2. Tempel Kunci API untuk proyek Google FCM yang Anda simpan sebelumnya.

3. Pilih Simpan.

   

Saat Anda menyelesaikan langkah-langkah ini, pemberitahuan menunjukkan bahwa hub pemberitahuan telah berhasil diperbarui. Tombol Simpan dinonaktifkan.

Azure CLI

Anda akan memerlukan Kunci API untuk proyek Google Firebase Cloud Messaging (FCM) Anda.

Persiapkan lingkungan Anda untuk Azure CLI

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.

  

• Jika Anda lebih memilih untuk menjalankan perintah referensi CLI secara lokal, pasang Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.

  • Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.

  • Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.

  • Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.

• Artikel ini memerlukan CLI Azure versi 2.0.67 atau yang lebih baru. Jika ingin menggunakan Azure Cloud Shell, versi terbarunya sudah terpasang.

Menyiapkan pemberitahuan push untuk Google FCM

1. Gunakan perintah az notification-hub credential gcm update untuk menambahkan kunci Google API ke hub pemberitahuan.

   az notification-hub credential gcm update --resource-group spnhubrg --namespace-name spnhubns    --notification-hub-name spfcmtutorial1nhub --google-api-key myKey
   

2. Aplikasi Android memerlukan string koneksi untuk tersambung dengan hub pemberitahuan. Gunakan perintah az notification-hub authorization-rule list untuk mencantumkan kebijakan akses yang tersedia. Gunakan perintah az notification-hub authorization-rule list-keys untuk mendapatkan string koneksi kebijakan akses. Tentukan primaryConnectionString atau secondaryConnectionString dalam --query parameter untuk mendapatkan string koneksi utama secara langsung.

   #list access policies for a notification hub
   az notification-hub authorization-rule list --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --output table
   
   #list keys and connection strings for a notification hub access policy
   az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --output json
   
   #get the primaryConnectionString for an access policy
   az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --query primaryConnectionString
   

3. Gunakan perintah az notification-hub test-send untuk menguji pengiriman pesan ke Aplikasi Android.

   #test with message body
   az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --message "my message body"
   
   #test with JSON string
   az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --payload "{\"data\":{\"message\":\"my JSON string\"}}"
   

Dapatkan referensi Azure CLI untuk platform lain dengan perintah az notification-hub credential.

Untuk informasi selengkapnya tentang cara mengirim pemberitahuan ke aplikasi Android, lihat Mengirim pemberitahuan push ke perangkat Android menggunakan Firebase.

Layanan Pemberitahuan Push Windows

Untuk menyiapkan Layanan Pemberitahuan Push Windows (WNS):

1. Di portal Microsoft Azure, pada halaman Hub Pemberitahuan, pilih Windows (WNS) dari menu sebelah kiri.

2. Masukkan nilai untuk Paket SID dan Kunci Keamanan.

3. Pilih Simpan.

   

Untuk informasi selengkapnya, lihat Mengirim pemberitahuan ke aplikasi UWP menggunakan Microsoft Azure Notification Hubs.

Layanan Pemberitahuan Push Microsoft untuk Windows Phone

Catatan

Microsoft Push Notification Service (MPNS) tidak lagi digunakan dan tidak lagi didukung.

Untuk menyiapkan Layanan Pemberitahuan Push Microsoft (MPNS) untuk Windows Phone:

1. Di portal Microsoft Azure, pada halaman Hub Pemberitahuan, pilih Windows Phone (MPNS) dari menu sebelah kiri.

2. Aktifkan pemberitahuan push yang tidak diautentikasi atau diautentikasi:

   a. Untuk mengaktifkan pemberitahuan push yang tidak diautentikasi, pilih Aktifkan push yang tidak diautentikasi>Simpan.

   

   b. Untuk mengaktifkan pemberitahuan push terautentikasi:

   • Pada toolbar, pilih Unggah Sertifikat.
   • Pilih ikon file, lalu pilih file sertifikat.
   • Masukkan kata sandi untuk sertifikat.
   • PilihOK.
   • Pada halaman Windows Phone (MPNS), pilih Simpan.

Untuk informasi selengkapnya, lihat Pemberitahuan push ke aplikasi Windows Phone dengan menggunakan Notification Hubs.

Baidu (Android China)

Untuk menyiapkan pemberitahuan push untuk Baidu:

1. Di portal Microsoft Azure, pada halaman Hub Pemberitahuan, pilih Baidu (Android China) dari menu sebelah kiri.

2. Masukkan Kunci API yang Anda peroleh dari konsol Baidu di proyek push cloud Baidu.

3. Masukkan Kunci Rahasia yang Anda peroleh dari konsol Baidu di proyek push cloud Baidu.

4. Pilih Simpan.

   

Saat Anda menyelesaikan langkah-langkah ini, pemberitahuan menunjukkan bahwa hub pemberitahuan telah berhasil diperbarui. Tombol Simpan dinonaktifkan.

Untuk informasi selengkapnya, lihat Memulai Notification Hubs dengan menggunakan Baidu.

Langkah berikutnya

Dalam panduan mulai cepat ini, Anda telah mempelajari cara mengonfigurasi pengaturan sistem pemberitahuan platform untuk hub pemberitahuan di portal Microsoft Azure.

Untuk mempelajari lebih lanjut cara mengirim pemberitahuan push ke berbagai platform, lihat tutorial berikut:

• Mengirim pemberitahuan push ke aplikasi iOS menggunakan Microsoft Azure Notification Hubs
• Mengirim pemberitahuan ke perangkat Android menggunakan Notification Hubs dan Google FCM
• Mengirim pemberitahuan ke aplikasi UWP yang berjalan di perangkat Windows
• Mengirim pemberitahuan ke aplikasi Windows Phone 8 menggunakan MPNS
• Mengirim pemberitahuan menggunakan Notification Hubs dan push cloud Baidu