default

API，用于在设备上添加和删除Recommendation2对象。

RecommendationManager2是一种本地推荐服务，用于显示和管理客户端应用提交的Recommendation2对象。

扩展

• default

构造函数

new default()

new default(): default

返回值

default

继承自

default.constructor

方法

addRecommendations()

static addRecommendations(recommendations): number[]

在此设备上添加向用户显示的新推荐。该应用对它可以同时持有的推荐数量有预定义的上限。如果超过此上限，系统将根据收到的时间戳删除较旧的项目

所需权限：“com.amazon.privilege.security.file-sharing”

参数

recommendations

Recommendation[]

返回值

number[]

继承自

default.addRecommendations

---

addRecommendations2()

static addRecommendations2(recommendations): number[]

添加要在设备上显示的新Recommendation2对象。

该应用的预定义最大同时持有的推荐限制为20个，由RecommendationManager设置。如果超出此上限，系统将根据收到的时间戳删除较旧的项目。对于使用contentImageUri的推荐，图像将异步下载。如果图像下载失败，设备上会记录一条错误消息，对应建议将被删除。

参数

recommendations

Recommendation2[]

一个数组，包含要添加的Recommendation2对象。

返回值

number[]

一个数组，包含与添加的推荐相对应的Uuid。每个Uuid对应一个推荐，将来可以用来删除推荐。

权限

"com.amazon.privilege.security.file-sharing"

抛出

如果调用应用没有所需的权限，则会抛出SecurityError。

抛出

如果出现以下任何一种情况，则会抛出InvalidArgumentError：- 推荐大小超过512KB - 必填字段为空或无效 - contentImage和contentImageUri都缺失 - 提供的contentImage字节数组不符合大小或维度要求 - 推荐数组大小大于20

---

getMajorVersion()

static getMajorVersion(): number

获取底层原生模块的主版本。这可用于进行版本检查。

返回值

number

覆盖

default.getMajorVersion

---

getMinorVersion()

static getMinorVersion(): number

获取底层原生模块的次版本。这可用于进行版本检查。

返回值

number

覆盖

default.getMinorVersion

---

getPatchVersion()

static getPatchVersion(): number

获取底层原生模块的补丁版本。这可用于进行版本检查。

返回值

number

覆盖

default.getPatchVersion

---

removeAllRecommendations()

static removeAllRecommendations(): void

删除此客户端先前发送的所有推荐。

返回值

void

继承自

default.removeAllRecommendations

---

removeRecommendations()

static removeRecommendations(ids): void

删除之前发送的推荐。此客户端存在的任何推荐ID都将被删除，任何未找到的ID都将被忽略。

参数

ids

number[]

一个数组，包含要删除的推荐ID。

返回值

void

继承自

default.removeRecommendations

---

Last updated: 2025年10月2日