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
ContentRecommendation.Builder ()
构建一个新的Builder。
Public methods
setAutoDismiss
ContentRecommendation.Builder setAutoDismiss (boolean autoDismiss)
设置指示是否应该自动解除建议的标志。
当用户点击主屏幕时,自动关闭通知会自动删除。
Parameters |
autoDismiss |
boolean : A boolean indicating if the recommendation should be auto dismissed or not. |
setBackgroundImageUri
ContentRecommendation.Builder setBackgroundImageUri (String imageUri)
设置将用于检索建议的背景图像的内容URI。
Parameters |
imageUri |
String : A Content URI pointing to the recommendation background image. |
setBadgeIcon
ContentRecommendation.Builder setBadgeIcon (int iconResourceId)
设置推荐徽章图标的资源ID。
资源ID代表源应用程序包中的图标资源。 如果未设置,或者指定了无效的资源ID,则默认使用从其包中检索的应用程序图标。
Parameters |
iconResourceId |
int : An integer id for the badge icon resource. |
setColor
ContentRecommendation.Builder setColor (int color)
向用户显示此内容推荐时,设置要在用户界面中使用的重音颜色值。
Parameters |
color |
int : An integer value representing the accent color for this recommendation. |
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. |
setContentTypes
ContentRecommendation.Builder setContentTypes (String[] types)
设置与内容推荐相关的内容类型。 第一个标签条目将被视为内容的主要类型,并将用于排名目的。 如果适用的话,可以提供其他辅助类型标签,并且可以用于过滤目的。
Parameters |
types |
String : Array of predefined type tags (see the CONTENT_TYPE_* constants) that describe the recommended content. |
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. |
setGenres
ContentRecommendation.Builder setGenres (String[] genres)
设置建议的内容类型。 这些类型可用于内容排名。 流派是开放式结束字符串标记。
例如:“喜剧”,“动作”,“跳舞”,“电子乐”,“赛车”等。
Parameters |
genres |
String : Array of genre string tags that describe the recommended content. |
setGroup
ContentRecommendation.Builder setGroup (String groupTag)
设置建议的字符串组ID标记。
同一组中的建议一起按主屏幕排列,并且组内的排序顺序受到尊重。 如果应用程序有不同的推荐来源,比如YouTube的“趋势”,“订阅”和“新音乐”类别,用户可以对其中一组的推荐更感兴趣,那么这会非常有用。
Parameters |
groupTag |
String : A String containing the group ID tag for this recommendation. |
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). |
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. |
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). |
setRunningTime
ContentRecommendation.Builder setRunningTime (long length)
设置内容的运行时间(适用时)。
Parameters |
length |
long : The running time, in seconds, of the content. |
setSortKey
ContentRecommendation.Builder setSortKey (String sortKey)
设置建议的字符串排序键。
排序键必须是介于0.0和1.0之间的浮点数的字符串表示形式,用于表示指定组内的单个建议的相对重要性(和排序顺序)。 这些建议将按照给定组内的重要性降序排列。
Parameters |
sortKey |
String : A String containing the sort key for this recommendation. |
setSourceName
ContentRecommendation.Builder setSourceName (String source)
设置建议的源应用程序名称。
如果源名称从未设置,或设置为null,则默认使用从其包中检索的应用程序名称。
Parameters |
source |
String : A String containing the recommendation source name. |
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). |