Watch demos on how to build & run AI-powered apps with Firebase at Demo Day '24. Watch now.

Trang này được dịch bởi Cloud Translation API.

MessagingOptions interface

Giao diện thể hiện các tuỳ chọn có thể được cung cấp khi gửi thông báo qua API FCM cũ.

Hãy xem phần Tạo yêu cầu gửi để biết mã mẫu và tài liệu chi tiết.

Chữ ký:

export interface MessagingOptions

Thuộc tính

Tài sản	Loại	Mô tả
thu gọn Chìa khoá	chuỗi	Chuỗi xác định một nhóm thư (ví dụ: "Có sẵn bản cập nhật") có thể thu gọn được để chỉ thư cuối cùng được gửi khi có thể tiếp tục gửi. Chế độ này dùng để tránh gửi quá nhiều thư giống nhau khi thiết bị có kết nối mạng trở lại hoặc hoạt động.Chúng tôi không đảm bảo về thứ tự gửi thư.Mỗi thời điểm chỉ cho phép tối đa 4 khoá thu gọn khác nhau. Điều này nghĩa là máy chủ FCM có thể lưu trữ đồng thời 4 thông báo gửi để đồng bộ hoá khác nhau trên mỗi ứng dụng khách. Nếu bạn vượt quá con số này, chúng tôi không đảm bảo máy chủ FCM sẽ giữ lại 4 khoá thu gọn nào.Giá trị mặc định: Không có
content có sẵn	boolean	Trên iOS, hãy sử dụng trường này để đại diện cho `content-available` trong tải trọng APN. Khi một thông báo hoặc tin nhắn dữ liệu được gửi đi và bạn đặt giá trị này thành `true`, thì một ứng dụng khách không hoạt động sẽ được đánh thức. Trên Android, theo mặc định, thông báo dữ liệu sẽ đánh thức ứng dụng. Trên Chrome, cờ này hiện không được hỗ trợ.Giá trị mặc định: `false`
DryRun (Chạy khô)	boolean	Liệu thư có thực sự được gửi hay không. Khi bạn đặt thành `true`, hệ thống sẽ cho phép nhà phát triển kiểm thử một yêu cầu mà không thực sự gửi thông báo. Khi bạn đặt chính sách này thành `false`, thông báo sẽ được gửi.Giá trị mặc định: `false`
mutableContent	boolean	Trên iOS, hãy sử dụng trường này để đại diện cho `mutable-content` trong tải trọng APN. Khi một thông báo được gửi và đặt thành `true`, người dùng có thể sửa đổi nội dung của thông báo trước khi hiển thị bằng cách sử dụng tiện ích ứng dụng Dịch vụ thông báo.Trên Android và Web, tham số này sẽ bị bỏ qua.Giá trị mặc định: `false`
mức độ ưu tiên	chuỗi	Mức độ ưu tiên của thông báo. Giá trị hợp lệ là `"normal"` và `"high".` Trên iOS, những giá trị này tương ứng với mức độ ưu tiên của APN `5` và `10`.Theo mặc định, thông báo thông báo được gửi với mức độ ưu tiên cao còn thông báo dữ liệu được gửi với mức độ ưu tiên bình thường. Mức độ ưu tiên bình thường sẽ tối ưu hoá mức tiêu thụ pin của ứng dụng và nên được dùng trừ phi cần phân phối ngay. Đối với các tin nhắn có mức độ ưu tiên bình thường, ứng dụng có thể nhận được thông báo với độ trễ không xác định.Khi tin nhắn được gửi với mức độ ưu tiên cao, tin nhắn đó sẽ được gửi ngay lập tức và ứng dụng có thể đánh thức thiết bị đang ngủ cũng như mở kết nối mạng tới máy chủ của bạn.Để biết thêm thông tin, hãy xem phần Đặt mức độ ưu tiên của tin nhắn.Giá trị mặc định: `"high"` cho tin nhắn thông báo, `"normal"` cho tin nhắn dữ liệu
limitedPackageName (Tên gói hạn chế)	chuỗi	Tên gói của ứng dụng mà mã thông báo đăng ký phải khớp để nhận được thông báo.Giá trị mặc định: Không có
timeToLive	số	Khoảng thời gian (tính bằng giây) tin nhắn sẽ được lưu giữ trong bộ nhớ FCM nếu thiết bị không có kết nối mạng. Thời gian phát trực tiếp tối đa được hỗ trợ là 4 tuần và giá trị mặc định cũng là 4 tuần. Để biết thêm thông tin, hãy xem bài viết Thiết lập thời gian tồn tại của thông báo.Giá trị mặc định: `2419200` (đại diện cho 4 tuần, tính bằng giây)

