このページは Cloud Translation API によって翻訳されました。

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

一般的に、ユーザーはテレビを操作する際、視聴前の入力を最小限にすることを好みます。説明します。多くの TV ユーザーにとって理想的なシナリオは、「TV の前に座り、電源を入れ、コンテンツを視聴する」というものです。最小限のステップ一般的に、ユーザーが好むコンテンツにユーザーを誘導するのがよいでしょう。

注: 推奨事項の作成には、ここで説明する API を使用してください。 Android 7.1（API レベル 25）以前の Android バージョンで実行されているアプリでのみ利用可能。供給 Android 8.0（API レベル 26）以降で実行されるアプリの推奨事項については、おすすめのチャンネル。

Android フレームワークは、レコメンデーション行を提供することで最小限の入力インタラクションを支援をタップします。おすすめのコンテンツは、テレビのホーム画面の最上部に表示され、。アプリのコンテンツカタログからおすすめ情報を提供することで、ユーザーをアプリに呼び戻すことができます

図 1. 最適化案行の例。

このガイドでは、おすすめを作成して Android フレームワークに提供する方法について説明します。ユーザーがアプリのコンテンツを簡単に見つけて楽しめるようになります。次のサンプル実装もご覧ください: <ph type="x-smartling-placeholder"></ph> 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

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