A3L Messagingのテスト

AndroidデバイスとFire OSデバイスにアプリをデプロイし、テストメッセージを送信することで、アプリをテストできます。このページでは、テストメッセージ送信時の3つのオプション（コンソール、サーバー側のスクリプト、ソリューション固有のAPI）について説明します。

通知を送信するには、アプリをインストールしたデバイスのデバイスIDが必要です。デバイスIDの取得方法の詳細については、A3L Messagingを初期化する方法を参照してください。

コンソールを使用したテスト方法
- ADMコンソールを使用してアプリをテストする方法
- Firebaseコンソールを使用してアプリをテストする方法
サーバー側のスクリプトを使用したテスト方法
ソリューション固有のAPIを使用したテスト方法
A3L Messagingの通知キー
トラブルシューティング
関連リソース

コンソールを使用したテスト方法

FCMとADMには、どちらもプッシュ通知を送信できるコンソールが用意されています。UIエクスペリエンスを利用したい場合は、この方法を使用できます。

ADMコンソールを使用してアプリをテストする方法

ADMとの統合をテストするには、ADMコンソールを使用し、以下の手順に従ってプッシュ通知を送信します。

ADMコンソールにアクセスし、プロンプトが表示された場合はログインします。
アプリの [クライアントIDとクライアントシークレット] を入力します。これらは、ADMの認証情報を取得したときに既に取得しています。
[デバイス登録ID] フィールドに、A3L Messagingを初期化したときに取得したデバイスIDを入力します。
[データメッセージ] を選択します。
送信する通知のキーと値のペアを追加します。
- タイトルを追加するには、[キー] に「a3l.notification.title」、[値] に任意の通知タイトルを設定します。
- 本文を追加するには、[キー] に「a3l.notification.body」、[値] に任意の通知テキストを設定します。
- 必要に応じて画像を追加するには、[キー] に「a3l.notification.image」、[値] に画像のURLを設定します。
- 必要なフィールドをすべて追加します。すべてのフィールドの一覧と、Androidの通知との対応関係については、A3L Messagingの通知キー参照してください。
[メッセージの有効期間] セクションで、メッセージの有効期間を選択します。
キーと値のペアをすべて追加したら、[テストメッセージを送信] をクリックします。

その後、デバイスで通知を確認してください。

独自のキーと値のペアを使用して、カスタムメッセージを送信することもできます。キーの名前は自由に選択できますが、A3L Messagingの通知キーとは異なる名前にしてください。カスタムメッセージは、A3LMessagingServiceクラスの実装のonMessageReceived()メソッド内で処理する必要があります。

Firebaseコンソールを使用してアプリをテストする方法

FCMとの統合をテストするには、FirebaseコンソールのNotifications Composerを使用してプッシュ通知を送信します。

Firebaseコンソールにアクセスします。
テストプッシュ通知を送信するプロジェクトを選択します。
左側のサイドバーの [エンゲージメント] セクションを展開し、[Cloud Messaging] を選択します。
[新しい通知] をクリックします。
[通知テキスト] フィールドにメッセージを入力します。必要に応じて、[通知のタイトル]、[通知画像]、[通知名] フィールドも入力できます。
[デバイスのプレビュー] セクションで、[テストメッセージを送信] をクリックします。
オーバーレイの [FCM登録トークンを追加] フィールドにデバイスIDを入力します。デバイスIDは、A3L Messagingを初期化したときに取得しています。
[テスト] をクリックします。

アプリにプッシュ通知が届きます。

サーバー側のスクリプトを使用したテスト方法

次のサーバー側のスクリプトを使用して、デバイスに通知を送信できます。

ADMWebServer.py：Fire OSデバイスに通知を送信するPythonスクリプトです。
FCMWebServer.py：Androidデバイスに通知を送信するPythonスクリプトです。

以下のボタンをクリックすると、スクリプトのコードを取得できます。テスト通知を送信するには、このコードをコピーしてエディターに貼り付け、コメントに示されている値を更新します。その後、それぞれを.pyファイルとして保存し、スクリプトを実行します。

