Bắt đầu sử dụng Giải pháp gửi thông báo qua đám mây của Firebase trong các ứng dụng C++

Hướng dẫn này mô tả cách bắt đầu sử dụng Firebase Cloud Messaging trong các ứng dụng máy khách C++ để bạn có thể gửi thông báo một cách đáng tin cậy.

Để viết ứng dụng khách Firebase Cloud Messaging nhiều 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 mỗi nền tảng. Để tìm hiểu thêm về cách C++ SDK cho iOS và Android hoạt động với FCM, hãy xem phần Tìm hiểu về Firebase cho C++.

Thiết lập Firebase và FCM SDK

Truy cập vào Mã cài đặt Firebase

Bật tính năng đăng ký bằng Mã cài đặt Firebase

Để cho phép đăng ký phiên bản ứng dụng của bạn bằng FCM thông qua Mã nhận dạng lượt cài đặt Firebase (FID), trước tiên, bạn phải bật FID trong cấu hình của ứng dụng cho cả nền tảng Android và Apple:

<meta-data android:name="firebase_messaging_installation_id_enabled"
           android:value="true" />

FirebaseMessagingInstallationIdEnabled = YES

Triển khai trình nghe onRegistrationReceived

Khi khởi chạy thư viện Firebase Cloud Messaging, thư viện này sẽ đăng ký phiên bản ứng dụng khách để nhận thông báo bằng cách sử dụng Mã nhận dạng lượt cài đặt Firebase (FID). Ứng dụng sẽ nhận được FID bằng lệnh gọi lại OnRegistrationReceived. Lệnh gọi lại này phải được xác định trong quá trình triển khai firebase::messaging::Listener:

class MyListener : public firebase::messaging::Listener {
 public:
  void OnRegistrationReceived(const char* installation_id) override {
    LogMessage("Received Firebase Installation ID: %s", installation_id);
    // TODO: Send the Firebase Installation ID (FID) to your app server to
    // target this device for messages.
  }
};

Nếu bạn muốn nhắm đến một phiên bản ứng dụng cụ thể, hãy gửi FID đến máy chủ ứng dụng và lưu trữ FID đó bằng phương thức bạn muốn.

Đăng ký theo cách thủ công khi tính năng khởi chạy tự động bị tắt

Bạn cũng có thể kích hoạt quá trình đăng ký theo cách thủ công bằng FCM trong thời gian chạy bằng cách sử dụng Register():

// Manually register with FCM
firebase::Future<void> register_future = firebase::messaging::Register();
register_future.OnCompletion([](const firebase::Future<void>& future) {
  if (future.status() == firebase::kFutureStatusComplete &&
      future.error() == 0) {
    // Note: The registered Firebase Installation ID is delivered to the
    // OnRegistrationReceived callback.
    LogMessage("Registered with FCM");
  }
});

Truy cập vào mã thông báo đăng ký FCM (không dùng nữa)

Khi khởi chạy thư viện Firebase Cloud Messaging, mã thông báo đăng ký sẽ được yêu cầu cho phiên bản ứ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 này phải được xác định trong lớp triển khai firebase::messaging::Listener.

Nếu muốn nhắm đến một phiên bản ứng dụng 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 gửi tin nhắn trên Android

Khi ứng dụng hoàn toàn không chạy và người dùng nhấn vào 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 một Intent dùng để khởi động ứng dụng. Để FCM chuyển tiếp các tin nhắn đế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);
  }
}

Tin nhắn nhận được khi ứng dụng ở chế độ nền sẽ có nội dung của trường thông báo được dùng để điền thông báo trên khay hệ thống, nhưng nội dung thông báo đó sẽ không được truyền đến FCM. Tức là Message::notification sẽ có 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 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ể muốn ghi đè hành vi mặc định. Để làm 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 tin nhắn đến được gửi đến ứng dụng và định tuyến các tin nhắn đó đến thư viện C++. Khi ứng dụng ở nền trước (hoặc khi ứng dụng ở nền sau và nhận được tải trọng chỉ có dữ liệu), các thông báo sẽ truyền 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 hành động dựa trên đối tượng RemoteMessage nhận được và lấy dữ liệu thông báo:

@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 số phương thức khác ít được sử dụng hơn. Bạn cũng có thể ghi đè các phương thức 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 bạn viết các lớp tuỳ chỉnh, bạn phải thêm các lớp đó vào AndroidManifest.xml để có hiệu lực. Hãy đảm bảo tệp kê khai có chứa các công cụ sáp nhập 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, đây là cách ListenerService có thể chạy. ListenerService này cần được thay thế 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 C++ của Firebase (từ 7.1.0 trở đi) sử dụng JobIntentService, yêu cầu sửa đổi thêm 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 quá trình khởi chạy tự động

FCM tạo mã thông báo đăng ký để nhắm mục tiêu thực thể ứng dụng. Khi một mã thông báo được tạo, thư viện sẽ tải dữ liệu về cấu hình và giá trị nhận dạng lên Firebase. Nếu muốn nhận được sự chọn tham gia 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à Analytics trên Android). Để làm 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::SetRegistrationOnInitEnabled(true);

Giá trị này sẽ được giữ lại sau khi ứng dụng khởi động lại.

Tin nhắn có đường liên kết sâu trên Android

FCM cho phép gửi các thông báo có chứa một đường liên kết sâu vào ứng dụng của bạn. Để nhận các thông báo có chứa một đườ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ý các đường liên kết sâu cho ứng dụng của mình. Bộ lọc ý định này sẽ nắm bắt các đườ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, thì bạn không cần thực hiện 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 ký tự đại diện để giúp 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 có chứa đường liên kết đến lượ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 hoàn tất các bước thiết lập, bạn có thể chọn một trong số các cách sau để tiếp tục sử dụng FCM cho C++:

• Gửi thông báo đến thiết bị
• Nhận thông báo trong ứng dụng C++
• Gửi thông báo đến các chủ đề