Events
Events adalah sinyal bernama (pesan yang dikirimkan animasi Anda pada momen tertentu) yang dikirim dari scene Rive Anda. Sebuah timeline dapat mengirimkan event pada frame tertentu, state machine dapat mengirimnya saat memasuki atau meninggalkan sebuah state, dan kode runtime dapat mendengarkannya.
Gunakan Events untuk:
- Memicu efek suara atau haptics dari frame animasi
- Membuka URL saat pengguna mengetuk animasi tombol
- Memberi tahu aplikasi Anda bahwa animasi telah mencapai titik tertentu
Jenis Event
| Jenis | Deskripsi |
|---|---|
| Open URL | Membuka alamat web. Konfigurasikan URL dan apakah dibuka di tab yang sama atau tab baru. |
| Audio | Memicu file audio. Memerlukan aset audio yang sudah diimpor. |
| General | Sinyal generik dengan nama kustom. Digunakan untuk memberi tahu kode runtime. |
Dokumentasi Rive yang lebih lama mungkin menyebut sistem "General Event" yang sudah tidak digunakan lagi. Pendekatan saat ini menggunakan event General bernama (seperti yang dijelaskan di halaman ini). Anda dapat mengabaikan referensi ke sistem lama tersebut.
Membuat Event
Pilih Events tool dari Toolbar dan klik artboard. Panel Events akan muncul di Inspector.
Ketik nama di kolom Name, atau klik dua kali event di artboard untuk mengganti namanya.
Pilih Open URL, Audio, atau General dari dropdown jenis.
Untuk Open URL: atur URL dan target tab. Untuk Audio: pilih aset audio dan atur volume. Event General tidak memiliki konfigurasi tambahan.
Mengirimkan Events
Sebuah event tidak akan melakukan apa pun sampai ada sesuatu yang mengaktifkannya. Anda dapat mengirimkan event dari empat tempat.
Dari Timeline
Di mode Animate, pilih animasi. Klik Report Event di kontrol Timeline, lalu seret penanda ke frame tempat event harus dikirimkan.
Dari State
Pilih node state di State Machine Graph. Di Inspector, klik + di sebelah Events dan pilih kapan akan dikirimkan: Start atau End dari state tersebut.
Dari Transition
Pilih panah transition. Di Inspector, klik + di sebelah Events untuk mengirimkan event saat transition dimulai.
Dari Listener
Di Action sebuah Listener, pilih Report Event dan pilih event yang akan dikirimkan saat kondisi Listener terpenuhi.
Menerima Events di Runtime
Developer dapat mendengarkan event di dalam kode. Saat scene Rive mengirimkan sebuah event, nama event beserta data yang terlampir diteruskan ke fungsi listener (fungsi yang berjalan otomatis ketika sesuatu terjadi) di aplikasi.
Referensi API lengkap untuk event Open URL, Audio, dan General.
Kirimkan event dari interaksi pengguna menggunakan Listeners.