推荐TV内容

推荐TV内容

编写:awong1900 - 原文:<http://developer.android.com/training/tv/discovery/recommendations.html>

当操作TV时，用户通常喜欢使用最少的输入操作来找内容。许多用户的理想场景是，坐下，打开TV然后观看。用最少的步骤让用户观看他们的喜欢的内容是最好的方式。

Android framework为了实现较少交互而提供了主屏幕推荐栏。在设备第一次使用时候，内容推荐出现在TV主屏幕的第一栏。应用程序的内容目录提供推荐建议可以把用户带回到我们的应用。

图1. 一个推荐栏的例子

这节课教我们如何创建推荐和提供他们到Android framework，这样用户能容易的发现和使用我们的应用内容。这个讨论描述了一些代码，在Android Leanback示例代码。

创建推荐服务

内容推荐是被后台处理创建。为了把我们的应用提供到内容推荐，创建一个周期性添加列表服务，从应用目录到系统推荐列表。

接下来的代码描绘了如何扩展IntentService为我们的应用创建推荐服务：

1. public class UpdateRecommendationsService extends IntentService {
2. private static final String TAG = "UpdateRecommendationsService";
3. private static final int MAX_RECOMMENDATIONS = 3;

5. public UpdateRecommendationsService() {
6. super("RecommendationService");
7. }

9. @Override
10. protected void onHandleIntent(Intent intent) {
11. Log.d(TAG, "Updating recommendation cards");
12. HashMap<String, List<Movie>> recommendations = VideoProvider.getMovieList();
13. if (recommendations == null) return;

15. int count = 0;

17. try {
18. RecommendationBuilder builder = new RecommendationBuilder()
19. .setContext(getApplicationContext())
20. .setSmallIcon(R.drawable.videos_by_google_icon);

22. for (Map.Entry<String, List<Movie>> entry : recommendations.entrySet()) {
23. for (Movie movie : entry.getValue()) {
24. Log.d(TAG, "Recommendation - " + movie.getTitle());

26. builder.setBackground(movie.getCardImageUrl())
27. .setId(count + 1)
28. .setPriority(MAX_RECOMMENDATIONS - count)
29. .setTitle(movie.getTitle())
30. .setDescription(getString(R.string.popular_header))
31. .setImage(movie.getCardImageUrl())
32. .setIntent(buildPendingIntent(movie))
33. .build();

35. if (++count >= MAX_RECOMMENDATIONS) {
36. break;
37. }
38. }
39. if (++count >= MAX_RECOMMENDATIONS) {
40. break;
41. }
42. }
43. } catch (IOException e) {
44. Log.e(TAG, "Unable to update recommendation", e);
45. }
46. }

48. private PendingIntent buildPendingIntent(Movie movie) {
49. Intent detailsIntent = new Intent(this, DetailsActivity.class);
50. detailsIntent.putExtra("Movie", movie);

52. TaskStackBuilder stackBuilder = TaskStackBuilder.create(this);
53. stackBuilder.addParentStack(DetailsActivity.class);
54. stackBuilder.addNextIntent(detailsIntent);
55. // Ensure a unique PendingIntents, otherwise all recommendations end up with the same
56. // PendingIntent
57. detailsIntent.setAction(Long.toString(movie.getId()));

59. PendingIntent intent = stackBuilder.getPendingIntent(0, PendingIntent.FLAG_UPDATE_CURRENT);
60. return intent;
61. }
62. }

使服务被系统意识和运行，在应用manifest中注册它，接下来的代码片段展示了如何定义这个类做为服务：

1. <manifest ... >
2. <application ... >
3. ...

5. <service
6. android:name="com.example.android.tvleanback.UpdateRecommendationsService"
7. android:enabled="true" />
8. </application>
9. </manifest>

刷新推荐

基于用户的行为和数据来推荐，例如播放列表，喜爱列表和相关内容。当刷新推荐时，不仅仅是删除和重新加载他们，因为这样会导致推荐出现在推荐栏的结尾。一旦一个内容项被播放，如一个影片，从推荐中删除它。

