Thiết lập ứng dụng nhắn tin qua đám mây của Firebase bằng C++

Để viết ứng dụng khách Firebase Cloud Messaging đa nền tảng bằng C++, hãy sử dụng API Firebase Cloud Messaging. SDK C++ hoạt động cho cả nền tảng Android và Apple, với một số chế độ thiết lập bổ sung cần thiết cho từng nền tảng.

Thiết lập Firebase và SDK FCM

Truy cập mã thông báo đăng ký thiết bị

Khi khởi chạy thư viện Giải pháp gửi thông báo qua đám mây của Firebase, hệ thống sẽ yêu cầu mã thông báo đăng ký cho thực thể ứng dụng khách. Ứng dụng sẽ nhận được mã thông báo bằng lệnh gọi lại OnTokenReceived. Lệnh gọi lại này phải được xác định trong lớp triển khai firebase::messaging::Listener.

Nếu muốn nhắm đến thiết bị cụ thể đó, bạn cần có quyền truy cập vào mã thông báo này.

Lưu ý về việc phân phối tin nhắn trên Android

Khi ứng dụng không chạy và người dùng nhấn vào một thông báo, theo mặc định, thông báo sẽ không được định tuyến thông qua lệnh gọi lại tích hợp sẵn của FCM. Trong trường hợp này, tải trọng thông báo được nhận thông qua Intent dùng để khởi động ứng dụng. Để FCM chuyển tiếp các thông báo đến này đến lệnh gọi lại thư viện C++, bạn cần ghi đè phương thức onNewIntent trong Hoạt động và truyền Intent đến MessageForwardingService.

import com.google.firebase.messaging.MessageForwardingService;

class MyActivity extends Activity {
  private static final String TAG = "MyActvity";

  @Override
  protected void onNewIntent(Intent intent) {
    Log.d(TAG, "A message was sent to this app while it was in the background.");
    Intent message = new Intent(this, MessageForwardingService.class);
    message.setAction(MessageForwardingService.ACTION_REMOTE_INTENT);
    message.putExtras(intent);
    message.setData(intent.getData());
    // For older versions of Firebase C++ SDK (< 7.1.0), use `startService`.
    // startService(message);
    MessageForwardingService.enqueueWork(this, message);
  }
}

Các thông báo nhận được khi ứng dụng đang chạy ở chế độ nền có nội dung của trường thông báo được dùng để điền thông báo vào khay hệ thống, nhưng nội dung thông báo đó sẽ không được thông báo cho FCM. Tức là Message::notification sẽ là giá trị rỗng.

Tóm lại:

Xử lý thông báo tuỳ chỉnh trên Android

Theo mặc định, thông báo được gửi đến ứng dụng sẽ được chuyển đến ::firebase::messaging::Listener::OnMessageReceived, nhưng trong một số trường hợp, bạn có thể ghi đè hành vi mặc định. Để thực hiện việc này trên Android, bạn cần viết các lớp tuỳ chỉnh mở rộng com.google.firebase.messaging.cpp.ListenerService cũng như cập nhật AndroidManifest.xml của dự án.

Ghi đè phương thức ListenerService.

ListenerService là lớp Java chặn các thông báo đến được gửi đến ứng dụng và định tuyến các thông báo đó đến thư viện C++. Khi ứng dụng chạy ở nền trước (hoặc khi ứng dụng chạy ở chế độ nền và nhận được tải trọng chỉ dữ liệu), thông báo sẽ đi qua một trong các lệnh gọi lại được cung cấp trên lớp này. Để thêm hành vi tuỳ chỉnh vào quá trình xử lý thông báo, bạn cần mở rộng ListenerService mặc định của FCM:

import com.google.firebase.messaging.cpp.ListenerService;

