Spotify是全球最大的正版流媒體音樂服務平臺之一病游,有非常豐富的流媒體庫唇跨,最主要的是還提供了非常豐富的API、SDK供個人或企業(yè)調用衬衬,以便獲取最新最全的音樂买猖,而且是不收費的,但你的用戶如果想聽可就要付費了滋尉,所以說“天下沒有免費的午餐”啊玉控。
注意:Spotify在中國區(qū)還沒有提供服務,訪問官網會有提示狮惜,但訪問開發(fā)者中心暢通無阻(https://developer.spotify.com/)
進入正題高诺,Spotify如何為我所用呢碌识?下面以iOS接入為例一步步展開【業(yè)務很簡單:在APP海外版中搜索歌曲并播放】
1、讓我們先看看其強大的開發(fā)者中心吧:
2虱而、申請spotify筏餐,需要VPN,因為spotify在大陸還沒有業(yè)務薛窥。
3胖烛、進入開發(fā)者中心(https://developer.spotify.com/),創(chuàng)建自己的APP诅迷,里面的Redirect URIs佩番、Bundle IDs、Android Packages可以在后續(xù)用到的時候隨時添加上罢杉,這樣我們就拿到了Client ID和Client Secret趟畏。
4、無論是iOS還是Android平臺的sdk滩租,想要播放完整的歌曲都需要付費spotify會員權限赋秀,所以我們還需要辦理付費會員,官方有3種付費渠道律想,但我嘗試的時候都不行猎莲,必須海外的信用卡等等,所以干脆直接去淘寶技即,淘寶有專門辦理spotify付費的著洼,99元人民幣三個月。
5而叼、下載iOS版本SDK身笤,里面Demo的代碼比較完整,只需要更換一下Client ID就可以使用了葵陵,看看里面Config.h中的幾個重要參數(shù):
kClientId:自己 App的client ID
kCallbackURL:Auth2.0授權的回調地址
kTokenSwapServiceURL:用來新的獲取token液荸,需要自己開發(fā)服務
kTokenRefreshServiceURL:用來refresh token,以便實現(xiàn)權限自動續(xù)期脱篙,需要自己開發(fā)服務
kSessionUserDefaultsKey:默認不變
kTokenSwapServiceURL和kTokenRefreshServiceURL后面會說明娇钱,以及兩個服務如何實現(xiàn)。
6绊困、如何實現(xiàn)搜索忍弛?有兩個選擇,一種web api方式考抄,一種集成sdk,APP內部實現(xiàn)蔗彤,但我們發(fā)現(xiàn)Android版的SDK中沒有提供seach的接口川梅,只是iOS版的SDK實現(xiàn)了疯兼,所以最終決定選擇web api形式實現(xiàn)搜索,供兩個平臺調用贫途。
? ? ? 下載web api的Demo地址:https://developer.spotify.com/web-api/code-examples/
Demo做的非常完善吧彪,測試單元也都有,核心功能實現(xiàn)都已經給出來了丢早,我們只需要找到要用的那部分代碼姨裸。
搜索部分共有4種類型:歌曲,歌手怨酝,歌單傀缩,專輯
搜索歌曲代碼:
搜索歌手代碼:
搜索歌手的top歌曲:
還有搜索歌單,專輯部分农猬,這兒就不繼續(xù)延展了赡艰,有需要的直接看Demo,都能找到你想要的斤葱。
有了主要功能函數(shù)慷垮,剩下的就是包裝成rest服務了,不再贅述揍堕。
需要注意的地方是料身,spotify搜索接口返回的并不是歌曲的音源地址,而是一個id衩茸,比如“spotify:track:3Dupb5AcaVFErlSSfl3szW”芹血,iOS&Android的SDK已經提供了播放接口,接口參數(shù)就是id递瑰,同時接口還會返回preview_url祟牲,這個是只有30s的音源地址,可以隨便播放抖部。更為詳細的格式查詢API Console(https://developer.spotify.com/web-api/console/)说贝。
7、歌曲數(shù)據(jù)有了慎颗,試試APP端怎么播放吧乡恕。
播放類:SPTAudioStreamingController
到這兒你應該能夠聽到來自spotify的歌曲了。
8俯萎、關于授權
? ? Spotify走的也是OAuth2.0協(xié)議傲宜,即Web Server Flow。
了解詳細:http://developer.baidu.com/wiki/index.php?title=docs/oauth/authorization
Spotify每次授權之后token有效期3600s夫啊,過期以后還需要用戶輸入用戶名密碼登錄授權函卒,比較麻煩,很是影響用戶體驗撇眯,有沒有辦法解決這個問題报嵌?查詢發(fā)現(xiàn)虱咧,OAutch2.0確實是支持自動續(xù)期權限的,這個太好了锚国,下一步就看在APP中如何實現(xiàn)了腕巡。
iOS版SDK正好也有這方面的兼容,不過需要設置兩個回調服務血筑,即開始提到的kTokenSwapServiceURL和kTokenRefreshServiceURL绘沉。
官方文檔中并沒有提到這兩個服務實現(xiàn)的細節(jié),但通過搜索也能查到一些蛛絲馬跡豺总。
?????? 8.1车伞、啟動iOS Demo,登錄以后APP會調用kTokenSwapServiceURL服務园欣,帶的參數(shù)是code帖世,拿到code以后實現(xiàn):
??? 返回的數(shù)據(jù)格式需要時標準的json。
??? 8.2沸枯、過期以后重新refresh token
? ? ? SDK檢查當前token是否可用日矫,不可用會調用kTokenRefreshServiceURL
服務,上行的參數(shù)是refresh_token绑榴,拿到refresh_token以后實現(xiàn):
????? 返回的數(shù)據(jù)格式需要時標準的json哪轿。
總結:以上就是所有部分了,總起來說比較簡單翔怎,因為官方給的api已經足夠清晰了窃诉,只是在授權地方可能會有些迷惑的地方,再有任何問題可以在后面追加評論赤套,O(∩_∩)O謝謝飘痛。