GetNextPage指令 (VSK Echo Show)
当用户选择进入搜索结果的“下一页”时，或者当他们滚动到屏幕上可查看的搜索结果之外时，VideoContentProvider API会向您的Lambda发送GetNextPage指令以获取更多结果。您的响应提供了用于填充下一页的其他项目。
下图显示了此工作流程：
GetNextPage指令的表述
| 功能 | 表述示例 | 预期回应 |
|---|---|---|
| 获取下一页 需要认证 |
Next |
屏幕上会显示下一页结果。 |
| 功能 | 表述示例 | 预期回应 |
|---|---|---|
| 获取下一页 需要认证 |
prochain(e) suivant(e) next |
屏幕上会显示下一页结果。 |
| 功能 | 表述示例 | 预期回应 |
|---|---|---|
| 获取下一页 需要认证 |
prochain(e) suivant(e) next |
屏幕上会显示下一页结果。 |
| 功能 | 表述示例 | 预期回应 |
|---|---|---|
| 获取下一页 需要认证 |
nächste nächstes das nächste spring/geh vor spring/geh vorwärts vor überspring das eins weiter/vorwärts weiter spring nach vorn spring nach vorn auf [AppName]/[DeviceBrand] nächstes im [DeviceLocation] nächstes auf [DeviceLocation]? [DeviceType]/[DeviceBrand] gib mir das nächste von [AppName] nächstes auf allen [DeviceType] |
屏幕上会显示下一页结果。 |
| 功能 | 表述示例 | 预期回应 |
|---|---|---|
| 获取下一页 需要认证 |
[GroupDeviceBrand] [HomeAutomationType] पर अगला लगाओ[GroupDeviceBrand] पर अगला लगाओ[GroupDeviceBrand] वाले [HomeAutomationType] पर अगला चलाना[AppName] पर इसके बाद वाला दो[AppName] पर मुझे next वाला दे देनाnext recipe अगली recipe[DeviceLocation] पर इसके बाद वाला दो[LocationNonSpecificQuantity] अगला चलाओ अगला/next [Episode] play करो[DeviceLocation] पर DeviceBrand अगला वाला दो |
屏幕上会显示下一页结果。 |
| 功能 | 表述示例 | 预期回应 |
|---|---|---|
| 获取下一页 需要认证 |
prossima / seguente / avanti / salta / successivo |
屏幕上会显示下一页结果。 |
| 功能 | 表述示例 | 预期回应 |
|---|---|---|
| 获取下一页 需要认证 |
次 スキップ 次に行って[DeviceLocation]で次に行って[DeviceLocation]の[DeviceBrand]で次に行って[LocationNonSpecificQuantity]で次を再生[Episode]を再生して[VideoName]の[Episode]を再生[DeviceBrand]で再生 |
屏幕上会显示下一页结果。 |
| 功能 | 表述示例 | 预期回应 |
|---|---|---|
| 获取下一页 需要认证 |
próximo/próxima |
屏幕上会显示下一页结果。 |
| 功能 | 表述示例 | 预期回应 |
|---|---|---|
| 获取下一页 需要认证 |
siguiente salta muestra el siguiente siguiente en el sonos próxima en el jardín |
屏幕上会显示下一页结果。 |
处理GetNextPage指令
在收到来自您的Lambda的搜索结果（通过GetDisplayableItemsMetadataResponse）后，用户可能希望查看其他搜索结果或搜索结果的“下一页”。用户可以使用诸如“Get next page”（获取下一页）之类的简单短语对搜索结果的下一页进行分页。
这会提示Alexa发送GetNextPage指令。您对该指令的Lambda响应中应包含搜索结果的基本元数据。该响应类似于GetDisplayableItemsResponse。
Alexa收到您的GetNextPageResponse后，如果需要更多信息，Alexa将随后发出GetDisplayableItemsMetadata指令。
GetNextPage示例
以下是GetNextPage示例指令。请注意您必须发送的项目的minResultLimit和maxResultLimit。
{
"directive": {
"header": {
"correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
"messageId": "9f4803ec-4c94-4fdf-89c2-d502d5e52bb4",
"name": "GetNextPage",
"namespace": "Alexa.VideoContentProvider",
"payloadVersion": "3"
},
"endpoint": {
"cookie": {
},
"endpointId": "<目标终端的标识符>",
"scope": {
"token": "<an OAuth2 bearer token>",
"type": "BearerToken"
}
},
"payload": {
"nextToken": "fvkjbr20dvjbkwOpqStr",
"minResultLimit": 8,
"maxResultLimit": 25
}
}
}
有效负载描述
下面的表格描述了GetNextPage指令的payload。
| 字段 | 描述 | 数据类型 |
|---|---|---|
nextToken可选 |
用于获取下一组结果的令牌。提供方发送的不透明字符串，该字符串在后续搜索请求中传回。 |
字符串 |
minResultLimit必需 |
此调用中要返回的最小结果数，对于此调用已接受 要考虑使用 示例： |
整数 |
maxResultLimit必需 |
对要返回的最大结果数的限制。有关更多详细信息，请参阅 示例： |
整数 |
Lambda响应
您的Lambda响应应该是要在设备上显示的项目列表。
响应示例
以下是您的Lambda应发送的GetNextPageResponse示例。该有效负载遵循与GetDisplayableItemsMetadata相同的格式。
{
"event": {
"header": {
"correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
"messageId": "9f4803ec-4c94-4fdf-89c2-d502d5e52bb4",
"name": "GetNextPageResponse",
"namespace": "Alexa.VideoContentProvider",
"payloadVersion": "3"
},
"endpoint": {
"scope": {
"type": "BearerToken",
"token": "Alexa-access-token"
},
"endpointId": "appliance-001"
},
"payload": {
"nextToken": "qefjrfiugef74",
"mediaItems": [
{
"mediaIdentifier": {
"id": "recordingId://provider1.dvr.rp.1234-2345-63434-asdf"
}
},
{
"mediaIdentifier": {
"id": "recordingId://provider1.dvr.rp.1234-2345-63434-asdf"
}
}
]
}
}
}
有效负载描述
| 字段 | 描述 | 数据类型 |
|---|---|---|
nextToken可选 |
用于获取下一组结果的令牌。提供方发送的不透明字符串，该字符串在后续搜索请求中传回。 |
字符串 |
mediaItems必需 |
屏幕上显示为搜索结果的视频的 |
列表 |
mediaIdentifier必需 |
|
对象 |
id必需 |
视频项目的标识符，用于在后续调用 |
字符串 |