应用的推荐顺序被保存依据应用提供他们的顺序。framework interleave应用推荐基于推荐质量，用户习惯的收集。最好的推荐应是推荐最合适的出现在列表前面。

创建推荐

一旦我们的推荐服务开始运行，它必须创建推荐和推送他们到Android framework。Framework收到推荐作为通知对象。它用特定的模板并且标记为特定的目录。

设置值

去设置推荐卡片的UI元素，创建一个builder类用接下来的builder样式描述。首先，设置推荐卡片元素的值。

1. public class RecommendationBuilder {
2. ...

4. public RecommendationBuilder setTitle(String title) {
5. mTitle = title;
6. return this;
7. }

9. public RecommendationBuilder setDescription(String description) {
10. mDescription = description;
11. return this;
12. }

14. public RecommendationBuilder setImage(String uri) {
15. mImageUri = uri;
16. return this;
17. }

19. public RecommendationBuilder setBackground(String uri) {
20. mBackgroundUri = uri;
21. return this;
22. }
23. ...

创建通知

一旦我们设置了值，然后去创建通知，从builder类分配值到通知，并且调用NotificationCompat.Builder.build。

并且，确信调用setLocalOnly()，这样NotificationCompat.BigPictureStyle通知不将显示在另一个设备。

接下来的代码示例展示了如何创建推荐。

1. public class RecommendationBuilder {
2. ...

4. public Notification build() throws IOException {
5. ...

7. Notification notification = new NotificationCompat.BigPictureStyle(
8. new NotificationCompat.Builder(mContext)
9. .setContentTitle(mTitle)
10. .setContentText(mDescription)
11. .setPriority(mPriority)
12. .setLocalOnly(true)
13. .setOngoing(true)
14. .setColor(mContext.getResources().getColor(R.color.fastlane_background))
15. .setCategory(Notification.CATEGORY_RECOMMENDATION)
16. .setLargeIcon(image)
17. .setSmallIcon(mSmallIcon)
18. .setContentIntent(mIntent)
19. .setExtras(extras))
20. .build();

22. return notification;
23. }
24. }

运行推荐服务

我们的应用推荐服务必须周期性运行确保创建当前的推荐。去运行我们的服务，创建一个类运行计时器和在周期间隔关联它。接下来的代码例子扩展了BroadcastReceiver类去开始每半小时的推荐服务的周期性执行：

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

4. private static final long INITIAL_DELAY = 5000;

6. @Override
7. public void onReceive(Context context, Intent intent) {
8. Log.d(TAG, "BootupActivity initiated");
9. if (intent.getAction().endsWith(Intent.ACTION_BOOT_COMPLETED)) {
10. scheduleRecommendationUpdate(context);
11. }
12. }

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

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

21. alarmManager.setInexactRepeating(AlarmManager.ELAPSED_REALTIME_WAKEUP,
22. INITIAL_DELAY,
23. AlarmManager.INTERVAL_HALF_HOUR,
24. alarmIntent);
25. }
26. }

这个BroadcastReceiver类的实现必须运行在TV设备启动后。为了完成这个，注册这个类在应用manifest的intet filter中，它监听设备启动完成。接下来的代码展示了如何添加这个配置到manifest。

1. <manifest ... >
2. <application ... >
3. <receiver android:name="com.example.android.tvleanback.BootupActivity"
4. android:enabled="true"
5. android:exported="false">
6. <intent-filter>
7. <action android:name="android.intent.action.BOOT_COMPLETED"/>
8. </intent-filter>
9. </receiver>
10. </application>
11. </manifest>

Important：接收一个启动完成通知需要我们的应用有RECEIVE_BOOT_COMPLETED权限。更多信息，查看ACTION_BOOT_COMPLETED。

在推荐服务类的onHandleIntent()方法中，用以下代码提交推荐到管理器：

1. Notification notification = notificationBuilder.build();
2. mNotificationManager.notify(id, notification);

下一节: 使TV应用是可被搜索的 >

TV上的推荐内容