Tuỳ chỉnh thông báo gửi qua tính năng Gửi thông báo trong ứng dụng của Firebase


Tính năng Gửi thông báo trong ứng dụng của Firebase cung cấp một bộ hành vi và loại thông báo hữu ích được định cấu hình sẵn với giao diện mặc định, nhưng trong một số trường hợp, bạn có thể muốn mở rộng hành vi và nội dung thông báo. Tính năng Nhắn tin trong ứng dụng cho phép bạn thêm các thao tác vào thông báo và tuỳ chỉnh giao diện của thông báo.

Thêm thao tác vào thông báo

Với các thao tác, bạn có thể sử dụng thông báo trong ứng dụng để chuyển người dùng đến một trang web hoặc một màn hình cụ thể trong ứng dụng của bạn.

Firebase In-App Messaging sử dụng trình xử lý liên kết để xử lý các thao tác. SDK có thể sử dụng một số trình xử lý, vì vậy, nếu ứng dụng của bạn đã có một trình xử lý, thì Firebase In-App Messaging có thể sử dụng trình xử lý đó mà không cần thiết lập thêm. Nếu chưa có trình xử lý, bạn có thể sử dụng Firebase Dynamic Links. Để tìm hiểu thêm, hãy đọc bài viết Tạo đường liên kết động trên iOS.

Thêm thao tác vào thông báo bằng bảng điều khiển Firebase

Sau khi ứng dụng của bạn có một trình xử lý đường liên kết, bạn đã sẵn sàng tạo một chiến dịch có hành động. Mở bảng điều khiển Firebase để Nhắn tin, rồi bắt đầu một chiến dịch mới hoặc chỉnh sửa một chiến dịch hiện có. Trong chiến dịch đó, hãy cung cấp một Thẻ, Văn bản nút và Hành động của nút, một Hành động của hình ảnh hoặc một Hành động của biểu ngữ, trong đó hành động là một đường liên kết sâu có liên quan.

Định dạng của thao tác phụ thuộc vào bố cục thông báo mà bạn chọn. Phương thức có các nút thao tác với nội dung văn bản nút, màu văn bản và màu nền có thể tuỳ chỉnh. Mặt khác, hình ảnh và biểu ngữ trên cùng sẽ trở nên có thể tương tác và gọi hành động đã chỉ định khi được nhấn.

Sửa đổi giao diện thông báo

Firebase In-App Messaging cho phép bạn tuỳ chỉnh cách hiển thị thông báo để thay đổi cách ứng dụng hiển thị bố cục, kiểu phông chữ, hình dạng nút và các thông tin khác của thông báo. Có hai cách để sửa đổi màn hình hiển thị thông báo: sửa đổi màn hình hiển thị Firebase In-App Messagingmặc định hoặc tạo thư viện màn hình hiển thị thông báo của riêng bạn từ đầu.

Lưu ý: Sản phẩm này không có trên các mục tiêu macOS, Mac Catalyst, App Clip hoặc watchOS.

Sửa đổi màn hình mặc định

Cách đơn giản nhất để tuỳ chỉnh thông báo là dựa trên mã hiển thị thông báo mặc định của Firebase In-App Messaging.

Sao chép kho lưu trữ firebase-ios-sdk

Để bắt đầu, hãy sao chép bản phát hành mới nhất của kho lưu trữ firebase-ios-sdk rồi mở thư mục InAppMessaging.

Chọn loại thông báo cần sửa đổi

Sau khi sao chép kho lưu trữ, bạn có thể sửa đổi một hoặc tất cả các loại thông báo Firebase In-App Messaging: Card, Modal, Banner và ImageOnly. Mỗi loại tương ứng với một bố cục thông báo trong quy trình tạo chiến dịch Firebase In-App Messaging.

Theo đó, mỗi loại sẽ có quyền truy cập vào một tập hợp dữ liệu riêng, được xác định bằng các lựa chọn tuỳ chỉnh chiến dịch trong bảng điều khiển Firebase:

Loại titleText bodyText textColor backgroundColor imageData actionButton secondaryActionButton
Thẻ
Modal
Biểu ngữ
ImageOnly

Sửa đổi mã kết xuất hiển thị thông báo

Bạn có thể thoải mái sửa đổi các loại thông báo này theo ý muốn, miễn là bạn tuân thủ các giới hạn về loại thông báo. Bạn có thể tạo một biểu ngữ hiển thị ở cuối ứng dụng, di chuyển nút thao tác trên một phương thức, nhúng thông báo trong ứng dụng vào nguồn cấp dữ liệu của người dùng hoặc thực hiện bất kỳ sửa đổi nào khác để giao diện và cảm nhận của thông báo phù hợp với ứng dụng của bạn.

Có hai điều chính cần chú ý khi sửa đổi cách hiển thị thông báo:

  • Thư mục loại thông báo: Mỗi loại thông báo có một thư mục riêng biệt với các tệp xác định logic của loại đó:
  • Bảng phân cảnh: Thư viện InAppMessaging cũng có một tệp .storyboard giúp xác định giao diện người dùng cho cả 3 loại thông báo:

Sửa đổi các tệp trong thư mục của loại thông báo mà bạn muốn và các phần tương ứng của .storyboard để tạo màn hình thông báo tuỳ chỉnh.

Cập nhật podfile để sử dụng mã InAppMessaging đã sửa đổi

Để Firebase In-App Messaging sử dụng các màn hình thông báo đã sửa đổi thay vì màn hình mặc định, hãy cập nhật podfile để sử dụng thư viện InAppMessaging tuỳ chỉnh của bạn: 

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'YourProject' do
# Comment the next line if you're not using Swift and don't want to use dynamic frameworks
use_frameworks!

# Pods for YourProject
pod 'Firebase'

# Remove the default InAppMessaging pod:
# pod 'Firebase/InAppMessaging'

# Overwrite it with a version that points to your local copy:
pod `FirebaseInAppMessaging', :path => '~/Path/To/The/Cloned/Repo/'

end
Sau khi hoàn tất, bạn có thể cập nhật các pod, tạo lại ứng dụng và xem thông báo mới, tuỳ chỉnh hiển thị.

Tạo thư viện hiển thị thông báo của riêng bạn

Bạn không bị giới hạn khi làm việc trong thư viện InAppMessaging để tạo giao diện người dùng hiển thị thông báo. Bạn cũng có thể tự viết mã từ đầu.

Tạo một lớp triển khai giao thức InAppMessagingDisplay

Firebase In-App Messaging sử dụng lớp InAppMessaging để xử lý thông tin liên lạc giữa các máy chủ Firebase và ứng dụng của bạn. Lớp đó lần lượt sử dụng giao thức InAppMessagingDisplay để hiển thị các thông báo mà lớp đó nhận được. Để tạo thư viện hiển thị của riêng bạn, hãy viết một lớp triển khai giao thức.

Định nghĩa giao thức và tài liệu về cách tuân thủ giao thức này nằm trong tệp FIRInAppMessagingDisplay.h của thư viện InAppMessaging.

Đặt messageDisplayComponent để sử dụng thư viện hiển thị tin nhắn

InAppMessaging sử dụng thuộc tính messageDisplayComponent để xác định đối tượng cần dùng khi hiển thị thông báo. Đặt thuộc tính đó thành một đối tượng của lớp hiển thị thông báo tuỳ chỉnh, để Firebase In-App Messaging biết cách sử dụng thư viện của bạn để hiển thị thông báo:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance