Flutter 120: Flutter & 騰訊移動通訊 TPNS~

????小菜前兩天剛學習了原生 Android 騰訊移動通訊 TPNS,發現同時提供了 Flutter_Plugin,今天嘗試一下對 Flutter 的支持;

Flutter TPNS

1. 基本接入

1.1 環境配置

????小菜在接入 Flutter TPNS 時,需要在 FlutterAndroid 兩端進行插件的安裝配置;

  • Flutter

????在工程 pubspec.yamldependencies 下引入 tpns_flutter_plugin 插件;

dependencies:
  flutter:
    sdk: flutter
  tpns_flutter_plugin:
    git:
      url: https://github.com/TencentCloud/TPNS-Flutter-Plugin
      ref: V1.0.7
  • Android

????在 app build.gradle 文件下配置 IDKEY 以及支持的 .so 庫

defaultConfig {
    applicationId "com.ace.plugin.flutter_app07"
    minSdkVersion 16
    targetSdkVersion 28
    versionCode flutterVersionCode.toInteger()
    versionName flutterVersionName
    testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    ndk {
        abiFilters 'armeabi', 'armeabi-v7a', 'x86', 'x86_64', 'mips', 'mips64', 'arm64-v8a', 'arm6'
    }
    manifestPlaceholders = [
        XG_ACCESS_ID : "1500018481",
        XG_ACCESS_KEY : "AW8Y2K3KXZ38",
    ]
}

1.2 方法使用

????小菜按照官網的介紹嘗試了一些常用的 API 方式,主要分為應用類,賬號類和標簽類三種 API,小菜業務中沒有應用賬號和標簽模塊,暫未深入研究;

  • 應用接口 API
a. 注冊推送服務

????對于服務的注冊初始化,可以在首次進入應用 initState() 中直接初始化,也可以根據業務邏輯在固定的位置進行初始化,需要傳遞申請的賬號 IDKEY;注冊成功之后會在 onRegisteredDone() 中進行回調,并獲取對應設備的唯一 Token

XgFlutterPlugin().startXg("1500018481", "AW8Y2K3KXZ38");

// 注冊回調
XgFlutterPlugin().addEventHandler(
  onRegisteredDone: (String msg) async {
    print("HomePage -> onRegisteredDone -> $msg");
    _showDialog('注冊成功', msg);
  },
);
b. 注銷推送服務

????服務的注銷方法可以通過 stopXg() 進行處理,并在 unRegistered 進行回調監聽;

XgFlutterPlugin().stopXg();

// 注銷回調
XgFlutterPlugin().addEventHandler(
  unRegistered: (String msg) async {
    print("HomePage -> unRegistered -> $msg");
  },
);
c. 設備推送標識

????對于設備唯一標識的獲取,可以通過注冊初始化成功之后獲取,也可以通過 XgFlutterPlugin.xgToken 獲取唯一 Token

Future<void> getTPNSToken(title) async {
  try {
    String xgToken = await XgFlutterPlugin.xgToken;
    print('HomePage -> getTPNSToken -> $xgToken');
    _showDialog(title, xgToken);
  } catch (e) {
    print(e.toString());
  }
}
d. 上報角標數

????對于桌面角標,在通知類消息中 華為小米 設備在開啟權限之后,接收通知會由桌面角標的更新;而 TPNS 提供的 setBadge() 只有在 iOS 環境下支持,對于 Android 環境下的透傳類型或其他廠商設備的支持,可以通過 FlutterNative 通信來由原生實現;

e. SDK 版本

????TPNS SDK 版本可以通過 XgFlutterPlugin.xgSdkVersion 獲取;

Future<void> getTPNSSDKVersion(title) async {
  try {
    String sdkVersion = await XgFlutterPlugin.xgSdkVersion;
    print('HomePage -> getTPNSSDKVersion -> $sdkVersion');
    _showDialog(title, sdkVersion);
  } catch (e) {
    print(e.toString());
  }
}
  • 賬號接口 API
    ????TPNS 提供了個性化服務,關于賬號的綁定和解綁等功能,可以根據具體的業務邏輯進行處理;
