内容模块
当前专辑相关性推荐接口
a. 根据主播推荐
val albumId = "6233693"
val slot = Slots.GetAlbumListByAnnouncer(albumId)
if (clear) {
slot.offset = 0
} else {
slot.offset = dataSize
}
XYMobileSdk.getContentSdk().getAlbumListByAnnouncer(Slots.GetAlbumListByAnnouncer slot, JsonXYCallback<XYAlbumList> callback);
b. 根据内容推荐
val albumId = "6233693"
val slot = Slots.GetRelativeAlbumList(albumId)
if (clear) {
slot.offset = 0
} else {
slot.offset = dataSize
}
XYMobileSdk.getContentSdk().getRelativeAlbumList(Slots.GetRelativeAlbumList slot, JsonXYCallback<XYAlbumList> callback);
信息流接口
val slot = if (clear) {
Slots.QueryHistory(0, 0)
} else {
Slots.QueryHistory(offest = dataSize, timeLine)
}
XYMobileSdk.getContentSdk().getQueryHistoryList(Slots.QueryHistory slot, JsonXYCallback<XYSpeakerHistory> callback);
XYSpeakerHistory
{
"pageInfo": {
"hasMore": true,
"count": 10,
"timeline": 1564559741
},
"list": [{
"request": {
"feedback": "",
"domain": "fm",
"speechUrl": "https://xyxk-shasr-1256573505.cos.ap-shanghai.myqcloud.com/20190731/a4348382a27f0d72581a44f3b2d667bc?response-content-type=application%2Foctet-stream&sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKID0KLBxlWwPkzkKugldP1XeaL3zIVYoyJT%26q-sign-time%3D1564559681%3B1565164541%26q-key-time%3D1564559681%3B1565164541%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3D4f8fc648fc686e4ccf02bb858453d612f2236fce",
"text": "我要听郭德纲的相声",
"intent": "play_fm"
},
"historyId": 37751,
"response": {
"feedback": "",
"card": {
"text": "好的,为您播放,郭德纲21年相声精选,《人在江湖》郭德纲 于谦"
}
},
"createTs": 1564555776,
"sid": "a4348382a27f0d72581a44f3b2d667bc"
}, {
"request": {
"feedback": "",
"domain": "music",
"speechUrl": "https://xyxk-shasr-1256573505.cos.ap-shanghai.myqcloud.com/20190731/7f89f5485183cdd50d0290f17cb4c1f7?response-content-type=application%2Foctet-stream&sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKID0KLBxlWwPkzkKugldP1XeaL3zIVYoyJT%26q-sign-time%3D1564559681%3B1565164541%26q-key-time%3D1564559681%3B1565164541%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3D1ce2f5133dfaadd6b9f84622be63d0dfc457af03",
"text": "我要听周杰伦的歌",
"intent": "search_music"
},
"historyId": 37736,
"response": {
"feedback": "",
"card": {
"text": "没有找到这个内容,换一个试试吧!"
}
},
"createTs": 1564555600,
"sid": "7f89f5485183cdd50d0290f17cb4c1f7"
}, {
"request": {
"feedback": "",
"domain": "general_command",
"speechUrl": "https://xyxk-shasr-1256573505.cos.ap-shanghai.myqcloud.com/20190731/3ee99c89c9287ded6776a71fade5c562?response-content-type=application%2Foctet-stream&sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKID0KLBxlWwPkzkKugldP1XeaL3zIVYoyJT%26q-sign-time%3D1564559681%3B1565164541%26q-key-time%3D1564559681%3B1565164541%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3D30e211eccaf18e684d039951647f74942f003a7f",
"text": "",
"intent": "next"
},
"historyId": 37732,
"response": {
"feedback": "",
"card": {
"text": "好的,Lenka,Trouble is a Friend"
}
},
"createTs": 1564555583,
"sid": "3ee99c89c9287ded6776a71fade5c562"
}, ...]
}
获取推荐专辑列表
传参: "slots":{"offset":0,"limit":20}
参数 | 类型 | 是否必要 | |
---|---|---|---|
slots.offset | Integer | 否 | 首条记录的索引位置,默认为0 |
slots.limit | Integer | 否 | 返回结果中的最大条目数量,默认为5,最大不超过50 |
调用:
XYMobileSdk.getContentSdk().getRecommendAlbumList(Slots.RecommendAlbumList slot, JsonXYCallback<XYAlbumList> callback);
返回:
XYAlbumList;
搜索专辑列表
传参: "slots":{"keyword":"郭德纲","offset":0,"limit":20}
参数 | 类型 | 是否必要 | |
---|---|---|---|
slots.offset | Integer | 否 | 首条记录的索引位置,默认为0 |
slots.limit | Integer | 否 | 返回结果中的最大条目数量,默认为5,最大不超过50 |
slots.keyword | String | 是 | 需要搜索的关键词 |
调用:
XYMobileSdk.getContentSdk().searchAlbumList(Slots.SearchAlbumList slot, JsonXYCallback<XYAlbumList> callback);
返回:
response.data中包含page对象,对象中Items数组元素为Album类型的对象;
当前专辑相关性推荐接口
传参:"slots":{"albumId":"123","offset":0,"limit":20}
参数 | 类型 | 是否必要 | |
---|---|---|---|
slots.offset | Integer | 否 | 首条记录的索引位置,默认为0 |
slots.limit | Integer | 否 | 返回结果中的最大条目数量,默认为5,最大不超过50 |
slots.albumId | Integer | 是 | 专辑id |
调用:
XYMobileSdk.getContentSdk().getRelativeAlbumList(Slots.GetRelativeAlbumList slot, JsonXYCallback<XYAlbumList> callback);
返回:
对象中Items数组元素为Album类型的对象;
内容运营页
首页楼层接口
传参:
参数 | 类型 | 是否必要 | |
---|---|---|---|
slots.sdk_version | String | 是 | SDK版本信息 |
slots.product_id | String | 是 | ProductID |
接口调用:
XYMobileSdk.getContentSdk().getFloorHomePageData(slot, object : JsonXYCallback<List<XYFloorItem>>() {}
接口返回:
XYFloorItem形式的数组;
楼层推荐更多接口
传参:
参数 | 类型 | 是否必要 | |
---|---|---|---|
slots.limit | String | 是 | SDK版本信息 |
slots.offset | String | 是 | ProductID |
slots.floor_id | String | 否 | 楼层ID |
接口调用:
XYMobileSdk.getContentSdk().getFloorRecommendList(slot, object : JsonXYCallback<XYList<XYAlbum>>() {}
返回数据:
XYAlbum形式数组;
专辑详情接口
传参:
参数 | 类型 | 是否必要 | |
---|---|---|---|
slots.album_id | String | 是 | albumID |
slots.product_id | String | 是 | ProductID |
调用:
XYMobileSdk.getContentSdk().getAlbumDetail(slot, object : JsonXYCallback<XYAlbum>() {}
接口返回数据:
XYAlbum数据;
获取声音接口
传参:
参数 | 类型 | 是否必要 | |
---|---|---|---|
slots.album_id | String | 是 | albumID |
slots.limit | int | 否 | 返回结果中的最大条目数量,默认为5,最大不超过50 |
slots.offset | int | 否 | 首条记录的索引位置,默认为0 |
slots.sort | String | 是 | asc: 喜马拉雅正序,desc: 喜马拉雅逆序,默认为 asc |
调用接口:
XYMobileSdk.getContentSdk().getTracks(slot, object : JsonXYCallback<XYList<XYTrack>>() {}
搜索的热词接口
传参:无需传参
调用接口:
XYMobileSdk.getContentSdk().getHotWords(slot, object : JsonXYCallback<XYSearchHotWords>() {}
接口返回数据:
hotword:返回字符串数组
placeholder:默认搜索词