Tạo và xử lý điều kiện kích hoạt sự kiện tuỳ chỉnh

Với Cloud Functions (thế hệ thứ 2), bạn có thể kích hoạt các hàm để phản hồi sự kiện tuỳ chỉnh. Đây là những sự kiện do các trình cung cấp sự kiện đặc biệt hoặc bổ sung cung cấp, trái ngược với các sự kiện Firebase được SDK Firebase cho Cloud Functions hỗ trợ tự nhiên. Thông qua trình kích hoạt sự kiện tuỳ chỉnh, ứng dụng của bạn có thể phản hồi các sự kiện do Tiện ích Firebase cung cấp hoặc bạn có thể xuất bản sự kiện tuỳ chỉnh và hàm kích hoạt để phản hồi các sự kiện đó.

Lưu ý: Tính năng này đang ở giai đoạn dùng thử công khai. Điều này có nghĩa là chức năng này có thể thay đổi theo những cách không tương thích ngược. Bản phát hành xem trước không phải tuân thủ bất kỳ chính sách nào về SLA hoặc việc ngừng sử dụng, đồng thời có thể được hỗ trợ hạn chế hoặc không được hỗ trợ.

Tất cả các sự kiện tuỳ chỉnh đều tuân thủ định dạng sự kiện JSON CloudEvents và được phát hành lên Eventarc. Áp dụng phí sử dụng tổ chức sự kiện.

Kích hoạt hàm bằng sự kiện tuỳ chỉnh

Bạn có thể xuất bản sự kiện tuỳ chỉnh (hoặc nhận sự kiện từ tiện ích Firebase) và kích hoạt các hàm kích hoạt để phản hồi những sự kiện đó bằng cách triển khai quy trình cơ bản sau:

1. Xuất bản các sự kiện mong muốn lên kênh Eventarc hoặc xác định các sự kiện có sẵn do tiện ích mà bạn đã cài đặt cung cấp.
2. Trong mã hàm, hãy đăng ký các sự kiện trên kênh Eventarc bằng trình xử lý sự kiện.
3. Trong hàm này, hãy phân tích cú pháp tải trọng được trả về trong đối tượng CloudEvent và thực hiện bất kỳ logic tuỳ chỉnh nào mà ứng dụng của bạn yêu cầu.

Ví dụ: một ứng dụng trò chơi có thể muốn gửi thông báo cho người dùng khi họ tham gia hoặc rời khỏi bảng xếp hạng của 10 đối thủ cạnh tranh hàng đầu. Ứng dụng này có thể phát hành các sự kiện trong bảng xếp hạng lên kênh mặc định, sau đó xử lý sự kiện trong một hàm gửi thông báo đẩy được nhắm mục tiêu cho người dùng.

Trong một ví dụ khác, một tiện ích được thiết kế để giúp các ứng dụng xử lý hình ảnh lớn có thể phát ra một sự kiện sau khi hoàn tất việc đổi kích thước hình ảnh. Các ứng dụng đã cài đặt tiện ích này có thể xử lý sự kiện hoàn thành bằng cách cập nhật các đường liên kết trong ứng dụng để trỏ đến các phiên bản đã đổi kích thước của hình ảnh.

Xuất bản sự kiện lên kênh

Các sự kiện Eventarc được xuất bản thành kênh. Kênh là một cách để nhóm các sự kiện liên quan và quản lý quyền truy cập. Khi bạn cài đặt một tiện ích hoặc triển khai một hàm sử dụng các sự kiện tuỳ chỉnh, Firebase sẽ tự động tạo một kênh mặc định có tên là firebase ở khu vực us-central1. SDK quản trị của Firebase cung cấp một gói con eventarc để phát hành lên các kênh.

Cách phát hành sự kiện từ một máy chủ đáng tin cậy (hoặc một hàm khác) bằng kênh mặc định:

import {getEventarc} from 'firebase-admin/eventarc';

getEventarc().channel().publish({
    type: 'achieved-leaderboard',
    subject: 'Welcome to the top 10',
    data: {
      message: 'You have achieved the nth position in our leaderboard!  To see . . .'
    }
});

