NowPushService クラス : Android
NowPushService クラスは、プッシュ通知サービスとのやり取りを可能にする関数を提供します。
| 名前 | 説明 |
|---|---|
| 構成 | サービスに関連付けるサービス構成。 データタイプ: NowServiceConfiguration |
NowPushService - handlePush(remoteMessage: RemoteMessage, successCallback: Consumer<NowPushPayload>, errorCallback: Consumer<Throwable>)
プッシュ通知要求を処理します。
注:
現在実装されているプッシュ通知タイプは
NowPushVirtualAgent だけです。他の渡されたプッシュ通知タイプはすべて、 NotSupportedPushError オブジェクトを返します。| 名前 | タイプ | 説明 |
|---|---|---|
| リモートメッセージ | リモートメッセージ | com.google.firebase.messaging.FirebaseMessagingService.onMessageReceived によって受信された通知。詳細については、「 Android アプリでメッセージを受信する」を参照してください。 |
| 成功 コールバック | コンシューマー <NowPushPayload> | 処理済み NowPushPayload を返すコールバック。 |
| エラーコールバック | コンシューマー <スロー可能> | スローされたエラーを返すコールバック。エラー NotSupportedPushError がスローされた場合、通知タイプは Mobile SDK でサポートされておらず、Mobile SDK フレームワークの外部で処理する必要があります。 |
| タイプ | 説明 |
|---|---|
| なし |
この例では、 onMessageReceived() をオーバーライドして、 RemoteMessage を NowPushService に渡す方法を示します。NowPushService は、通知タイプを認識すると、要求を処理し、アプリケーションが処理する通知オブジェクトを返します。それ以外の場合は 、NotSupportedPushError をスローします。
override fun onMessageReceived(remodeeMessage: RemoteMessage){
pushService.handlePush(remoteMessage, { push ->
when (push) {
is NowPushVirtualAgent → handleVirtualAgentPush(push)
}, { error ->
Log.e(TAG, "Unknown push", error)
handleAppPushNotification(remoteMessage)
})
}
NowPushService - registerPushToken(pushToken: String, pushApp: String, successCallback: Runnable, errorCallback: Consumer<Throwable>)
現在のAndroidデバイスおよび指定されたアプリケーションのプッシュ通知を識別するために使用する一意のFirebaseServiceNowトークンを インスタンスに登録します。
ServiceNowインスタンスが通知を生成し、デバイスAndroidアプリケーションから通知を受信するには、このトークンを登録する必要があります。
| 名前 | タイプ | 説明 |
|---|---|---|
| プッシュトークン | 文字列 | Firebasecom.google.firebase.messaging.FirebaseMessaging.getToken または com.google.firebase.messaging.FirebaseMessagingService.onNewToken によって取得されるトークン。 |
| プッシュアプリ | 文字列 | 関連付けられた ServiceNow インスタンスのプッシュアプリケーションテーブルで指定されたプッシュアプリケーションの名前。 |
| 成功 コールバック | 実行可能ファイル | トークンの登録に成功したときに実行されるコールバック。 |
| エラーコールバック | コンシューマー <スロー可能> | トークンの登録に失敗したときに実行されるコールバック。 |
| タイプ | 説明 |
|---|---|
| なし |
この例では、現在の Android デバイスとアプリケーション「PushAppName」のプッシュトークンを登録します。
FirebaseMessaging.getInstance().token.addOnCompleteListener { task ->
val token = task.result
if (!task.isSuccessful || token == null) {
throw Exception("Unable to fetch token"))
}
pushService.registerPushToken(token, "PushAppName", {
Log.v(TAG, "Successfully registered push token")
}, { e ->
Log.e(TAG, "Error registering push", e)
})
}
NowPushService - unregisterPushToken(pushToken: String, pushApp: String, successCallback: Runnable, errorCallback: Consumer<Throwable>)
指定された Firebase プッシュトークンを関連する ServiceNow インスタンスで登録解除します。
| 名前 | タイプ | 説明 |
|---|---|---|
| プッシュトークン | 文字列 | Firebase 登録解除するトークン。com.google.firebase.messaging.FirebaseMessaging.getToken または com.google.firebase.messaging.FirebaseMessagingService.onNewToken によって取得されます。 |
| プッシュアプリ | 文字列 | 登録解除するトークンに関連付けられたプッシュアプリケーションの名前。この情報は、関連付けられた ServiceNow インスタンスのプッシュアプリケーションテーブルに格納されます。 |
| 成功 コールバック | 実行可能ファイル | トークンの登録解除に成功したときに実行されるコールバック。 |
| エラーコールバック | コンシューマー <スロー可能> | トークンの登録解除に失敗したときに実行されるコールバック。 |
| タイプ | 説明 |
|---|---|
| なし |
このコード例は、ユーザーがアプリケーションからログアウトしたときなどにプッシュトークンを登録解除する方法を示しています。
pushService.unregisterPushtoken(token, "PushAppName", {
Log.v(TAG, "Successfully unregistered push token")
}, { e ->
Log.e(TAG, "Error unregistering push", e)
})