Android N 以前でのおすすめの表示

一般的に、ユーザーは TV を操作するとき、最小限の入力でコンテンツを視聴することを好みます。多くの TV ユーザーにとって理想的なシナリオは、「TV の前に座り、電源を入れ、コンテンツを視聴する」というものです。最小限の操作で目当てのコンテンツにたどり着くのが、ユーザーが好む一般的な手順です。

注: Android 7.1（API レベル 25）以前のバージョンの Android で実行されているアプリでおすすめを作成する場合は、ここで説明する API を使用してください。Android 8.0（API レベル 26）以降で実行されているアプリでおすすめを提供するには、アプリでおすすめのチャンネルを使用する必要があります。

Android フレームワークはホーム画面におすすめの行を表示することで、ユーザーが最小限の入力でコンテンツを視聴できるようにします。デバイスを初めて使用した後、おすすめコンテンツが TV のホーム画面の最初の行として表示されます。アプリのコンテンツカタログからおすすめを作成すると、ユーザーのアプリの使用頻度を高めることができます。

図 1. おすすめの行の例

このレッスンでは、ユーザーがアプリのコンテンツを簡単に見つけて楽しむことができるように、おすすめを作成して Android フレームワークに提供する方法について説明します。また、Android TV の GitHub リポジトリにある Android Leanback サンプルアプリの一部のコードについて説明します。

おすすめカードの UI 要素の値を設定するには、下記のビルダーパターンに従うビルダークラスを作成します。まず、おすすめカードの要素の値を設定します。

