Teknologi push adalah salah satu cara tercepat untuk menyampaikan notifikasi kepada pengguna aplikasi Anda. Untuk menerimanya, pengguna tidak perlu melakukan tindakan apa pun, dan tindakan tersebut dimulai di sisi server dan muncul langsung di bilah notifikasi di layar perangkat seluler. Dalam pelajaran ini, kita akan memahami cara mengimplementasikan notifikasi push dalam aplikasi yang dibangun di platform AppMaster .
Send Push
Untuk mengirim pemberitahuan push, blok Send Push digunakan yang sesuai dengan sistem operasi perangkat target ( iOS atau Android ).
Mendapatkan Push Token dan Bundle ID
Untuk melakukan pengiriman, Anda harus menentukan setidaknya dua parameter: Push Token dan IOS (Android) Bundle ID . Oleh karena itu, ada baiknya memulai dengan bagian persiapan dan mencari tahu cara mendapatkan parameter ini.
Secara default, setiap database proyek berisi model Mobile Instance yang ditautkan ke model User dan berisi kolom wajib diisi: push_token dan bundle_id .
Mari buat proses bisnis terpisah untuk aplikasi seluler, yang akan membentuk model Mobile Instance yang lengkap. Untuk mendapatkan token push, gunakan blok Get Push Token .
Langkah selanjutnya adalah mendapatkan informasi tentang perangkat. Dan di sini, tergantung pada sistem operasinya, diperlukan blok yang berbeda. Oleh karena itu, untuk menentukan sistem operasi, Anda harus menggunakan blok Platform Switch .
Bergantung pada hasilnya, blok IOS Device Info atau Android Device Info yang sesuai digunakan. Dari sana, Anda bisa mendapatkan berbagai informasi tentang perangkat, tetapi dalam contoh kami, cukup mengetahui Bundle ID saja.
Setelah mengumpulkan semua data, Anda dapat membentuk model Mobile Instance , menunjukkan sistem operasi yang dimilikinya dan meneruskannya sebagai parameter keluaran dari proses bisnis.
Merekam informasi tentang perangkat seluler pengguna
Langkah selanjutnya adalah membuat proses bisnis backend untuk menghubungkan Mobile Instance yang dibuat dengan pengguna tertentu dan merekam ke database. Proses bisnis ini membutuhkan hal-hal berikut:
- Cari tahu pengguna saat ini menggunakan Auth: Get current user .
- Luaskan konten model Mobile Instance yang dihasilkan.
- Pasang kembali model dan tambahkan koneksi pengguna ke dalamnya menggunakan blok Make Mobile Instance .
- Gunakan DB: Create Mobile Instance dan simpan data dalam database.
Di titik akhir POST /Mobile Instance/ , Anda dapat mengganti proses bisnis standar dengan yang baru saja dibuat.
Tahap akhir persiapan adalah memutuskan kapan tepatnya perlu menulis informasi tentang perangkat pengguna ke dalam database. Solusi logisnya adalah melakukan ini saat melakukan otorisasi dalam aplikasi. Untuk melakukan ini, segera setelah blok Set Auth Token , dua blok baru dengan proses bisnis yang dibuat sebelumnya harus ditambahkan ke proses otorisasi pengguna di aplikasi seluler. Yang pertama menerima dan menghasilkan informasi yang diperlukan, dan yang kedua membuat koneksi dengan pengguna dan menulis ke database.
Mengirim pemberitahuan push
Bagian persiapan selesai, dan Anda dapat mulai mengirim pemberitahuan push. Untuk melakukan ini, kami akan membuat proses bisnis backend. Bayangkan tugas kita adalah mengirimkan notifikasi ke semua pengguna aplikasi kita. Kami akan mengirimkannya hanya ke perangkat dengan sistem operasi Android dan tidak ke semua perangkat pengguna, tetapi hanya ke perangkat yang terakhir digunakan.
Mari kita mulai dengan parameter masukan. Perlu untuk mentransfer teks pemberitahuan itu sendiri. Ini terdiri dari tiga bagian: badan pesan ( body ), judulnya ( title ), dan subjudul ( subtitle ).
Selanjutnya, Anda perlu menemukan semua pengguna aplikasi. Untuk melakukan ini, gunakan blok Search User dan atur parameter yang diperlukan:
- _With = Mobile Instances (Anda tidak hanya perlu mendapatkan informasi tentang pengguna, tetapi juga tentang perangkat seluler yang terkait dengannya)
- Limit = -1 (secara default, kueri mengembalikan 25 catatan, "-1" ditentukan untuk menghapus batas ini dan mendapatkan semua pengguna)
- _mobile_instances_os = Android (sesuai ketentuan tugas, kami hanya tertarik pada perangkat Android )
Untuk array pengguna yang dihasilkan, Anda perlu menjalankan siklus operasi ( For each loop )
Untuk setiap pengguna dari blok Expand User , Anda perlu mendapatkan informasi tentang perangkat seluler ( Mobile Instances ). Kami hanya perlu mengirim pemberitahuan ke satu perangkat, jadi kami menetapkan index = 0 di blok Array Element dan juga memeriksa apakah array berisi setidaknya satu elemen sama sekali (setelah semua, pengguna hanya dapat memiliki perangkat iOS ). Untuk melakukan ini, kami memeriksa validitas elemen, meneruskan nilai indeks yang valid ke blok If-Else , dan melanjutkan pengulangan hanya jika nilainya true .
Jika semuanya benar dan informasi tentang perangkat pengguna ditemukan, maka Anda perlu menggunakan blok Expand Mobile Instance dan meneruskan nilai yang diperlukan ke blok Send Push (Android) .
Perlu diketahui bahwa saat mengembangkan dan menguji aplikasi di Developer App , Anda harus menyetel Developer Mode = True .
Anda juga dapat menggunakan opsi TTL (Time to live) . Ini menentukan waktu dalam detik untuk pemberitahuan dikirim. Jika notifikasi tidak dapat segera dikirimkan, misalnya jika pengguna berada di luar jangkauan untuk sementara, maka upaya pengiriman berulang akan dilakukan pada waktu yang ditentukan.
Di akhir siklus dan mengirimkan pemberitahuan ke semua pengguna yang memungkinkan, pekerjaan proses bisnis juga selesai.
Parameter tambahan
Secara terpisah, ada baiknya membahas parameter tambahan dari blok kirim:
- Push ID
- Push Class
- Data
Mereka tidak memengaruhi fakta pengiriman notifikasi atau kontennya, tetapi dapat digunakan saat memproses notifikasi di sisi pengguna. Aplikasi seluler memiliki pemicu khusus yang diaktifkan saat pemberitahuan push yang diterima diterima atau diklik.
Pemicu pemberitahuan push berisi data dari parameter teks tambahan di atas. Sebagai contoh, kami dapat memberikan proses paling sederhana, yang ketika pemicu diklik, akan menampilkan pemberitahuan lebih lanjut di layar dengan informasi yang dikirimkan dalam parameter Data .
Kasus penggunaan populer lainnya untuk pemicu adalah mengumpulkan informasi tentang pengiriman notifikasi. Misalnya, mereka dapat mengirim pesan ke server yang menyatakan bahwa pemberitahuan Push memang telah dikirimkan, serta mengumpulkan statistik dan menghitung jumlah klik pada pemberitahuan.
