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

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

Với thao tác, bạn có thể sử dụng thông báo trong ứng dụng để hướng 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.

Tính năng gửi thông báo trong ứng dụng của Firebase 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ó trình xử lý đó, thì tính năng Gửi thông báo trong ứng dụng của Firebase 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 Liên kết động của Firebase. Để 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 của Firebase

Khi ứng dụng của bạn có trình xử lý đường liên kết, bạn đã sẵn sàng tạo chiến dịch bằng một hành động. Mở bảng điều khiển của Firebase để Nhắn tin và bắt đầu chiến dịch mới hoặc chỉnh sửa chiến dịch hiện có. Trong chiến dịch đó, hãy cung cấp Thẻ, Văn bản nút và Hành động của nút, Hành động trên hình ảnh hoặc Hành động trên 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. Mô-đun có các nút thao tác với nội dung văn bản của nút có thể tuỳ chỉnh, màu văn bản và màu nền. Mặt khác, hình ảnh và biểu ngữ trên cùng sẽ có tính tương tác và gọi hành động được chỉ định khi nhấn vào.

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

Tính năng Gửi thông báo trong ứng dụng của Firebase cho phép bạn tuỳ chỉnh 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 chi tiết khác. Có hai cách để sửa đổi chế độ hiển thị thông báo: sửa đổi màn hình hiển thị tính năng Gửi thông báo trong ứng dụng của Firebase mặc định hoặc tạo thư viện 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 hoạt động 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à tạo dựa trên mã hiển thị thông báo mặc định của tính năng Gửi thông báo trong ứng dụng Firebase.

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 kho lưu trữ này được sao chép, bạn có thể sửa đổi bất kỳ hoặc tất cả các loại thông báo Gửi thông báo trong ứng dụng của Firebase: 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 Gửi thông báo trong ứng dụng Firebase.

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

Loại titleText nội dung Màu văn bản màu nền dữ liệu hình ảnh nút hành động PrimaryActionButton (nút hành động phụ)
Thẻ
Vải modal
Biểu ngữ
Chỉ hình ảnh

Sửa đổi mã hiển thị hiển thị thông báo

Với các giới hạn về loại thông báo, bạn có thể tuỳ ý sửa đổi. Bạn có thể tạo một biểu ngữ hiển thị ở cuối ứng dụng, di chuyển quanh nút hành động 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 để làm cho giao diệ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 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 với các tệp xác định logic của loại thông báo đó:
  • Storyboard: 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 loại thông báo ưu tiên và các phần tương ứng của .storyboard để tạo thông báo tuỳ chỉnh hiển thị.

Hãy cập nhật tệp podfile của bạn để sử dụng mã InAppMessaging đã sửa đổi

Để tính năng Gửi thông báo trong ứng dụng của Firebase sử dụng 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 tệp podfile để sử dụng thư viện InAppMessaging tuỳ chỉnh: 

# 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 làm xong, bạn có thể cập nhật các nhóm, tạo lại ứng dụng và xem các màn hình thông báo mới tuỳ chỉnh được.

Tạo thư viện hiển thị tin nhắn của riêng bạn

Bạn không bị giới hạn ở việc sử dụng thư viện InAppMessaging để tạo giao diện người dùng cho việc 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 giúp triển khai giao thức InAppMessagingDisplay

Tính năng gửi thông báo trong ứng dụng của Firebase sử dụng lớp InAppMessaging để xử lý hoạt động giao tiếp giữa máy chủ Firebase và ứng dụng của bạn. Sau đó, lớp này sẽ sử dụng giao thức InAppMessagingDisplay để hiển thị các thông báo nhận được. Để xây dựng 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.

Tài liệu và định nghĩa về giao thức có 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 của bạn

InAppMessaging sử dụng thuộc tính messageDisplayComponent để xác định đối tượng cần sử dụng khi hiển thị thông báo. Hãy đặ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 để tính năng Gửi thông báo trong ứng dụng của Firebase 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