Uzantınızı yükleyen kullanıcılara kendi uzantılarını ekleme olanağı sağlayabilirsiniz. özel bir mantık yürütmeniz gerekir. Paydaşlarla iletişime geçmenin bunu yap:
Eventarc etkinlikleri: kullanıcılara eşzamansız olarak tepki vermeleri için bir yöntem sunar. etkinlikleri Eventarc'ta yayınlayabilirsiniz. Kullanıcılar etkinlik işleyiciyi dağıtabilir uzun süre çalıştıktan sonra bildirim gönderen işlevler gibi ya da kendi işleme sonrası işlevlerini tanımlayabilirler.
Eşzamanlı kancalar: Kullanıcıların uygulamanıza engelleme mantığı eklemelerini uzantısından sonra daha fazla bilgi edinin. Bu noktalarda, bir kullanıcı sağlayıcısı işlevi ve yalnızca anket tamamlandıktan sonra devam edin. Ön işleme görevleri genellikle bu kategoridedir.
Uzantılar, bu yöntemlerden birini veya her ikisini birden kullanabilir.
Eventarc etkinlikleri
Bir uzantıdan etkinlik yayınlamak için:
Yayınlayacağınız etkinlik türlerini
extension.yaml
dosyasında bildirin:events: - type: publisher-id.extension-name.version.event-name description: event-description - type: publisher-id.extension-name.version.another-event-name description: another-event-description
type
tanımlayıcısı, noktayla ayrılmış birkaç alandan oluşur. İlgili içeriği oluşturmak için kullanılan yayıncı kimliği, uzantı adı ve etkinlik adı alanları gereklidir. Sürüm alanının doldurulması önerilir. Benzersiz ve açıklayıcı bir ad seçin etkinlik adı ekleyin.Örneğin,
storage-resize-images
uzantısı tek bir etkinlik türü bildirir:events: - type: firebase.extensions.storage-resize-images.v1.complete description: | Occurs when image resizing completes. The event will contain further details about specific formats and sizes.
Kullanıcılar, abone olduklarında hangi etkinliklere abone olacaklarını seçebilirler uzantıyı yükleyin.
Uzantı işlevlerinizde, Admin SDK içinden Eventarc API'yi içe aktarın ve kullanıcının yükleme ayarlarını kullanarak bir etkinlik kanalını başlatın. Bu ayarlar, aşağıdaki ortam değişkenleri kullanılarak gösterilir:
EVENTARC_CHANNEL
: Kullanıcının etkinlikleri yayınlamayı tercih ettiği.EXT_SELECTED_EVENTS
: Kullanıcının etkinlik türlerinin virgülle ayrılmış listesi yayınlamayı seçti. Bu değerle bir kanalı başlattığınızda Yönetici SDK'sı, kullanıcının seçmediği etkinlikleri otomatik olarak filtreler.EVENTARC_CLOUD_EVENT_SOURCE
: Bulut Etkinliği kaynağı tanımlayıcısı. İlgili içeriği oluşturmak için kullanılan Admin SDK, bu değeri otomatik olaraksource
alanına iletir. yayınlanmış etkinlik olabilir. Genellikle bunu açıkça belirtmeniz gerekmez değişkenine eklenmelidir.
Etkinlikler yükleme sırasında etkinleştirilmemişse bu değişkenler tanımlanmadı. Bu bilgiyi bir etkinlik kanalını başlatmak için yalnızca şu durumlarda kullanabilirsiniz: etkinlikler etkinleştirildiğinde:
import * as admin from "firebase-admin"; import {getEventarc} from 'firebase-admin/eventarc'; admin.initializeApp(); // Set eventChannel to a newly-initialized channel, or `undefined` if events // aren't enabled. const eventChannel = process.env.EVENTARC_CHANNEL && getEventarc().channel(process.env.EVENTARC_CHANNEL, { allowedEventTypes: process.env.EXT_SELECTED_EVENTS, });
Uzantınızda yayınlamak istediğiniz noktalarda kanalda etkinlik yayınlayın ortaya çıkarmasını sağlamaya yardımcı olur. Örneğin:
// If events are enabled, publish a `complete` event to the configured // channel. eventChannel && eventChannel.publish({ type: 'firebase.extensions.storage-resize-images.v1.complete', subject: filename, // the name of the original file data: { // ... } });
Yayınladığınız etkinlikleri PREINSTALL veya POSTINSTALL görünümünde kaydedin. dosyası olarak kaydedebilirsiniz.
Her etkinlik için aşağıdakileri belgeleyin:
- Kullanım amacı
- Uzantınızın mantığında çalıştığı nokta
- İçerdiği çıkış verileri
- Yürütme koşulları
Ayrıca, kullanıcıları etkinliklerinde herhangi bir işlem yapmamaları konusunda uyarın ve dolayısıyla sonsuz bir uzantıya neden olabilen ve aynı uzantıyı tetikleyebilecek döngüde bulabilirsiniz.
Bir uzantıdan etkinlik yayınladığınızda kullanıcılar etkinlik işleyicileri dağıtabilir özel mantıkla yanıt vermesi gerekir.
Örneğin, aşağıdaki örnekte orijinal resim, resim yüklendikten sonra
yeniden boyutlandırıldı. Bu örnek işleyicinin, subject
Bu etkinlik, bu örnekte resmin orijinal dosya adıdır.
exports.onimageresized = onCustomEventPublished(
"firebase.extensions.storage-resize-images.v1.complete",
(event) => {
logger.info("Received image resize completed event", event);
// For example, delete the original.
return admin.storage()
.bucket("my-project.appspot.com")
.file(event.subject)
.delete();
});
Daha fazla bilgi için Özel etkinlik tetikleyicileri bölümüne bakın ekleyebilirsiniz.
Örnek
Resmi Yeniden Boyutlandırma uzantısı Eventarc'ta yayınlayarak eşzamansız bir kanca sağlar. yeniden boyutlandırdıktan sonra.
Eşzamanlı kancalar
Kullanıcılara başarıyla tamamlanması gereken bir kanca sağlamak istediğinizde Uzantı işlevlerinden birinin çalışması için eşzamanlı kancalar kullanın.
Eşzamanlı bir kanca, kullanıcı tanımlı bir HTTPS çağrılabilir Cloud işlevi gerektirir ve tamamlanmayı bekler (muhtemelen bir değer döndürdüğü için) bakın. Kullanıcı tarafından sağlanan işlevde hata uzantı işlevinde bir hataya neden olur.
Eşzamanlı bir kancayı göstermek için:
Uzantınıza, kullanıcıların uzantısıyla birlikte özel Cloud Functions işlevine de yönlendirir. Örneğin:
- param: PREPROCESSING_FUNCTION label: Pre-processing function URL description: > An HTTPS callable function that will be called to transform the input data before it is processed by this function. type: string example: https://us-west1-my-project-id.cloudfunctions.net/preprocessData required: false
Uzantınızda kancayı göstermek istediğiniz noktada işlevini kullanmanız gerekir. Örneğin:
const functions = require('firebase-functions/v1'); const fetch = require('node-fetch'); const preprocessFunctionURL = process.env.PREPROCESSING_FUNCTION; exports.yourFunctionName = functions.firestore.document("collection/{doc_id}") .onWrite((change, context) => { // PREPROCESSING_FUNCTION hook begins here. // If a preprocessing function is defined, call it before continuing. if (preprocessFunctionURL) { try { await fetch(preprocessFunctionURL); // Could also be a POST request if you want to send data. } catch (e) { // Preprocessing failure causes the function to fail. functions.logger.error("Preprocessor error:", e); return; } } // End of PREPROCESSING_FUNCTION hook. // Main function logic follows. // ... });
ÖN YÜKLEME veya ÖN YÜKLEME içinde kullanıma sunduğunuz kancaları belgeleyin. POSTINSTALL dosyası.
Her bir kanca için aşağıdakileri belgeleyin:
- Kullanım amacı
- Uzantınızın mantığında çalıştığı nokta
- Beklenen giriş ve çıkışları
- Yürütme koşulları (veya seçenekleri)
Ayrıca, kullanıcıları kancada herhangi bir işlem yapmamaları konusunda uyarın aynı uzantıyı tetikleyebilecek ve sonuç olarak sonsuz döngüde bulabilirsiniz.
Örnek
Algolia Arama uzantısı Kullanıcı tarafından sağlanan bir dönüştürme işlevini çağırmak için eşzamanlı bir kanca sağlar. her şeyi gözden geçireceğiz.