電視上網(wǎng)媒體信息接口說明.doc

電視上網(wǎng)平臺媒體信息接口說明電視上網(wǎng)平臺媒體信息接口V0.12007年3月目錄1、 接口描述32、 獲取區(qū)域信息43、 獲取頻道信息接口53.1 基本數(shù)據(jù)53.2 獲取頻道個(gè)數(shù)53.3 獲取頻道信息64、 影片信息84.1 基本數(shù)據(jù)84.1.1 媒體基本信息84.1.2 媒體詳細(xì)信息84.1.3 劇集基本信息104.1.4 劇集詳細(xì)信息114.2 獲取影片信息124.2.1 獲取影片數(shù)量124.2.2 分頁獲取影片信息134.2.3 查詢影片信息144.2.4 獲取影片詳細(xì)信息144.3 獲取劇集信息154.3.1 獲取劇集數(shù)量154.3.2 分頁獲取文件信息164.3.3 獲取文件詳細(xì)信息174.4 播放接口171、 概述本文檔對電視上網(wǎng)平臺的媒體信息接口進(jìn)行了描述，各個(gè)EPG可以通過該接口獲得媒體信息數(shù)據(jù)，同時(shí)第三方同電視上網(wǎng)系統(tǒng)需要對接的平臺也建議采用此接口。2、 接口描述接口采用SOAP協(xié)議3、 獲取區(qū)域信息4、 獲取頻道信息接口 強(qiáng)終端，弱終端 得到所有頻道信息，頻道包括基本頻道和專題頻道，如果是專題頻道4.1 基本數(shù)據(jù)頻道信息元數(shù)據(jù)字段名稱名稱類型長度（字節(jié)）是否必選ChannelType頻道類型 1 基本頻道 2 專題頻道 3 其他頻道Int4必選ChannelId頻道標(biāo)識Int4必選ChannelCode頻道編碼String32可選ChannelName頻道名稱string32必選ChannelDescription頻道描述string256可選ParentChannelId父頻道代碼string20可選SubChannels子頻道信息ChannelInfo4.2 獲取頻道個(gè)數(shù)GetChannelCount名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域int4MTMType終端類型,1 強(qiáng)終端2 弱終端 Int4MChannelType頻道類型 0 所有頻道 1 基本頻道 2 專題頻道 3 其他頻道Int4MParentChannel上級頻道，0 根頻道 -1所有頻道 其他值返回該頻道下的子頻道Int4MGetChannelCountResult名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ReturnCode返回值 int4MCodeDescription 返回值描述值string64O ChannelCount 頻道數(shù)量Int4M4.3 獲取頻道信息GetChannelList名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域Int4MTMType終端類型1 強(qiáng)終端2 弱終端 Int4MChannelType頻道類型 0 所有頻道 1 基本頻道 2 專題頻道 3 其他頻道Int4MParentChannel上級頻道，0 根頻道 -1所有頻道 其他值返回該頻道下的子頻道Int4MPageIndex頁號，從1開始Int4MPageSize每頁大小,如果為-1 那么返回所有的Int4MGetChannelListResult名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ReturnCode返回值Int 4OCodeDescription返回值描述string64MChannels頻道信息ChannelInfo5、 影片信息5.1 基本數(shù)據(jù)5.1.1 媒體基本信息MediaInfo影片基本信息字段名稱名稱類型長度（字節(jié)）是否必選SPCodeSP編碼String 32必選SPNameSP名稱string64必選ChannelCode頻道編碼String32必選ChannelName頻道名稱String64必選MediaId媒體標(biāo)識Int4必選MediaName媒體名稱string64必選EpisodeNum集數(shù)，僅對連續(xù)劇有效Int4必選Summary內(nèi)容簡介String256可選Description內(nèi)容介紹string1024可選Star星級int1可選Poster海報(bào)圖片的URLstring256可選Encoder編碼方式int4可選Bitrate比特率int8可選Caption字幕語言string256可選ClickCount點(diǎn)擊次數(shù)Int 4可選LastVisitTime最近一次訪問時(shí)間String14可選5.1.2 媒體詳細(xì)信息MediaDetailInfo影片內(nèi)容詳細(xì)信息字段名稱名稱類型長度（字節(jié)）是否必選SPCodeSP編碼String32必選SPNameSP名稱string64必選ChannelCode頻道編碼String32必選ChannelName頻道名稱string32可選MediaId媒體標(biāo)識Int4必選MediaName媒體名稱string64必選Summary內(nèi)容簡介String256可選Description內(nèi)容介紹string1024可選Star星級int1可選Poster海報(bào)圖片的URLstring256可選Encoder編碼方式String32可選Bitrate比特率int8可選EpisodeNum集數(shù)，僅對連續(xù)劇有效Int4可選Caption字幕語言string256可選Country內(nèi)容所屬國家string32可選Area內(nèi)容所屬地區(qū)string32可選LanguageName語言名稱String32可選AudioType音頻類型string32可選Length長度int8必選Director導(dǎo)演string64可選Actor演員string256可選EnglishName英文名string256可選Producer出品方string256可選PlayWriter作者string64可選ProductCompany制作公司string64可選PublishCompany發(fā)行公司string64可選Rating級別分類int4可選Awards獎(jiǎng)項(xiàng)string256可選ProductTime發(fā)行時(shí)間string14可選ScreenFormat屏幕類型string16可選SearchKey搜索關(guān)鍵字string32可選ScreenRate分辯率string64可選PublishTime發(fā)布時(shí)間20061012120030String 14可選ClickCount點(diǎn)擊次數(shù)Int 4可選LastVisitTime最近一次訪問時(shí)間String14可選5.1.3 劇集基本信息EpisodeInfo劇集基本信息字段名稱名稱類型長度（字節(jié)）是否必選MediaId媒體標(biāo)識string32必選MediaName媒體名稱string64必選EpisodeId劇集標(biāo)識Int4必選EpisodeIndex集號，僅對連續(xù)劇有效Int4必選EpisodeName劇集名稱String64 可選Summary內(nèi)容簡介String256可選Description內(nèi)容介紹string1024可選Poster海報(bào)圖片的URLstring256可選ClickCount點(diǎn)擊次數(shù)Int 4可選LastVisitTime最近一次訪問時(shí)間String14可選5.1.4 劇集詳細(xì)信息EpisodeDetailInfo劇集內(nèi)容詳細(xì)信息字段名稱名稱類型長度（字節(jié)）是否必選MediaId媒體標(biāo)識Int4必選MediaName媒體名稱string64必選EpisodeId集標(biāo)識Int8必選EpisodeIndex集號Int8必選EpisodeName集名稱String 64必選Country內(nèi)容所屬國家string32可選Area內(nèi)容所屬地區(qū)string32可選Summary內(nèi)容簡介String256可選Description內(nèi)容介紹string1024可選LanguageName語言名稱String32可選AudioType音頻類型String32可選Star星級int1可選Poster海報(bào)圖片的URLstring256可選Encoder編碼方式String32可選Bitrate比特率Int8可選Length長度Int8必選Director導(dǎo)演String64可選Actor演員String256可選EnglishName英文名String256可選Producer出品方String256可選PlayWriter作者string64可選ProductCompany制作公司string64可選PublishCompany發(fā)行公司string64可選Rating級別分類int4可選Caption字幕語言string256可選Awards獎(jiǎng)項(xiàng)string256可選ProductTime發(fā)行時(shí)間string14可選ScreenFormat屏幕類型string16可選SearchKey搜索關(guān)鍵字string32可選ScreenRate分辯率string64可選ClickCount點(diǎn)擊次數(shù)Int 4可選LastVisitTime最近一次訪問時(shí)間String14可選5.1.5 評論詳細(xì)信息CommentDetailInfo名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選MediaId影片標(biāo)識 Int4MMediaName影片名String64MEpisodeIndex劇集序號Int4OEpisodeId 劇集標(biāo)識String64OEpisodeName劇集名string64OCommentTitle標(biāo)題String256OCommentDetail詳細(xì)信息string1024OCommentUser發(fā)表評論人String64OCommentTime發(fā)表評論時(shí)間string14O5.1.6 服務(wù)詳細(xì)信息ServiceDetailInfo名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選MediaId影片標(biāo)識 Int4MMediaName影片名String64MEpisodeIndex劇集序號Int4OEpisodeId 劇集標(biāo)識String64OEpisodeName劇集名string64OServiceId服務(wù)標(biāo)識String32MServiceCode服務(wù)編號String64MServiceName服務(wù)名稱String64MServiceDesc服務(wù)描述string1024OServiceFee服務(wù)費(fèi)用String64M5.2 獲取影片信息5.2.1 獲取影片數(shù)量GetMediaCount名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域Int4MTMType終端類型1 強(qiáng)終端2 弱終端 Int4M ChannelCode頻道編碼String32MConditions查詢條件，SQL語法，具體字段名稱參見MediaDetailInfo所有字段用#字段名#例如 #MediaName# =測試影片 AND #Star#=5 String256OGetMediaCountResult名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ReturnCode返回值 Int4MCodeDescription 返回值描述值string64O MediaCount 數(shù)量Int4M5.2.2 分頁獲取影片信息GetMediaList名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域Int4MTMType終端類型1 強(qiáng)終端2 弱終端 int4M ChannelCode頻道編碼String32O PageIndex頁號Int4MPageSize頁大小int4MConditions查詢條件，類SQL語法，具體字段名稱參見MediaDetailInfo所有字段用#字段名#例如 #MediaName# =測試影片 AND #Star#=5 String256OOrderInfo排序信息String 256OGetMediaListResult名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ReturnCode返回值 int4OCodeDescription 返回值描述值string64M MediaInfos MediaInfo5.2.3 獲取影片詳細(xì)信息GetMediaDetailInfo名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域Int4MMediaId返回值 string36MGetMediaDetailInfoResult名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ReturnCode返回值 int4MCodeDescription 返回值描述值string64O DetailInfo 媒體信息MediaDetailInfo5.3 查詢影片5.3.1 獲取數(shù)量GetSearchMediaCount名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域Int4MTMType終端類型1 強(qiáng)終端2 弱終端 int4M ChannelCode頻道編碼String32OSearchMode1按節(jié)目名稱拼音首字母搜索，2按節(jié)目名稱字?jǐn)?shù)搜索，3按節(jié)目名稱首字筆畫數(shù)搜索4按導(dǎo)演拼音首字母搜索，5按導(dǎo)演字?jǐn)?shù)搜索，6按導(dǎo)演首字筆畫數(shù)搜索7按主演拼音首字母搜索，8按主演字?jǐn)?shù)搜索，9按主演首字筆畫數(shù)搜索Int4MSearchValue查詢值String256MConditions查詢條件，類SQL語法，具體字段名稱參見MediaDetailInfo所有字段用#字段名#例如 #MediaName# =測試影片 AND #Star#=5 String256OGetSearchMediaCountResult名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ReturnCode返回值 Int4MCodeDescription 返回值描述值string64O MediaCount 數(shù)量Int 4M5.3.2 分頁查詢除了上面分頁獲取影片信息外，還可以通過特點(diǎn)算法查詢影片GetSearchMediaList名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域Int4MTMType終端類型1 強(qiáng)終端2 弱終端 int4M ChannelCode頻道編碼String32O PageIndex頁號Int4MPageSize頁大小int4MSearchMode1按節(jié)目名稱拼音首字母搜索，2按節(jié)目名稱字?jǐn)?shù)搜索，3按節(jié)目名稱首字筆畫數(shù)搜索4按導(dǎo)演拼音首字母搜索，5按導(dǎo)演字?jǐn)?shù)搜索，6按導(dǎo)演首字筆畫數(shù)搜索7按主演拼音首字母搜索，8按主演字?jǐn)?shù)搜索，9按主演首字筆畫數(shù)搜索Int4MSearchValue查詢值String256MConditions查詢條件，類SQL語法，具體字段名稱參見MediaDetailInfo所有字段用#字段名#例如 #MediaName# =測試影片 AND #Star#=5 String256OOrderInfo排序信息String 256OGetSearchMediaListResult名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ReturnCode返回值 int4OCodeDescription 返回值描述值string64M MediaInfos MediaInfo5.4 獲取推薦影片信息5.4.1 獲取推薦影片數(shù)量GetRecommendMediaCount名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域Int4MTMType終端類型1 強(qiáng)終端2 弱終端 Int4MChannelCode頻道編碼String32MConditions查詢條件，SQL語法，具體字段名稱參見MediaDetailInfo和RecommendSequence 序號所有字段用#字段名#例如 #MediaName# =測試影片 AND #Star#=5 String256OGetRecommendMediaCountResult名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ReturnCode返回值 Int4MCodeDescription 返回值描述值string64O MediaCount 數(shù)量Int4M5.4.2 分頁獲取推薦影片信息GetRecommendMediaList名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域Int4MTMType終端類型1 強(qiáng)終端2 弱終端 int4MChannelCode頻道編碼String 32M PageIndex頁號Int4MPageSize頁大小int4MConditions查詢條件，類SQL語法，具體字段名稱參見MediaDetailInfo所有字段用#字段名#例如 #MediaName# =測試影片 AND #Star#=5 String256OOrderInfo排序信息String 256OGetRecommendMediaListResult名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ReturnCode返回值 Int4MCodeDescription 返回值描述值string64O MediaInfos MediaInfoO5.5 獲取劇集信息5.5.1 獲取劇集數(shù)量GetEpisodeCount名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域Int 4M MediaId媒體標(biāo)識Int4MConditions查詢條件，SQL語法，具體字段名稱參見MediaEpisodeDetailInfo所有字段用#字段名#例如 #EpisodeName# =測試影片 AND #EpisodeIndex#=5 String256OGetEpisodeCountResult名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ReturnCode返回值 Int4MCodeDescription 返回值描述值string64OEpisodeCount 數(shù)量Int4M5.5.2 分頁獲取劇集信息GetEpisodeList名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域Int4M MediaId影片標(biāo)識Int4M PageIndex頁號Int4OPageSize頁大小Int4OConditions查詢條件，類SQL語法，具體字段名稱參見EpisodeDetailInfo所有字段用#字段名#例如 #EpisodeName# =測試影片 AND #EpisodeIndex#=5 String256OOrderInfo排序信息，類SQL語法具體字段名稱參見EpisodeDetailInfo所有字段用#字段名#,例如 #EpisodeIndex# ASC,#PublishTime# DESCString 256OGetEpisodeListResult名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ReturnCode返回值 Int4MCodeDescription 返回值描述值string64O EpisodeInfos 影片劇集信息EpisodeInfoO5.5.3 獲取劇集詳細(xì)信息GetEpisodeDetailInfo名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域Int4MMediaId媒體標(biāo)識Int4MEpisodeId集標(biāo)識Int4OGetEpisodeDetailInfoResult名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ReturnCode返回值 Int4MCodeDescription 返回值描述值string64O DetailInfo 媒體信息EpisodeDetailInfo5.6 獲取評論信息5.6.1 獲取評論數(shù)量GetCommentCount名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域Int 4M MediaId媒體標(biāo)識Int4MEpisodeId劇集標(biāo)識Int4MConditions查詢條件，SQL語法，具體字段名稱參見CommentDetailInfo所有字段用#字段名#String256OGetCommentCountResult名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ReturnCode返回值 Int4MCodeDescription 返回值描述值string64OCommentCount 數(shù)量Int4M5.6.2 分頁獲取評論信息GetCommentList名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域Int4M MediaId影片標(biāo)識Int4MEpisodeId劇集標(biāo)識，0 表示該評論針對本影片，對連續(xù)劇，可以對單劇集進(jìn)行評論Int4O PageIndex頁號Int4OPageSize頁大小Int4OConditions查詢條件，類SQL語法，具體字段名稱參見CommentDetailInfo所有字段用#字段名#String256OOrderInfo排序信息，類SQL語法具體字段名稱參見CommentDetailInfoString 256OGetCommentListResult名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選ReturnCode返回值 Int4MCodeDescription 返回值描述值string64O Comments 評論信息CommentDetailInfoO5.7 獲取收費(fèi)服務(wù)信息5.7.1 獲取服務(wù)數(shù)量GetServiceCount名稱說明數(shù)據(jù)類型長度（字節(jié)）是否必選Region區(qū)域0 代表平臺內(nèi)容 -1 代表所有區(qū)域Int 4M MediaId媒體標(biāo)識Int4MEpisodeId劇集Int4 OConditi