Chuyển tới nội dung chính

Events

Events là các tín hiệu có tên (thông điệp mà animation của bạn gửi ra tại một thời điểm cụ thể) được phát ra từ scene Rive. Một timeline có thể phát ra một event tại một frame cụ thể, một state machine có thể phát ra event khi vào hoặc rời khỏi một state, và code runtime có thể lắng nghe chúng.

Dùng Events để:

  • Kích hoạt hiệu ứng âm thanh hoặc haptic từ một frame animation
  • Mở URL khi người dùng nhấn vào một button animation
  • Thông báo cho app rằng animation đã đến một điểm cụ thể

Các Loại Event​

LoạiMô tả
Open URLMở một địa chỉ web. Cấu hình URL và chọn mở trong tab hiện tại hay tab mới.
AudioKích hoạt một file âm thanh. Yêu cầu asset âm thanh đã được import.
GeneralTín hiệu thông thường với tên tùy chỉnh. Dùng để thông báo cho code runtime.
ghi chú

Tài liệu cũ của Rive có thể đề cập đến hệ thống "General Event" đã bị loại bỏ. Cách tiếp cận hiện tại sử dụng các General event được đặt tên (như mô tả trên trang này). Bạn có thể bỏ qua mọi tham chiếu đến hệ thống cũ.

Tạo Event​

1
Mở panel Events

Chọn Events tool từ Toolbar và click vào artboard. Panel Events xuất hiện trong Inspector.

2
Đặt tên event

Nhập tên vào trường Name, hoặc double-click vào event trên artboard để đổi tên.

3
Chọn loại

Chọn Open URL, Audio, hoặc General từ dropdown loại.

4
Cấu hình thuộc tính theo loại

Với Open URL: đặt URL và tab target. Với Audio: chọn asset âm thanh và đặt âm lượng. General event không có cấu hình thêm.

Phát Tín Hiệu Events​

Một event không làm gì cho đến khi có thứ gì đó kích hoạt nó. Bạn có thể phát tín hiệu event từ bốn nơi.

Từ một Timeline​

Trong chế độ Animate, chọn animation. Click Report Event trong điều khiển Timeline, sau đó kéo marker đến frame mà event sẽ được phát ra.

Từ một State​

Chọn một state node trong State Machine Graph. Trong Inspector, click + bên cạnh Events và chọn thời điểm kích hoạt: Start hoặc End của state.

Từ một Transition​

Chọn mũi tên transition. Trong Inspector, click + bên cạnh Events để phát event khi transition bắt đầu.

Từ một Listener​

Trong Action của Listener, chọn Report Event và chọn event cần phát khi điều kiện Listener được thỏa mãn.

Nhận Events Tại Runtime​

Lập trình viên có thể lắng nghe events trong code. Khi scene Rive phát ra một event, nó sẽ gửi tên event và bất kỳ dữ liệu đính kèm nào đến một listener function (một hàm tự động chạy khi có sự kiện xảy ra) trong app.

Events Reference

Tài liệu API đầy đủ cho Open URL, Audio và General events.
Listeners

Phát events từ tương tác người dùng bằng Listeners.