MessagingOptions.thu gọnKey

Chuỗi xác định một nhóm thư (ví dụ: "Có sẵn bản cập nhật") có thể thu gọn được để chỉ thư cuối cùng được gửi khi có thể tiếp tục gửi. Mã này được dùng để tránh gửi quá nhiều thư giống nhau khi thiết bị trở lại kết nối mạng hoặc hoạt động.

Chúng tôi không đảm bảo về thứ tự gửi thư.

Chỉ được có tối đa 4 khoá thu gọn khác nhau tại một thời điểm bất kỳ. Điều này nghĩa là máy chủ FCM có thể lưu trữ đồng thời 4 thông báo gửi để đồng bộ hoá khác nhau trên mỗi ứng dụng khách. Nếu bạn vượt quá con số này, chúng tôi không đảm bảo máy chủ FCM sẽ giữ lại 4 khoá thu gọn nào.

**Giá trị mặc định:** Không có

Chữ ký:

collapseKey?: string;

MessagingOptions.contentCó sẵn

Trên iOS, hãy sử dụng trường này để đại diện cho content-available trong tải trọng APN. Khi một thông báo hoặc tin nhắn dữ liệu được gửi đi và bạn đặt thành true, thì một ứng dụng khách không hoạt động sẽ được đánh thức. Trên Android, theo mặc định, thông báo dữ liệu sẽ đánh thức ứng dụng. Trên Chrome, cờ này hiện không được hỗ trợ.

**Giá trị mặc định:** false

Chữ ký:

contentAvailable?: boolean;

MessagingOptions.dryRun

Liệu thư có thực sự được gửi hay không. Khi bạn đặt thành true, hệ thống sẽ cho phép nhà phát triển kiểm thử một yêu cầu mà không thực sự gửi thông báo. Khi bạn đặt chính sách này thành false, tin nhắn sẽ được gửi.

**Giá trị mặc định:** false

Chữ ký:

dryRun?: boolean;

MessagingOptions.mutableContent

Trên iOS, hãy sử dụng trường này để đại diện cho mutable-content trong tải trọng APN. Khi một thông báo được gửi và giá trị này được đặt thành true, người dùng có thể sửa đổi nội dung của thông báo trước khi hiển thị bằng cách sử dụng tiện ích ứng dụng Dịch vụ thông báo.

Trên Android và Web, tham số này sẽ bị bỏ qua.

**Giá trị mặc định:** false

Chữ ký:

mutableContent?: boolean;

Nhắn tin.lựa chọn ưu tiên

Mức độ ưu tiên của thông báo. Các giá trị hợp lệ là "normal" và "high". Trên iOS, những giá trị này tương ứng với mức độ ưu tiên của APN 5 và 10.

Theo mặc định, thông báo được gửi với mức độ ưu tiên cao còn thông báo dữ liệu được gửi với mức độ ưu tiên bình thường. Mức độ ưu tiên bình thường sẽ tối ưu hoá mức tiêu thụ pin của ứng dụng và nên được dùng trừ phi cần phân phối ngay. Đối với những thư có mức độ ưu tiên bình thường, ứng dụng có thể nhận tin nhắn với độ trễ không xác định.

Khi một tin nhắn được gửi với mức độ ưu tiên cao, tin nhắn đó sẽ được gửi ngay lập tức và ứng dụng có thể đánh thức một thiết bị đang ngủ cũng như mở kết nối mạng đến máy chủ của bạn.

Để biết thêm thông tin, hãy xem Đặt mức độ ưu tiên của thư.

**Giá trị mặc định:** "high" đối với tin nhắn thông báo, "normal" đối với tin nhắn dữ liệu

Chữ ký:

priority?: string;

Nhắn tin, hạn chếPackageName

Tên gói của ứng dụng mà mã thông báo đăng ký phải khớp để nhận được thông báo.

**Giá trị mặc định:** Không có

Chữ ký:

restrictedPackageName?: string;

MessagingOptions.timeToLive

Khoảng thời gian (tính bằng giây) tin nhắn sẽ được lưu giữ trong bộ nhớ FCM nếu thiết bị không có kết nối mạng. Thời gian phát trực tiếp tối đa được hỗ trợ là 4 tuần và giá trị mặc định cũng là 4 tuần. Để biết thêm thông tin, hãy xem bài viết Thiết lập thời gian tồn tại của thông báo.

**Giá trị mặc định:** 2419200 (đại diện cho 4 tuần, tính bằng giây)

Chữ ký:

timeToLive?: number;