Kotlin

    class RecommendationBuilder {
        ...

        fun setTitle(title: String): RecommendationBuilder {
            this.title = title
            return this
        }

        fun setDescription(description: String): RecommendationBuilder {
            this.description = description
            return this
        }

        fun setImage(uri: String): RecommendationBuilder {
            imageUri = uri
            return this
        }

        fun setBackground(uri: String): RecommendationBuilder {
            backgroundUri = uri
            return this
        }

    ...

Java

    public class RecommendationBuilder {
        ...

        public RecommendationBuilder setTitle(String title) {
                this.title = title;
                return this;
            }

            public RecommendationBuilder setDescription(String description) {
                this.description = description;
                return this;
            }

            public RecommendationBuilder setImage(String uri) {
                imageUri = uri;
                return this;
            }

            public RecommendationBuilder setBackground(String uri) {
                backgroundUri = uri;
                return this;
            }
    ...

通知を作成する

値を設定したら、ビルダークラスから通知に値を割り当て、NotificationCompat.Builder.build() を呼び出して、通知を作成します。

また、setLocalOnly() を呼び出して、NotificationCompat.BigPictureStyle 通知が他のデバイスに表示されないようにします。

次のコードサンプルは、おすすめを作成する方法を示しています。

Kotlin

    class RecommendationBuilder {
        ...

        @Throws(IOException::class)
        fun build(): Notification {
            ...

            val notification = NotificationCompat.BigPictureStyle(
            NotificationCompat.Builder(context)
                    .setContentTitle(title)
                    .setContentText(description)
                    .setPriority(priority)
                    .setLocalOnly(true)
                    .setOngoing(true)
                    .setColor(context.resources.getColor(R.color.fastlane_background))
                    .setCategory(Notification.CATEGORY_RECOMMENDATION)
                    .setLargeIcon(image)
                    .setSmallIcon(smallIcon)
                    .setContentIntent(intent)
                    .setExtras(extras))
                    .build()

            return notification
        }
    }

Java

    public class RecommendationBuilder {
        ...

        public Notification build() throws IOException {
            ...

            Notification notification = new NotificationCompat.BigPictureStyle(
                    new NotificationCompat.Builder(context)
                            .setContentTitle(title)
                            .setContentText(description)
                            .setPriority(priority)
                            .setLocalOnly(true)
                            .setOngoing(true)
                            .setColor(context.getResources().getColor(R.color.fastlane_background))
                            .setCategory(Notification.CATEGORY_RECOMMENDATION)
                            .setLargeIcon(image)
                            .setSmallIcon(smallIcon)
                            .setContentIntent(intent)
                            .setExtras(extras))
                    .build();

            return notification;
        }
    }

おすすめサービスを実行する

アプリのおすすめサービスは、最新のおすすめを作成するために、定期的に実行する必要があります。サービスを実行するには、タイマーを実行してサービスを定期的に呼び出すクラスを作成します。次のコードサンプルでは、BroadcastReceiver クラスを拡張して、30 分ごとにおすすめサービスを実行しています。

Kotlin

    class BootupActivity : BroadcastReceiver() {
        override fun onReceive(context: Context, intent: Intent) {
            Log.d(TAG, "BootupActivity initiated")
            if (intent.action.endsWith(Intent.ACTION_BOOT_COMPLETED)) {
                scheduleRecommendationUpdate(context)
            }
        }

        private fun scheduleRecommendationUpdate(context: Context) {
            Log.d(TAG, "Scheduling recommendations update")
            val alarmManager = context.getSystemService(Context.ALARM_SERVICE) as AlarmManager
            val recommendationIntent = Intent(context, UpdateRecommendationsService::class.java)
            val alarmIntent = PendingIntent.getService(context, 0, recommendationIntent, 0)
            alarmManager.setInexactRepeating(AlarmManager.ELAPSED_REALTIME_WAKEUP,
                    INITIAL_DELAY,
                    AlarmManager.INTERVAL_HALF_HOUR,
                    alarmIntent
            )
        }

        companion object {
            private val TAG = "BootupActivity"
            private val INITIAL_DELAY:Long = 5000
        }
    }

Java

    public class BootupActivity extends BroadcastReceiver {
        private static final String TAG = "BootupActivity";

        private static final long INITIAL_DELAY = 5000;

        @Override
        public void onReceive(Context context, Intent intent) {
            Log.d(TAG, "BootupActivity initiated");
            if (intent.getAction().endsWith(Intent.ACTION_BOOT_COMPLETED)) {
                scheduleRecommendationUpdate(context);
            }
        }

        private void scheduleRecommendationUpdate(Context context) {
            Log.d(TAG, "Scheduling recommendations update");

            AlarmManager alarmManager = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
            Intent recommendationIntent = new Intent(context, UpdateRecommendationsService.class);
            PendingIntent alarmIntent = PendingIntent.getService(context, 0, recommendationIntent, 0);

            alarmManager.setInexactRepeating(AlarmManager.ELAPSED_REALTIME_WAKEUP,
                    INITIAL_DELAY,
                    AlarmManager.INTERVAL_HALF_HOUR,
                    alarmIntent);
        }
    }

この BroadcastReceiver クラスの実装は、インストール対象のテレビデバイスの起動後に実行する必要があります。そのためには、デバイスの起動プロセスの完了をリッスンするインテントフィルタを使用して、アプリマニフェストにこのクラスを登録します。次のコードサンプルは、この構成をマニフェストに追加する方法を示しています。

    <manifest ... >
      <application ... >
        <receiver android:name="com.example.android.tvleanback.BootupActivity"
                  android:enabled="true"
                  android:exported="false">
          <intent-filter>
            <action android:name="android.intent.action.BOOT_COMPLETED"/>
          </intent-filter>
        </receiver>
      </application>
    </manifest>

重要: 起動完了の通知を受け取るには、アプリは RECEIVE_BOOT_COMPLETED 権限をリクエストする必要があります。詳細については、ACTION_BOOT_COMPLETED をご覧ください。

おすすめサービスクラスの onHandleIntent() メソッドで、次のようにしておすすめをマネージャーに送信します。

Kotlin

    val notification = notificationBuilder.build()
    notificationManager.notify(id, notification)

Java

    Notification notification = notificationBuilder.build();
    notificationManager.notify(id, notification);

動画をプレビューする

Android N 以前でのおすすめの表示

おすすめに関するベストプラクティス

おすすめのタイプ

おすすめを更新する

おすすめをカスタマイズする

おすすめをグループ化する

おすすめサービスを作成する

Kotlin

Java

おすすめを作成する

値を設定する

Kotlin

Java

通知を作成する

Kotlin

Java

おすすめサービスを実行する

Kotlin

Java

Kotlin

Java

Android N 以前でのおすすめの表示

おすすめに関するベスト プラクティス

おすすめのタイプ

おすすめを更新する

おすすめをカスタマイズする

おすすめをグループ化する

おすすめサービスを作成する

Kotlin

Java

おすすめを作成する

値を設定する

Kotlin

Java

通知を作成する

Kotlin

Java

おすすめサービスを実行する

Kotlin

Java

Kotlin

Java

おすすめに関するベストプラクティス