Most visited

Recently visited

ContentRecommendation.Builder

public static final class ContentRecommendation.Builder
extends Object

java.lang.Object
   ↳ android.support.app.recommendation.ContentRecommendation.Builder


ContentRecommendation对象的生成器类。 提供一种方便的方法来设置ContentRecommendation的各个字段。

例:

 ContentRecommendation rec = new ContentRecommendation.Builder()
         .setIdInfo(id, "MyTagId")
         .setTitle("My Content Recommendation")
         .setText("An example of content recommendation")
         .setContentImage(myBitmap)
         .setBadgeIcon(R.drawable.app_icon)
         .setGroup("Trending")
         .build();
 

Summary

Public constructors

ContentRecommendation.Builder()

构建一个新的Builder。

Public methods

ContentRecommendation build()

结合所有已设置的选项并返回一个新的 ContentRecommendation对象。

ContentRecommendation.Builder setAutoDismiss(boolean autoDismiss)

设置指示是否应该自动解除建议的标志。

ContentRecommendation.Builder setBackgroundImageUri(String imageUri)

设置将用于检索建议的背景图像的内容URI。

ContentRecommendation.Builder setBadgeIcon(int iconResourceId)

设置推荐徽章图标的资源ID。

ContentRecommendation.Builder setColor(int color)

向用户显示此内容推荐时,设置要在用户界面中使用的重音颜色值。

ContentRecommendation.Builder setContentImage(Bitmap image)

设置推荐图像。

ContentRecommendation.Builder setContentIntentData(int intentType, Intent intent, int requestCode, Bundle options)

设置用户点击建议时将发布的Intent的数据。

ContentRecommendation.Builder setContentTypes(String[] types)

设置与内容推荐相关的内容类型。

ContentRecommendation.Builder setDismissIntentData(int intentType, Intent intent, int requestCode, Bundle options)

设置由于用户操作而导致建议从主屏幕退出时将发出的Intent数据。

ContentRecommendation.Builder setGenres(String[] genres)

设置建议的内容类型。

ContentRecommendation.Builder setGroup(String groupTag)

设置建议的字符串组ID标记。

ContentRecommendation.Builder setIdTag(String idTag)

设置唯一标识此推荐对象的Id标签。

ContentRecommendation.Builder setMaturityRating(String maturityRating)

设置内容的成熟度等级。

ContentRecommendation.Builder setPricingInformation(String priceType, String priceValue)

设置建议的定价和可用性信息。

ContentRecommendation.Builder setProgress(int max, int progress)

设置建议指向的内容的进度信息。

ContentRecommendation.Builder setRunningTime(long length)

设置内容的运行时间(适用时)。

ContentRecommendation.Builder setSortKey(String sortKey)

设置建议的字符串排序键。

ContentRecommendation.Builder setSourceName(String source)

设置建议的源应用程序名称。

ContentRecommendation.Builder setStatus(int contentStatus)

设置内容的可用性状态。

ContentRecommendation.Builder setText(String description)

设置建议的描述文本。

ContentRecommendation.Builder setTitle(String title)

设置建议的内容标题。

Inherited methods

From class java.lang.Object

Public constructors

ContentRecommendation.Builder

ContentRecommendation.Builder ()

构建一个新的Builder。

Public methods

build

ContentRecommendation build ()

组合所有已设置的选项并返回一个新的 ContentRecommendation对象。

Returns
ContentRecommendation

setAutoDismiss

ContentRecommendation.Builder setAutoDismiss (boolean autoDismiss)

设置指示是否应该自动解除建议的标志。

当用户点击主屏幕时,自动关闭通知会自动删除。

Parameters
autoDismiss boolean: A boolean indicating if the recommendation should be auto dismissed or not.
Returns
ContentRecommendation.Builder The Builder object, for chaining.

setBackgroundImageUri

ContentRecommendation.Builder setBackgroundImageUri (String imageUri)

设置将用于检索建议的背景图像的内容URI。

Parameters
imageUri String: A Content URI pointing to the recommendation background image.
Returns
ContentRecommendation.Builder The Builder object, for chaining.

setBadgeIcon

ContentRecommendation.Builder setBadgeIcon (int iconResourceId)

设置推荐徽章图标的资源ID。

资源ID代表源应用程序包中的图标资源。 如果未设置,或者指定了无效的资源ID,则默认使用从其包中检索的应用程序图标。

Parameters
iconResourceId int: An integer id for the badge icon resource.
Returns
ContentRecommendation.Builder The Builder object, for chaining.

setColor

ContentRecommendation.Builder setColor (int color)

向用户显示此内容推荐时,设置要在用户界面中使用的重音颜色值。

Parameters
color int: An integer value representing the accent color for this recommendation.
Returns
ContentRecommendation.Builder The Builder object, for chaining.

setContentImage

ContentRecommendation.Builder setContentImage (Bitmap image)

设置推荐图像。

Parameters
image Bitmap: A Bitmap containing the recommendation image.
Returns
ContentRecommendation.Builder The Builder object, for chaining.

setContentIntentData

ContentRecommendation.Builder setContentIntentData (int intentType, 
                Intent intent, 
                int requestCode, 
                Bundle options)

设置用户点击建议时将发布的Intent的数据。

提供的Intent数据字段与创建新的PendingIntent时传递到PendingIntent工厂方法的字段相对应。 实际的PengindIntent对象只会在建议发布到主屏幕时创建。