Ngoài việc tự động tạo kênh mặc định, Firebase còn đặt biến môi trường EVENTARC_CLOUD_EVENT_SOURCE để chỉ định nguồn của sự kiện. Nếu đang xuất bản các sự kiện bên ngoài Cloud Functions cho Firebase, bạn cần thêm trường source một cách rõ ràng trong phần tải trọng sự kiện.

Xử lý sự kiện tuỳ chỉnh

Bạn có thể xử lý tất cả các sự kiện tuỳ chỉnh, bao gồm cả sự kiện tiện ích, bằng trình xử lý onCustomEventPublished hoặc on_custom_event_published. Trước tiên, hãy nhập trình xử lý này từ SDK Eventarc cùng với SDK quản trị của Firebase:

Node.js

const {onCustomEventPublished} = require("firebase-functions/v2/eventarc");
const logger = require("firebase-functions/logger");
const {initializeApp} = require("firebase-admin/app");
const {getFirestore} = require("firebase-admin/firestore");
index.js

Python

from firebase_admin import firestore, initialize_app
from firebase_functions import eventarc_fn
main.py

Trong mã hàm, hãy truyền vào tên sự kiện như minh hoạ cho hàm ví dụ:

Node.js

exports.onimageresized = onCustomEventPublished(
    "firebase.extensions.storage-resize-images.v1.complete",
    (event) => {
      logger.info("Received image resize completed event", event);
      // For example, write resized image details into Firestore.
      return getFirestore()
          .collection("images")
          .doc(event.subject.replace("/", "_")) // original file path
          .set(event.data); // resized images paths and sizes
    });
index.js

Python

@eventarc_fn.on_custom_event_published(
    event_type="firebase.extensions.storage-resize-images.v1.complete")
def onimageresized(event: eventarc_fn.CloudEvent) -> None:
    print("Received image resize completed event: ", event.type)

    if not isinstance(event.subject, str):
        print("No 'subject' data.")
        return

    # For example, write resized image details into Firestore.
    firestore_client: google.cloud.firestore.Client = firestore.client()
    collection = firestore_client.collection("images")
    doc = collection.document(event.subject.replace("/", "_"))  # original file path
    doc.set(event.data)  # resized images paths and sizes
main.py

Đối với mỗi tiện ích cụ thể, tải trọng được trả về trong đối tượng sự kiện sẽ cung cấp dữ liệu mà bạn có thể sử dụng để thực hiện logic tuỳ chỉnh cho luồng ứng dụng của mình. Trong trường hợp này, hàm này sử dụng SDK quản trị để sao chép siêu dữ liệu về hình ảnh đã đổi kích thước vào một bộ sưu tập trong Cloud Firestore, lấy tên tệp từ subject do sự kiện cung cấp và lưu siêu dữ liệu từ data do sự kiện cung cấp.

Xuất bản và xử lý sự kiện trên các kênh không phải kênh mặc định

Kênh tuỳ chỉnh có thể hữu ích cho những trường hợp bạn có nhu cầu đặc biệt về quyền hoặc các yêu cầu khác và không muốn có cùng một mức độ hiển thị và quyền truy cập cho mọi sự kiện. Bạn có thể tạo các kênh của riêng mình bằng bảng điều khiển Google Cloud. Việc xuất bản và đăng ký sự kiện phải được thực hiện trên cùng một kênh.

Trong trường hợp sự kiện tuỳ chỉnh được xuất bản trên một kênh không phải kênh mặc định, bạn cần chỉ định kênh đó trong mã hàm. Ví dụ: nếu muốn xử lý các sự kiện được xuất bản trong một kênh không phải kênh mặc định cho vị trí us-west1, bạn cần chỉ định kênh như sau:

Node.js

import { onCustomEventPublished } from "firebase-functions/v2/eventarc";

export const func = onCustomEventPublished(
    {
      eventType: "firebase.extensions.storage-resize-images.v1.complete",
      channel: "locations/us-west1/channels/firebase",
      region: "us-west1",
    },
    (event) => { ... });

Python

@eventarc_fn.on_custom_event_published(
    event_type="firebase.extensions.storage-resize-images.v1.complete",
    channel="locations/us-west1/channels/firebase",
    region="us-west1")
def onimageresizedwest(event: eventarc_fn.CloudEvent) -> None:
    print("Received image resize completed event: ", event.type)
    # ...
main.py