Android プレーヤーの実装

ここでは、Android プレーヤーの設定について説明します。使用可能な設定ファイルやオプションと、開発およびテストに使用する推奨設定について説明します。

さらに、プレーヤーをクラッシュから回復させるソリューションとして、ウォッチドッグ​があります。アプリケーションは、ウォッチドッグサービスに登録し、アプリケーション自体がアライブであることを知らせるメッセージを定期的に送信する必要があります。ウォッチドッグサービスに、所定の時間内にキープアライブメッセージが届かないと、ウォッチドッグサービスは、デバイスをリブートしてクリーンリカバリを試みるか（ウォッチドッグサービスが十分な権限が持つ場合）、アプリケーションの再起動を試みます。

Android プレーヤーのインストール

AEM Screens 用の Android プレーヤーを実装するには、同プレーヤーをインストールしてください。

AEM 6.5 Player のダウンロードページにアクセスします。

AEM Screens 6.5.5 Service Pack の環境の設定

AEM オーサーインスタンスおよびパブリッシュインスタンスで、Adobe Experience Manager Web コンソール設定​で、login-token cookies の SameSite 属性​を Lax から None に設定します。

その場合は、次の手順に従います。

1. http://localhost:4502/system/console/configMgr を使用して、Adobe Experience Manager Web コンソールの設定​に移動します。

2. Adobe Granite トークン認証ハンドラー​を検索します。

3. login-token cookie の SameSite 属性​を Lax から None に設定します。
   

4. 「保存」をクリックします。

アドホック方式

アドホック方式を使用すると、最新の Android プレーヤー（.exe）をインストールできます。AEM 6.5 Player のダウンロードページにアクセスします。

アプリケーションをダウンロードしたら、以下の手順に従ってプレーヤーのアドホックインストールを完了します。

1. 左上隅を長押しして、管理パネルを開きます。

2. 左のアクションメニューから「設定」に移動し、接続する AEM インスタンスの場所（アドレス）を入力して、「保存」をクリックします。

3. 左側のアクションメニューから「デバイス​の​登録」リンクに移動して、デバイス登録プロセスのステータスを確認します。

Android ウォッチドッグを実装する

Android のアーキテクチャ上、デバイスをリブートするには、アプリケーションがシステム権限を持っている必要があります。そのためには、製造元の署名キーを使用して apk に署名する必要があります。この署名をおこなわないと、ウォッチドッグはデバイスをリブートするのではなく、プレーヤーアプリケーションを再起動します。

製造元のキーを使用した Android apk への署名

PowerManager や HDMIControlServices など、Android の特権付き API にアクセスするには、製造元のキーを使用して Android apk に署名する必要があります。

次の手順に従って、製造元のキーを使用して Android apk に署名します。

1. Google Play または AEM Screens Player のダウンロードページから apk をダウンロードします。

2. 製造元のプラットフォームキーを入手して、pk8 ファイルと pem ファイルを取得します。

3. find ~/Library/Android/sdk/build-tools -name "apksigner" を使用して、Android SDK の apksigner ツールを見つけます。

4. <pathto> /apksigner sign --key platform.pk8 --cert platform.x509.pem aemscreensplayer.apk

5. Android SDK の zip align ツールへのパスを見つけます。

6. <pathto> /zipalign -fv 4 aemscreensplayer.apk aemscreensaligned.apk

7. adb install を使用して、デバイスに aemscreensaligned.apk をインストールします。

Androidウォッチドッグサービスについて

Android ウォッチドッグサービスは、AlarmManager を使用した cordova プラグインとして実装されます。

次の図に、ウォッチドッグサービスの実装を示します。

1.初期化：cordova プラグインの初期化時、システム権限を持っているかどうか、さらに、リブート権限を持っているかどうかの確認がおこなわれます。これらの 2 つの条件を満たしている場合は、リブートのペンディングインテントが作成され、条件を満たしていない場合は、（Launch Activity に基づいて）アプリケーションを再起動するためのペンディングインテントが作成されます。

2.キープアライブタイマー：15 秒おきにイベントをトリガーするためにキープアライブタイマーが使用されます。このイベントの間に、（アプリケーションをリブートまたは再起動する）既存のペンディングインテントをキャンセルし、次の 60 秒の間に新しいペンディングインテントを登録する（最終的にリブートを延期する）必要があります。

3.アプリケーションのクラッシュ：クラッシュした場合、AlarmManager に登録されているリブートのペンディングインテントはリセットされず、（cordova プラグインの初期化時に使用可能な権限に応じて）アプリケーションのリブートまたは再起動を実行します。

Android Playerの一括プロビジョニング

Androidプレーヤーを一括で展開する場合、管理者UIで手動で入力しなくても、AEMインスタンスを指すようにプレーヤーをプロビジョニングし、他のプロパティを設定する必要があります。

次の手順に従って、Android Playerで一括プロビジョニングを許可します。

1. player-config.default.jsonという名前で設定JSONファイルを作成します。
   JSONポリシーの例と、様々なポリシー属性の使い方を説明した表を参照してください。

2. MDM、ADB、またはAndroid Studioのファイルエクスプローラーを使用して、このポリシーJSONファイルをAndroidデバイスの​sdcard​フォルダーにドロップします。

3. ファイルをデプロイしたら、MDMを使用してプレイヤーアプリケーションをインストールします。

4. プレイヤーアプリケーションが起動すると、この設定ファイルが読み取られ、そのファイルを登録し、その後制御できる適切なAEMサーバーが参照されます。

   メモ

   このファイルは、アプリケーションが初めて起動されたときは​読み取り専用​で、以降の設定には使用できません。 設定ファイルが削除される前にプレーヤーが起動した場合は、アプリケーションをアンインストールして、デバイスに再インストールします。

ポリシー属性

次の表に、参照用のポリシー JSON の例と共にポリシー属性を示します。

JSONポリシーの例

{
  "server": "https://author-screensdemo.adobecqms.net",
"device": "",
"user": "",
"password": "",
"resolution": "auto",
"rebootSchedule": "at 4:00 am",
"maxNumberOfLogFilesToKeep": 10,
"logLevel": 3,
"enableAdminUI": true,
"enableOSD": true,
"enableActivityUI": false,
"enableNativeVideo": false,
"enableAutoScreenshot": false,
"cloudMode": false,
"cloudUrl": "https://screens.adobeioruntime.net",
"cloudToken": "",
"enableDeveloperMode": true
}