Parameters
intentType int: The type of PendingIntent to be created when posting this recommendation.
intent Intent: The Intent which to be issued when the recommendation is clicked on.
requestCode int: The private request code to be used when creating the PendingIntent
options Bundle: Only used for the Activity Intent type. Additional options for how the Activity should be started. May be null if there are no options.
Returns
ContentRecommendation.Builder The Builder object, for chaining.

setContentTypes

ContentRecommendation.Builder setContentTypes (String[] types)

设置与内容推荐相关的内容类型。 第一个标签条目将被视为内容的主要类型,并将用于排名目的。 如果适用的话,可以提供其他辅助类型标签,并且可以用于过滤目的。

Parameters
types String: Array of predefined type tags (see the CONTENT_TYPE_* constants) that describe the recommended content.
Returns
ContentRecommendation.Builder

setDismissIntentData

ContentRecommendation.Builder setDismissIntentData (int intentType, 
                Intent intent, 
                int requestCode, 
                Bundle options)

设置由于用户操作而导致建议从主屏幕退出时将发出的Intent数据。

提供的Intent数据字段对应于创建新的PendingIntent时传递到PendingIntent工厂方法的字段。 实际的PengindIntent对象只会在建议发布到主屏幕时创建。

Parameters
intentType int: The type of PendingIntent to be created when posting this recommendation.
intent Intent: The Intent which gets issued when the recommendation is dismissed from the Home Screen.
requestCode int: The private request code to be used when creating the PendingIntent
options Bundle: Only used for the Activity Intent type. Additional options for how the Activity should be started. May be null if there are no options.
Returns
ContentRecommendation.Builder The Builder object, for chaining.

setGenres

ContentRecommendation.Builder setGenres (String[] genres)

设置建议的内容类型。 这些类型可用于内容排名。 流派是开放式结束字符串标记。

例如:“喜剧”,“动作”,“跳舞”,“电子乐”,“赛车”等。

Parameters
genres String: Array of genre string tags that describe the recommended content.
Returns
ContentRecommendation.Builder

setGroup

ContentRecommendation.Builder setGroup (String groupTag)

设置建议的字符串组ID标记。

同一组中的建议一起按主屏幕排列,并且组内的排序顺序受到尊重。 如果应用程序有不同的推荐来源,比如YouTube的“趋势”,“订阅”和“新音乐”类别,用户可以对其中一组的推荐更感兴趣,那么这会非常有用。

Parameters
groupTag String: A String containing the group ID tag for this recommendation.
Returns
ContentRecommendation.Builder The Builder object, for chaining.

setIdTag

ContentRecommendation.Builder setIdTag (String idTag)

设置唯一标识此推荐对象的Id标签。

Parameters
idTag String: A String tag identifier for this recommendation.
Returns
ContentRecommendation.Builder The Builder object, for chaining.

setMaturityRating

ContentRecommendation.Builder setMaturityRating (String maturityRating)

设置内容的成熟度等级。

Parameters
maturityRating String: A tag indicating the maturity level rating for the content. This tag must be one of the predefined maturity rating tags (see the CONTENT_MATURITY_* constants).
Returns
ContentRecommendation.Builder

setPricingInformation

ContentRecommendation.Builder setPricingInformation (String priceType, 
                String priceValue)

设置建议的定价和可用性信息。 提供的信息将指示内容的访问模式(免费,租赁,购买或订阅)和价格(如果不是免费的)价值。

Parameters
priceType String: Pricing type for this content. Must be one of the predefined pricing type tags (see the CONTENT_PRICING_* constants).
priceValue String: A string containing a representation of the content price in the current locale and currency.
Returns
ContentRecommendation.Builder

setProgress

ContentRecommendation.Builder setProgress (int max, 
                int progress)

设置建议指向的内容的进度信息。

Parameters
max int: The maximum value for the progress of this content.
progress int: The progress amount for this content. Must be in the range (0 - max).
Returns
ContentRecommendation.Builder The Builder object, for chaining.

setRunningTime

ContentRecommendation.Builder setRunningTime (long length)

设置内容的运行时间(适用时)。

Parameters
length long: The running time, in seconds, of the content.
Returns
ContentRecommendation.Builder

setSortKey

ContentRecommendation.Builder setSortKey (String sortKey)

设置建议的字符串排序键。

排序键必须是介于0.0和1.0之间的浮点数的字符串表示形式,用于表示指定组内的单个建议的相对重要性(和排序顺序)。 这些建议将按照给定组内的重要性降序排列。

Parameters
sortKey String: A String containing the sort key for this recommendation.
Returns
ContentRecommendation.Builder The Builder object, for chaining.

setSourceName

ContentRecommendation.Builder setSourceName (String source)

设置建议的源应用程序名称。

如果源名称从未设置,或设置为null,则默认使用从其包中检索的应用程序名称。

Parameters
source String: A String containing the recommendation source name.
Returns
ContentRecommendation.Builder The Builder object, for chaining.

setStatus

ContentRecommendation.Builder setStatus (int contentStatus)

设置内容的可用性状态。 此状态指示引用的内容是否已准备好在设备上使用,或者用户是否必须先购买,租用,订阅或下载内容。

Parameters
contentStatus int: The status value for this content. Must be one of the predefined content status values (see the CONTENT_STATUS_* constants).
Returns
ContentRecommendation.Builder

setText

ContentRecommendation.Builder setText (String description)

设置建议的描述文本。

Parameters
description String: A String containing the recommendation description text.
Returns
ContentRecommendation.Builder The Builder object, for chaining.

setTitle

ContentRecommendation.Builder setTitle (String title)

设置建议的内容标题。

Parameters
title String: A String containing the recommendation content title.
Returns
ContentRecommendation.Builder The Builder object, for chaining.

Hooray!