概要

着信などのイベントにおいて、ユーザーはアプリがアクティブでなくてもプッシュ通知を受け取ることを期待することが多い。また、プッシュ通知を 接続サービス を使用して、システムUIで着信を表示します。このガイドでは、Client SDKからプッシュ通知を受け取るようにAndroidアプリを設定する方法を説明します。

VonageをFirebaseに接続

プッシュ通知を受け取るには、VonageとFirebaseを接続する必要があります。そのためには以下が必要です：

1. FirebaseプロジェクトID
2. Firebaseサービスアカウントのキー

VonageアプリケーションIDの取得

Vonage API アプリケーション ID を取得します。の既存のアプリケーションにアクセスできます。 ダッシュボード.まだアプリケーションをお持ちでない場合は、以下の方法で新しいアプリケーションを作成できます。 Vonage CLI.

FirebaseプロジェクトIDの取得

FirebaseプロジェクトIDを Firebaseコンソール.に移動する。 Firebase console -> Project settings -> General.

Firebaseサービスアカウントキーの取得

Firebaseサーバーキーを Firebaseコンソール.に移動する。 Firebase console -> Project settings -> Service accounts を作成し、新しい秘密鍵を生成する。

VonageアプリケーションをFirebaseに接続する

APIダッシュボードを使用して認証情報をVonageにアップロードします。アプリケーションを ダッシュボード次に、"プッシュ通知を有効にする "タブを開きます：

Firebase Project ID を入力し、前のステップで作成した Service Account Key をアップロードします。

ターミナルの使用

ターミナルを使用して、VonageバックエンドプッシュサービスとFirebaseアプリケーションを接続することもできます。その場合は Vonage Application ID が必要で、Vonage admin JWT を生成する必要があります。

充填 VONAGE_APP_ID, VONAGE_JWT, FIREBASE_PROJECT_IDそして FIREBASE_SERVICE_ACCOUNT を以前に取得した を設定し、以下のコマンドを実行してリクエストを送信する。あなたの FIREBASE_SERVICE_ACCOUNT の秘密鍵でなければなりません。 の秘密鍵を、特殊文字をエスケープした文字列で指定します：

既存のトークンを更新する場合は、まず既存のトークンを削除します。 DELETE リクエストを同じ リクエストを、同じ認証で同じエンドポイントに送る。

AndroidアプリケーションにFirebaseプロジェクトを設定する

Androidアプリケーションでプッシュ通知を有効にするには、Androidアプリケーションを設定する必要があります。

Androidプロジェクトを設定する

まずは、Androidプロジェクトに必要な依存関係を設定するところから始めよう。

Client SDKの依存関係の追加

Client SDKの追加 をプロジェクトに加える。

アプリケーションにFirebaseの設定を追加する

プッシュ通知に特化した設定を行う前に、いくつかの一般的なステップを踏む必要があります。 アプリ内でFirebaseをセットアップする必要があります。

Firebaseプロジェクトから "add Android app "オプションをクリックします：

表示されたフォームに必要事項を入力し、Firebaseプロジェクトにアプリケーションを登録します。

すると、"Download google-services.json "ボタンが表示されるので、これをクリックしてファイルをダウンロードする。

Android Studioのプロジェクトビューに切り替えて、プロジェクトのルートディレクトリを確認します。

ダウンロードしたgoogle-services.jsonファイルをAndroidアプリモジュールのルートディレクトリに移動します。

最後に、Google servicesプラグインを追加し、google-services.jsonファイルを読み込む必要があります。プロジェクトレベルの プロジェクトレベルの build.gradle ファイルに追加する：

また、アプリレベルでは build.gradle ベースとなるFirebase BoMの実装

Firebase Cloud Messaging Dependency を追加します。

IDEのアプリレベルで build.gradle ファイル（通常は app/build.gradleを追加する。 firebase-messaging 依存性がある：

プッシュ・トークンの登録

プッシュを受信するには、ユーザーのプッシュトークンをVonageのバックエンドに登録する必要があります。 を使用して registerDevicePushToken()

registerDevicePushToken() は、ユーザーのデバイスに固有のデバイスIDを返します。ユーザーは複数のデバイスを登録することができます。 このデバイスIDは、将来プッシュ通知を受け取らないようにするために、後でユーザーデバイスの登録を解除するために使用することができます。

Firebase Receiver Serviceの実装

firebase メッセージを受信するには、firebase messaging service を実装する必要があります。また 受信したメッセージがvonageメッセージかどうか、もしそうならどのタイプかを getPushNotificationType() ヘルパー・メソッド。もしそれが であれば INCOMING_CALL ヘルパーメソッドを使って適切に処理します。 processPushInvite().

着信に応答する

もし processPushCallInvite に成功すると、SDKからあなたのアプリケーションに着信の招待が届きます。応答するには firebaseプッシュ通知から受信した招待に応答します：

着信を拒否する

firebaseプッシュ通知からの招待を拒否する：

結論

このガイドでは、プッシュ通知を設定する方法を見てきました。

声だ：

• を統合することができる。 接続サービス アプリケーションの アプリケーションに追加することで、システムUIと統合することができます。
• を見る ConnectionService サンプル・プロジェクト をGitHubで公開している。