Recommendation

Recommendation: object

在设备主屏幕上向用户显示的推荐。可以是以下两种类型中的一种

• 支持内容图像字节数组的Recommendation类型对象
• 支持内容图像URI的Recommendation2类型对象。请确保向用户显示的字符串简洁且采用UTF-8格式进行编码，因为短字符串可以在用户界面上完全显示，并且Omnikit仅支持UTF-8编码。每个recommendation对象的大小限制为512KB（不包括contentImage）。

类型声明

backgroundImageUri

backgroundImageUri: URL

将用于检索推荐的背景图像的URI

category

category: Category

推荐应归入的类别。此项是必填字段。

contentImage

contentImage: number[]

根据此推荐显示的图像 (PNG)，不显示没有图像或规格不正确的推荐。此项是必填字段。

请按以下规格处理图像： 宽高比： 16:9。频道： 3 (BGR)，8位/频道。方向： 横向。格式： PNG。根据显示屏的不同，图像分辨率应为： HDTV (720p)： 256 _ 144。HDTV (1080p)： 384 _ 216 4K UHD： 768 * 432。标题： 嵌入在图像中。透明度： 不透明

contentUri

contentUri: URL

当用户点击推荐时将启动的URI

customerAggregateRating

customerAggregateRating: number

客户汇总评分，可能的值范围介于0到10之间。

customerRatingCount

customerRatingCount: number

对此内容进行评分的客户数量。

displayActionOption

displayActionOption: DisplayAction

确定为每个推荐显示的第一上下文菜单选项。此项是必填字段。

displayName

displayName: string

Launch（启动）菜单中显示的较短应用名称（在选择推荐时按菜单按钮会显示该名称）。

isCaptionAvailable

isCaptionAvailable: boolean

内容的字幕可用性。false： 内容没有字幕可用（默认）true： 内容有字幕可用

maturityRating

maturityRating: string

在标题下方显示评级。目前，支持的值如下所示。 美国市场： G、PG、PG13、R、NC17、NR、TVY、TVY7、TVG、TVPG、TV14、TVMA。德国市场： FSK0、FSK6、FSK12、FSK16、FSK18。英国市场： BBFCPG、BBFC12、BBFC18、BBFCU。日本市场： EIRIN_G、EIRIN_PG12、EIRIN_R15、EIRIN_18。印度市场： ALL、7+、13+、16+、18+、NR

此项是必填字段。

releaseYear

releaseYear: number

内容发布年份。示例： 2016、2015

runningTime

runningTime: number

如果适用，则为内容的运行时间（以分钟为单位）。

text

text: string

推荐的描述文本。

title

title: string

推荐的内容标题。

---

Last updated: 2025年10月2日