String inputStr = "ACE_Flutter";
// 設置賬號
XgFlutterPlugin().setAccount(inputStr, AccountType.UNKNOWN);
// 解綁賬號
XgFlutterPlugin().deleteAccount(inputStr, AccountType.UNKNOWN);
// 清空賬號
XgFlutterPlugin().cleanAccounts();

XgFlutterPlugin().addEventHandler(
  xgPushDidBindWithIdentifier: (String msg) async {
    print("HomePage -> xgPushDidBindWithIdentifier -> $msg");
    _showDialog('綁定標簽 $inputStr', msg);
  },
  xgPushDidUnbindWithIdentifier: (String msg) async {
    print("HomePage -> xgPushDidUnbindWithIdentifier -> $msg");
    _showDialog('解綁賬號', msg);
  },
  xgPushDidClearAllIdentifiers: (String msg) async {
    print("HomePage -> xgPushDidClearAllIdentifiers -> $msg");
    _showDialog('清除全部賬號', msg);
  }
)
  • 標簽接口 API
    ????TPNS 的用戶標簽功能比較強大,可以針對性的進行地理圍欄或標簽分布的推送;TPNS 提供了綁定和解綁標簽,更新和清理標簽等功能,方便針對性的進行數據推送;
String inputStr = "ACE_Flutter";
// 綁定標簽
XgFlutterPlugin().addTags([inputStr]);
// 解綁標簽
XgFlutterPlugin().deleteTags([inputStr]);
// 更新標簽
XgFlutterPlugin().setTags([inputStr]);
// 清除標簽
XgFlutterPlugin().cleanTags();

2. 通知類消息

????小菜在上一篇文章中介紹了 TPNS 消息發布后臺,不管是哪種方式集成,發布后臺是一致的;

2.1 接收 & 展示

????通知類 Push 在設備開啟權限時,接收消息后會自動展示通知,這是由 TPNS SDK 實現好的,與原生一致,通知類 Push 標題和內容也只能以通過消息后臺發布為準,不能自由更改;其中 通知類 Push 接收通過 onReceiveNotificationResponse() 方法回調監聽;

XgFlutterPlugin().addEventHandler(
  onReceiveNotificationResponse: (Map<String, dynamic> msg) async {
    print("HomePage -> onReceiveNotificationResponse -> $msg");
    _showDialog('通知類消息接收', msg.toString());
  },
);
TPNS_通知類_接收.jpg

TPNS_通知類_展示.jpg

2.2 點擊

????通知類 Push 消息點擊是通過 xgPushClickAction() 方法進行回調,之后的業務邏輯可以根據消息返回的信息進行處理;小菜為了適配其他的 Push 類型,調整了點擊后的操作,默認為啟動 app,小菜通常在【附加參數】中添加 Json 進行數據解析,在進行之后的業務處理;

XgFlutterPlugin().addEventHandler(
  xgPushClickAction: (Map<String, dynamic> msg) async {
    print("HomePage -> xgPushClickAction -> $msg");
    _showDialog('通知類消息點擊', msg.toString());
  },
);
TPNS_通知類_點擊.jpg

3. 透傳類消息

????透傳類 Push 相比 通知類 Push 要復雜一些,TPNS 只提供了 透傳類 Push 接收,不會進行 Notification 通知展示;因此小菜通過 Flutter-Native 消息通信進行處理;其中 Notification 的展示點擊需要 Native 方面進行配合處理;

3.1 接收

????透傳類 Push 通過 onReceiveMessage() 進行消息接收的回調監聽;之后,小菜建立一個 MethodChannel 將消息傳遞給 Android Native