クリップボードにコピーされました。

ADMWebServer.py

import requests
import json

# プッシュ通知を送信するには、以下の値を更新してください

# ADMメッセージの送信に使用するクライアントID
client_id = ""

# ADMメッセージの送信に使用するクライアントシークレット
client_secret = ""

# 通知の送信先となるデバイスID
deviceId = ""

notification = {
    "title":"A3L通知",
    "body":"A3L通知はFire OSプラットフォームで機能しています。"
}


########### この行より下のコードは変更しないでください  ##################

Auth_token_URL = "https://api.amazon.com/auth/O2/token"
auth_token_headers = {'Content-Type' : 'application/x-www-form-urlencoded', 'Accept-Charset' : 'application/x-www-form-urlencoded'}
auth_token_data = {'grant_type' : 'client_credentials', 'scope': 'messaging:push', 'client_id': client_id, 'client_secret': client_secret}

send_message_url_part = "https://api.amazon.com/messaging/registrations/"
send_message_headers = {'Accept' : 'application/json', 'Content-Type': 'application/json', 'x-amzn-type-version': 'com.amazon.device.messaging.ADMMessage@1.0', 'x-amzn-accept-type': 'com.amazon.device.messaging.ADMSendResult@1.0'}
a3l_prefix = "a3l.notification."


def transformAndroidNotifcationToA3LNotification(notification):
  a3l_notification = {"data":{}}
  for notification_key, notification_value in notification.items():
    a3l_notification["data"][ a3l_prefix + notification_key] = notification_value
  return a3l_notification


def getAccessToken():
  r = requests.post(Auth_token_URL, data = auth_token_data, headers = auth_token_headers)
  json_response = r.json()
  auth_token = json_response["access_token"]
  return auth_token

def sendMessage():
  auth_token = "Bearer " + getAccessToken()
  send_message_url = send_message_url_part + deviceId + "/messages"
  send_message_headers['Authorization'] = auth_token
  send_message_data = transformAndroidNotifcationToA3LNotification(notification)
  r = requests.post(send_message_url, data = json.dumps(send_message_data), headers = send_message_headers)
  print('メッセージの送信に成功しました：',r.json())

sendMessage()

ソリューション固有のAPIを使用したテスト方法

FCMとADMには、どちらもデバイスにメッセージを送信するためのAPIが用意されています。これらのAPIを使用してメッセージを送信する方法の詳細については、以下のガイドを参照してください。

A3L Messagingの通知キー

A3L Messagingの通知キーは、Androidの通知キーと似ています。A3L Messagingのすべての通知キーには、ベースフィールド名の前に「a3l.notification.」というプレフィックスが付いています。このプレフィックスにより、同様のフィールド名を持つAndroidの通知キーとの競合が回避されます。

A3L Messagingの通知フィールドは、Androidの対応する通知フィールドと同じように動作します。フィールドのデータ型と機能は同じです。次の表は、A3L Messagingの通知フィールドとAndroidの対応する通知フィールドの完全な一覧です。

A3L Messagingの通知フィールド	Androidの通知フィールド
a3l.notification.title	title
a3l.notification.body	body
a3l.notification.image	image
a3l.notification.icon	icon
a3l.notification.color	color
a3l.notification.sound	sound
a3l.notification.tag	tag
a3l.notification.click_action	click_action
a3l.notification.channel_id	channel_id
a3l.notification.sticky	sticky
a3l.notification.event_time	event_time
a3l.notification.local_only	local_only
a3l.notification.notification_priority	notification_priority
a3l.notification.default_sound	default_sound
a3l.notification.visibility	visibility
a3l.notification.notification_count	notification_count

トラブルシューティング

エミュレーターデバイスの使用中に、「No Valid Platform Found」（有効なプラットフォームがありません）というエラーでA3Lがクラッシュした場合は、エミュレーターにGoogle Playサービスがインストールされていない可能性があります。この場合は、これらのデバイスでテストを行う前に、Google Playサービスをセットアップする必要があります。

A3L Messagingサンプルアプリ