Firebase Cloud Messaging (FCM)。
函数
| 函数 | 说明 |
|---|---|
| getMessaging(应用) | 获取默认应用或指定应用的 Messaging 服务。可调用admin.messaging()且不使用任何参数，以访问默认应用的 Messaging 服务，或以 admin.messaging(app) 的形式访问Messaging与特定应用相关联的服务。 |
类
| 类 | 说明 |
|---|---|
| 消息传送 | 将消息传递服务绑定到提供的应用。 |
接口
| 接口 | 说明 |
|---|---|
| Android 配置 | 表示可包含在 Message 中的 Android 专用选项。 |
| AndroidFcmOptions | 表示 FCM SDK for Android 提供的功能的选项。 |
| AndroidNotification | 表示可包含在 AndroidConfig 中的 Android 专用通知选项。 |
| ApnsConfig | 表示可包含在 Message 中的 APNs 专用选项。如需了解 APNs 支持的各种标头和载荷字段，请参阅 Apple 文档。 |
| ApnsFcmOptions | 表示 iOS 版 FCM SDK 所提供功能的选项。 |
| ApnsPayload | 表示 APNs 消息的载荷。主要由 aps 字典组成。但还可能包含其他任意自定义键。 |
| Aps | 表示属于 APNs 消息一部分的 aps 字典。 |
| ApsAlert | |
| BaseMessage | |
| BatchResponse | 表示来自 Messaging.sendAll() 和 Messaging.sendMulticast() 方法的服务器响应的接口。 |
| ConditionMessage | |
| 关键声音 | 表示可包含在 APNs 载荷的 aps 字典中的关键声音配置。 |
| DataMessagePayload | 表示 FCM 旧版 API 数据消息载荷的接口。数据消息允许开发者发送不超过 4KB 的自定义键值对。键和值都必须是字符串。键可以是任何自定义字符串，但以下保留字符串除外：
|
| FcmOptions | 表示 FCM SDK 所提供功能的平台无关选项。 |
| 灯设置 | 表示用于控制可包含在 AndroidNotification 中的通知 LED 的设置。 |
| MessagingConditionResponse | 表示来自旧版 Messaging.sendToCondition() 方法的服务器响应的接口。如需查看代码示例和详细文档，请参阅发送到条件。 |
| MessagingDeviceGroupResponse | 表示来自 Messaging.sendToDeviceGroup() 方法的服务器响应的接口。如需查看代码示例和详细文档，请参阅向设备组发送消息。 |
| MessagingDeviceResult | 单个设备的各个状态响应载荷 |
| MessagingDevicesResponse | 表示通过 FCM 旧版 API 发送到个别设备的消息的状态的接口。如需代码示例和详细文档，请参阅发送到个别设备。 |
| MessagingOptions | 表示通过 FCM 旧版 API 发送消息时提供的选项的接口。如需查看代码示例和详细文档，请参阅构建发送请求。 |
| MessagingPayload | 表示 Firebase Cloud Messaging 消息载荷的接口。必须提供 data 和/或 notification 键。如需查看代码示例和详细文档，请参阅构建发送请求。 |
| MessagingTopicManagementResponse | 表示来自 Messaging.subscribeToTopic() 和 Messaging.unsubscribeFromTopic() 方法的服务器响应的接口。如需查看代码示例和详细文档，请参阅从服务器管理主题。 |
| MessagingTopicResponse | 表示来自旧版 Messaging.sendToTopic() 方法的服务器响应的接口。如需查看代码示例和详细文档，请参阅发送到主题。 |
| 多播消息 | Messaging.sendMulticast() 方法的载荷。载荷包含 BaseMessage 类型中的所有字段，以及令牌列表。 |
| 通知 | 可包含在消息 中的通知。 |
| NotificationMessagePayload | 表示 FCM 旧版 API 通知消息载荷的接口。通知消息允许开发者发送不超过 4KB 的预定义键值对。下面列出了接受的键。如需查看代码示例和详细文档，请参阅构建发送请求。 |
| SendResponse | 表示作为批量请求的一部分发送的某条消息的状态的接口。 |
| TokenMessage | |
| TopicMessage | |
| WebpushConfig | 表示可包含在 Message 中的 WebPush 协议选项。 |
| WebpushFcmOptions | 表示适用于 Web 的 FCM SDK（不属于 Webpush 标准）提供的功能的选项。 |
| WebpushNotification | 表示可包含在 WebpushConfig 中的 WebPush 专用通知选项。这支持网络通知规范中定义的大多数标准选项。 |
类型别名
| 类型别名 | 说明 |
|---|---|
| 短信 | Messaging.send() 操作的载荷。载荷包含 BaseMessage 类型中的所有字段，以及令牌、主题或条件中的一个。 |
getMessaging(应用)
获取默认应用或给定应用的 Messaging 服务。
可以不使用任何参数调用 admin.messaging()，以访问默认应用的 Messaging 服务，或者以 admin.messaging(app) 的形式调用与特定应用关联的 Messaging 服务。
签名：
export declare function getMessaging(app?: App): Messaging;
参数
| 参数 | 类型 | 说明 |
|---|---|---|
| app | 应用 | 要返回其 Messaging 服务的可选应用。如果未提供，系统将返回默认的 Messaging 服务。 |
返回：
如果未提供应用，或与提供的应用关联的 Messaging 服务，则为默认的 Messaging 服务。
示例 1
// Get the Messaging service for the default app
const defaultMessaging = getMessaging();
示例 2
// Get the Messaging service for a given app
const otherMessaging = getMessaging(otherApp);
发消息
Messaging.send() 操作的载荷。载荷包含 BaseMessage 类型中的所有字段，以及令牌、主题或条件中的一个。
签名：
export type Message = TokenMessage | TopicMessage | ConditionMessage;