class MyListenerService extends ListenerService {

Bằng cách ghi đè phương thức ListenerService.onMessageReceived, bạn có thể thực hiện các thao tác dựa trên đối tượng RemoteMessage đã nhận và nhận dữ liệu tin nhắn:

@Override
public void onMessageReceived(RemoteMessage message) {
  Log.d(TAG, "A message has been received.");
  // Do additional logic...
  super.onMessageReceived(message);
}

ListenerService cũng có một vài phương thức khác ít được sử dụng hơn. Bạn cũng có thể ghi đè các giá trị này. Để biết thêm thông tin, hãy xem tài liệu tham khảo về FirebaseMessagingService.

@Override
public void onDeletedMessages() {
  Log.d(TAG, "Messages have been deleted on the server.");
  // Do additional logic...
  super.onDeletedMessages();
}

@Override
public void onMessageSent(String messageId) {
  Log.d(TAG, "An outgoing message has been sent.");
  // Do additional logic...
  super.onMessageSent(messageId);
}

@Override
public void onSendError(String messageId, Exception exception) {
  Log.d(TAG, "An outgoing message encountered an error.");
  // Do additional logic...
  super.onSendError(messageId, exception);
}

Cập nhật AndroidManifest.xml

Sau khi viết các lớp tuỳ chỉnh, bạn phải đưa các lớp đó vào AndroidManifest.xml để có hiệu lực. Đảm bảo tệp kê khai bao gồm các công cụ hợp nhất bằng cách khai báo thuộc tính thích hợp bên trong thẻ <manifest>, như sau:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.google.firebase.messaging.cpp.samples"
    xmlns:tools="http://schemas.android.com/tools">

Trong tệp lưu trữ firebase_messaging_cpp.aar, có một tệp AndroidManifest.xml khai báo ListenerService mặc định của FCM. Tệp kê khai này thường được hợp nhất với tệp kê khai dành riêng cho dự án, đó là cách ListenerService có thể chạy. Bạn cần thay thế ListenerService này bằng dịch vụ trình nghe tuỳ chỉnh. Bạn có thể thực hiện việc này bằng cách xoá ListenerService mặc định và thêm Dịch vụ tuỳ chỉnh. Bạn có thể thực hiện việc này bằng các dòng sau trong tệp AndroidManifest.xml của dự án:

<service android:name="com.google.firebase.messaging.cpp.ListenerService"
         tools:node="remove" />

<service android:name="com.google.firebase.messaging.cpp.samples.MyListenerService"
         android:exported="false">
  <intent-filter>
    <action android:name="com.google.firebase.MESSAGING_EVENT"/>
  </intent-filter>
</service>

Các phiên bản mới của SDK Firebase C++ (7.1.0 trở lên) sử dụng JobIntentService, yêu cầu thêm các sửa đổi trong tệp AndroidManifest.xml.

<service android:name="com.google.firebase.messaging.MessageForwardingService"
     android:permission="android.permission.BIND_JOB_SERVICE"
     android:exported="false" >
</service>

Ngăn khởi chạy tự động

FCM tạo mã đăng ký để nhắm mục tiêu theo thiết bị. Khi mã thông báo được tạo, thư viện sẽ tải giá trị nhận dạng và dữ liệu cấu hình lên Firebase. Nếu muốn nhận được lựa chọn sử dụng rõ ràng trước khi sử dụng mã thông báo, bạn có thể ngăn việc tạo mã thông báo tại thời điểm định cấu hình bằng cách tắt FCM (và trên Android, Analytics). Để thực hiện việc này, hãy thêm một giá trị siêu dữ liệu vào Info.plist (không phải GoogleService-Info.plist) trên các nền tảng của Apple hoặc AndroidManifest.xml trên Android:

<?xml version="1.0" encoding="utf-8"?>
<application>
  <meta-data android:name="firebase_messaging_auto_init_enabled"
             android:value="false" />
  <meta-data android:name="firebase_analytics_collection_enabled"
             android:value="false" />
</application>

FirebaseMessagingAutoInitEnabled = NO

Để bật lại FCM, bạn có thể thực hiện lệnh gọi thời gian chạy:

::firebase::messaging::SetTokenRegistrationOnInitEnabled(true);

Giá trị này vẫn tồn tại sau khi khởi động lại ứng dụng.

Xử lý tin nhắn có đường liên kết sâu trên Android

FCM cho phép gửi thông báo chứa đường liên kết sâu vào ứng dụng của bạn. Để nhận thông báo chứa đường liên kết sâu, bạn phải thêm một bộ lọc ý định mới vào hoạt động xử lý đường liên kết sâu cho ứng dụng. Bộ lọc ý định sẽ thu thập đường liên kết sâu của miền. Nếu thông báo của bạn không chứa đường liên kết sâu, bạn không cần phải định cấu hình này. Trong AndroidManifest.xml:

<intent-filter>
  <action android:name="android.intent.action.VIEW"/>
  <category android:name="android.intent.category.DEFAULT"/>
  <category android:name="android.intent.category.BROWSABLE"/>
  <data android:host="CHANGE_THIS_DOMAIN.example.com" android:scheme="http"/>
  <data android:host="CHANGE_THIS_DOMAIN.example.com" android:scheme="https"/>
</intent-filter>

Bạn cũng có thể chỉ định một ký tự đại diện để bộ lọc ý định linh hoạt hơn. Ví dụ:

<intent-filter>
  <action android:name="android.intent.action.VIEW"/>
  <category android:name="android.intent.category.DEFAULT"/>
  <category android:name="android.intent.category.BROWSABLE"/>
  <data android:host="*.example.com" android:scheme="http"/>
  <data android:host="*.example.com" android:scheme="https"/>
</intent-filter>

Khi người dùng nhấn vào một thông báo chứa đường liên kết đến giao thức và máy chủ lưu trữ mà bạn chỉ định, ứng dụng của bạn sẽ bắt đầu hoạt động bằng bộ lọc ý định này để xử lý đường liên kết.

Các bước tiếp theo

Sau khi thiết lập ứng dụng khách, bạn đã sẵn sàng gửi thông báo theo dòng và thông báo theo chủ đề bằng Firebase. Để tìm hiểu thêm, hãy xem chức năng này được minh hoạ trong mẫu bắt đầu nhanh mà bạn có thể tải xuống, chạy và xem lại.

Để thêm các hành vi nâng cao khác vào ứng dụng, hãy xem hướng dẫn gửi thông báo từ máy chủ ứng dụng:

• Gửi tin nhắn theo chủ đề
• Gửi đến nhóm thiết bị

Xin lưu ý rằng bạn cần triển khai máy chủ để sử dụng các tính năng này.