XgFlutterPlugin().addEventHandler(
    onReceiveMessage: (Map<String, dynamic> msg) async {
      print("HomePage -> onReceiveMessage -> $msg");
      _showDialog('透傳類消息接收', msg.toString());
      await methodChannel
          .invokeMethod('tpns_extras', msg['customMessage'])
          .then((val) {
        print("HomePage -> 透傳類消息接收 -> $val");
        if (val != null) {
          _showDialog('透傳類消息點擊', val);
        }
      });
    },
);
TPNS_透傳類_接收.jpg

3.2 展示

????Flutter 端在接收到 透傳類 Push 消息時,發送 MethodChannelAndroid NativeNative 端在解析對應參數進行 Notification 展示;

@Override
public void configureFlutterEngine(@NonNull FlutterEngine flutterEngine) {
    GeneratedPluginRegistrant.registerWith(flutterEngine);
    new MethodChannel(flutterEngine.getDartExecutor().getBinaryMessenger(),
        "com.ace.plugin.flutter_app/tpns_notification").setMethodCallHandler(new MethodChannel.MethodCallHandler() {
        @Override
        public void onMethodCall(MethodCall call, MethodChannel.Result result) {
            if (call != null && call.method.equals("tpns_extras")) {
                setNotification(MainActivity.this, call.arguments.toString());
                mResult = result;
            } else {
                result.notImplemented();
            }
        }
    });
}
TPNS_透傳類_展示.jpg

3.3 點擊

????Native 端展示 Notification 后,小菜嘗試兩種方式,第一種是通過一個新的 BasicMessageChannel 來進行消息通信到 Flutter 端,第二種是通過之前 Flutter 發送的 MethodChannel 進行 result 回調;小菜雖然應用了第二種方式,但更傾向于第一種,每個事件更加專一;

????Flutter 端接收到 Native 發送或返回的消息后便可自由進行業務邏輯處理了;

private void setNotification(Context context, String extras) {
    NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        NotificationChannel channel =
            new NotificationChannel("ace_push", "ace_push_name", NotificationManager.IMPORTANCE_HIGH);
        if (notificationManager != null) {
            notificationManager.createNotificationChannel(channel);
        }
    }
    int notificationId = new java.util.Random().nextInt(1000);

    //Intent intent = new Intent(MainActivity.this, TPNSNotificationReceiver.class);
    //PendingIntent pendingIntent = PendingIntent.getBroadcast(MainActivity.this, 101, intent, 102);
    Intent intent = new Intent(context, MainActivity.class);
    intent.putExtra("push_extras", extras);
    intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
    PendingIntent pendingIntent =
        PendingIntent.getActivity(context, notificationId, intent, PendingIntent.FLAG_CANCEL_CURRENT);
    JSONObject json = JSONObject.parseObject(extras);
    String extrasStr = json.getString("extras");
    json = JSONObject.parseObject(extrasStr);
    String title = json.getString("title");
    String desc = json.getString("desc");
    Notification notification = new NotificationCompat.Builder(context, "ace_push").setContentTitle(title)
        .setContentText(desc)
        .setContentIntent(pendingIntent)
        .setWhen(System.currentTimeMillis())
        .setSmallIcon(R.mipmap.ic_launcher)
        .setAutoCancel(true)
        .build();
    notificationManager.notify(notificationId, notification);
}
TPNS_透傳類_點擊.jpg

3.4 注意事項

????小菜在 PendingIntent 中傳遞的頁面依舊是 MainActivity,可以根據具體的業務邏輯啟動專門的中轉頁面;其中使用 MainActivity 時需要,因為設置了 FlagIntent.FLAG_ACTIVITY_NEW_TASK 因此注意數據的接收通過 onNewIntent 進行接收;

@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    if (intent != null && intent.getExtras() != null && intent.getExtras().containsKey("push_extras")) {
        String extras = intent.getStringExtra("push_extras");
        if (mResult != null) {
            mResult.success(extras);
        }
    }
}

????Flutter TPNS 案例源碼


????小菜對于 Flutter TPNS 中很多高級方法還未做嘗試,僅實現最基本的通知類和透傳類 Push 的接收展示點擊等;如有錯誤請多多指導!

來源: 阿策小和尚

?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容