Tùy chỉnh tin nhắn Nhắn tin trong ứng dụng Firebase của bạn

Nhắn tin trong ứng dụng Firebase cung cấp một tập hợp hữu ích các hành vi và loại thông báo đượ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 các hành vi và nội dung thông báo. Nhắn tin trong ứng dụng cho phép bạn thêm hành động vào tin nhắn và tùy chỉnh giao diện tin nhắn.

Thêm hành động vào tin nhắn của bạn

Với các hành động, bạn có thể sử dụng thông báo trong ứng dụng của mình để 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.

Nhắn tin trong ứng dụng Firebase sử dụng trình xử lý liên kết để xử lý các hành động. 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ì tính năng Nhắn tin trong ứng dụng 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 Firebase. Để tìm hiểu thêm, hãy đọc Tạo liên kết động trên iOS .

Thêm hành động vào tin nhắn của bạn bằng bảng điều khiển Firebase

Khi ứng dụng của bạn có trình xử lý liên kết, bạn đã sẵn sàng soạn chiến dịch bằng một hành động. Mở bảng điều khiển Firebase tới 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 hành động Thẻ , văn bản Nút và Nút , hành động Hình ảnh hoặc hành động Biểu ngữ , trong đó hành động là liên kết sâu có liên quan.

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

Sửa đổi giao diện tin nhắn

Nhắn tin trong ứng dụng Firebase cho phép bạn tùy chỉnh hiển thị tin nhắn để thay đổi cách ứng dụng của bạn hiển thị bố cục, kiểu phông chữ, hình dạng nút và các chi tiết khác của tin nhắn. Có hai cách để sửa đổi hiển thị tin nhắn: sửa đổi màn hình Nhắn tin trong ứng dụng Firebase mặc định hoặc tạo thư viện hiển thị tin nhắn của riêng bạn từ đầu.

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

Sửa đổi hiển thị mặc định

Cách đơn giản nhất để tùy chỉnh tin nhắn của bạn là xây dựng mã hiển thị tin nhắn mặc định của Nhắn tin trong ứng dụng Firebase.

Sao chép repo firebase-ios-sdk

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

Chọn loại tin nhắn để sửa đổi

Với bản sao kho lưu trữ, bạn có thể sửa đổi bất kỳ hoặc tất cả các loại tin nhắn Nhắn tin trong ứng dụng Firebase: Card , Modal , Banner và ImageOnly . Mỗi loại tương ứng với một bố cục tin nhắn trong luồng tạo chiến dịch Nhắn tin trong ứng dụng Firebase.

Theo đó, mỗi loại có quyền truy cập vào một bộ dữ liệu khác nhau, được xác định bằng các tùy chọn tùy chỉnh chiến dịch trong bảng điều khiển Firebase:

Kiểu tiêu đề văn bản bài kiểm tra cơ thể văn bản màu màu nền dữ liệu hình ảnh nút hành động nút hành động thứ cấp
Thẻ
phương thức
Ngọn cờ
Chỉ hình ảnh

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

Lưu ý đến các giới hạn về loại tin nhắn, bạn có thể tự do sửa đổi chúng theo cách bạn muốn. Bạn có thể tạo biểu ngữ hiển thị ở cuối ứng dụng, di chuyển xung 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 bất kỳ sửa đổi nào khác giúp 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 hiển thị thông báo:

  • Thư mục loại tin nhắn: Mỗi loại tin nhắn có một thư mục riêng chứa các tệp xác định logic của loại đó:
  • Storyboard: Thư viện InAppMessaging cũng có tệp .storyboard giúp xác định giao diện người dùng cho cả ba 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 ưa thích của bạn và các phần tương ứng của .storyboard để tạo màn hình thông báo tùy chỉnh của bạn.

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

Để Tin nhắn trong ứng dụng Firebase sử dụng màn hình tin nhắn đã 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 tùy 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
Khi đã xong, bạn có thể cập nhật nhóm của mình, xây dựng lại ứng dụng và xem màn hình thông báo mới, tùy chỉnh của mình.

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 khi làm việc từ thư viện InAppMessaging để tạo giao diện người dùng hiển thị tin nhắn. Bạn cũng có thể viết mã của riêng bạn từ đầu.

Xây dựng một lớp triển khai giao thức InAppMessagingDisplay

Nhắn tin trong ứng dụng Firebase sử dụng lớp InAppMessaging để xử lý hoạt động liên lạc giữa máy chủ Firebase và ứng dụng của bạn. Ngược lại, lớp đó sử dụng giao thức InAppMessagingDisplay để hiển thị các thông báo mà nó 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.

Định nghĩa giao thức và tài liệu về cách tuân thủ nó 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 nào sẽ sử 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ị tin nhắn tùy chỉnh của bạn để Nhắn tin trong ứng dụng Firebase biết sử dụng thư viện của bạn để hiển thị tin nhắn:

InAppMessaging.inAppMessaging().messageDisplayComponent = yourInAppMessagingRenderingInstance