推薦TV內(nèi)容

編寫:awong1900 - 原文:http://developer.android.com/training/tv/discovery/recommendations.html

當(dāng)操作TV時(shí)，用戶通常喜歡使用最少的輸入操作來(lái)找內(nèi)容。許多用戶的理想場(chǎng)景是，坐下，打開TV然后觀看。用最少的步驟讓用戶觀看他們的喜歡的內(nèi)容是最好的方式。

Android framework為了實(shí)現(xiàn)較少交互而提供了主屏幕推薦欄。在設(shè)備第一次使用時(shí)候，內(nèi)容推薦出現(xiàn)在TV主屏幕的第一欄。應(yīng)用程序的內(nèi)容目錄提供推薦建議可以把用戶帶回到我們的應(yīng)用。

http://wiki.jikexueyuan.com/project/android-training-geek/images/home-recommendations.png" alt="home-recommendations" />

圖1. 一個(gè)推薦欄的例子

這節(jié)課教我們?nèi)绾蝿?chuàng)建推薦和提供他們到Android framework，這樣用戶能容易的發(fā)現(xiàn)和使用我們的應(yīng)用內(nèi)容。這個(gè)討論描述了一些代碼，在Android Leanback示例代碼。

創(chuàng)建推薦服務(wù)

內(nèi)容推薦是被后臺(tái)處理創(chuàng)建。為了把我們的應(yīng)用提供到內(nèi)容推薦，創(chuàng)建一個(gè)周期性添加列表服務(wù)，從應(yīng)用目錄到系統(tǒng)推薦列表。

接下來(lái)的代碼描繪了如何擴(kuò)展IntentService為我們的應(yīng)用創(chuàng)建推薦服務(wù)：

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

    public UpdateRecommendationsService() {
        super("RecommendationService");
    }

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

        int count = 0;

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

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

                    builder.setBackground(movie.getCardImageUrl())
                            .setId(count + 1)
                            .setPriority(MAX_RECOMMENDATIONS - count)
                            .setTitle(movie.getTitle())
                            .setDescription(getString(R.string.popular_header))
                            .setImage(movie.getCardImageUrl())
                            .setIntent(buildPendingIntent(movie))
                            .build();

                    if (++count >= MAX_RECOMMENDATIONS) {
                        break;
                    }
                }
                if (++count >= MAX_RECOMMENDATIONS) {
                    break;
                }
            }
        } catch (IOException e) {
            Log.e(TAG, "Unable to update recommendation", e);
        }
    }

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

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

        PendingIntent intent = stackBuilder.getPendingIntent(0, PendingIntent.FLAG_UPDATE_CURRENT);
        return intent;
    }
}

使服務(wù)被系統(tǒng)意識(shí)和運(yùn)行，在應(yīng)用manifest中注冊(cè)它，接下來(lái)的代碼片段展示了如何定義這個(gè)類做為服務(wù)：

<manifest ... >
  <application ... >
    ...

    <service
            android:name="com.example.android.tvleanback.UpdateRecommendationsService"
            android:enabled="true" />
  </application>
</manifest>

刷新推薦

基于用戶的行為和數(shù)據(jù)來(lái)推薦，例如播放列表，喜愛列表和相關(guān)內(nèi)容。當(dāng)刷新推薦時(shí)，不僅僅是刪除和重新加載他們，因?yàn)檫@樣會(huì)導(dǎo)致推薦出現(xiàn)在推薦欄的結(jié)尾。一旦一個(gè)內(nèi)容項(xiàng)被播放，如一個(gè)影片，從推薦中刪除它。

應(yīng)用的推薦順序被保存依據(jù)應(yīng)用提供他們的順序。framework interleave應(yīng)用推薦基于推薦質(zhì)量，用戶習(xí)慣的收集。最好的推薦應(yīng)是推薦最合適的出現(xiàn)在列表前面。

創(chuàng)建推薦

一旦我們的推薦服務(wù)開始運(yùn)行，它必須創(chuàng)建推薦和推送他們到Android framework。Framework收到推薦作為通知對(duì)象。它用特定的模板并且標(biāo)記為特定的目錄。

設(shè)置值

去設(shè)置推薦卡片的UI元素，創(chuàng)建一個(gè)builder類用接下來(lái)的builder樣式描述。首先，設(shè)置推薦卡片元素的值。

public class RecommendationBuilder {
    ...

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

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

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

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

創(chuàng)建通知

一旦我們?cè)O(shè)置了值，然后去創(chuàng)建通知，從builder類分配值到通知，并且調(diào)用[NotificationCompat.Builder.build](http://developer.android.com/reference/android/support/v4/app/NotificationCompat.Builder.html#build())。

并且，確信調(diào)用setLocalOnly()，這樣NotificationCompat.BigPictureStyle通知不將顯示在另一個(gè)設(shè)備。

接下來(lái)的代碼示例展示了如何創(chuàng)建推薦。

public class RecommendationBuilder {
    ...

    public Notification build() throws IOException {
        ...

        Notification notification = new NotificationCompat.BigPictureStyle(
                new NotificationCompat.Builder(mContext)
                        .setContentTitle(mTitle)
                        .setContentText(mDescription)
                        .setPriority(mPriority)
                        .setLocalOnly(true)
                        .setOngoing(true)
                        .setColor(mContext.getResources().getColor(R.color.fastlane_background))
                        .setCategory(Notification.CATEGORY_RECOMMENDATION)
                        .setLargeIcon(image)
                        .setSmallIcon(mSmallIcon)
                        .setContentIntent(mIntent)
                        .setExtras(extras))
                .build();

        return notification;
    }
}

運(yùn)行推薦服務(wù)

我們的應(yīng)用推薦服務(wù)必須周期性運(yùn)行確保創(chuàng)建當(dāng)前的推薦。去運(yùn)行我們的服務(wù)，創(chuàng)建一個(gè)類運(yùn)行計(jì)時(shí)器和在周期間隔關(guān)聯(lián)它。接下來(lái)的代碼例子擴(kuò)展了BroadcastReceiver類去開始每半小時(shí)的推薦服務(wù)的周期性執(zhí)行：

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);
    }
}

這個(gè)BroadcastReceiver類的實(shí)現(xiàn)必須運(yùn)行在TV設(shè)備啟動(dòng)后。 為了完成這個(gè)，注冊(cè)這個(gè)類在應(yīng)用manifest的intet filter中，它監(jiān)聽設(shè)備啟動(dòng)完成。接下來(lái)的代碼展示了如何添加這個(gè)配置到manifest。

<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>

Important： 接收一個(gè)啟動(dòng)完成通知需要我們的應(yīng)用有RECEIVE_BOOT_COMPLETED權(quán)限。更多信息，查看ACTION_BOOT_COMPLETED。

在推薦服務(wù)類的onHandleIntent()方法中，用以下代碼提交推薦到管理器：

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

下一節(jié): 使TV應(yīng)用是可被搜索的 >