1 Youtube API能干什么
2 Youtube API
2.0 Youtube简介
2.1 如何使用Youtube API
2.3 如何播放检索到的video
3 Sample实现
1 Youtube API能干什么
服务网站:http://www.youtube.com/
l Youtube API支持搜索用户信息和video信息, 支持多种搜索适用。
l 能很方便的在APP中播放检索到的短片; 只能在播放前设置播放窗口的大小, 但不能实现各种播放模式。
l 提供sample。
相关资源:
http://www.youtube.com/dev Youtube 开发
http://www.youtube.com/dev_docs Youtube API 文档
http://www.youtube.com/dev_intro 使用Youtube API起点
2 Youtube API
2.0 Youtube简介
YouTube是一个因特网网站,让使用者上载观看及分享短片。它是一个可供网民上载观看及分享短片的网站,至今已成为同类型网站的翘楚,并造就多位网上名人和激发网上创作。
2.1 如何使用Youtube API
使用Youtube API首先要申请一个开发者ID(该ID会作为API参数)。API的调用是一个http请求,返回的是一个xml结果集。
2.1.1
获取Youtube 的开发者ID
首先需要申请一个Youtube 帐户, 然后设置developer profile, 设置成功后会产生developer ID。 我申请到的ID是:Gy-vvp-8HnE, 如下:
Developer ID:
|
Gy-vvp-8HnE
|
Purpose for Using APIs:
|
|
Site Name:
|
|
Site URL: |
|
Secret: |
|
Platform(s): |
C# |
2.1.2
Youtube API使用
Youtube API功能如下表:
User Information
|
Video Viewing
|
· youtube.users.list_favorite_videos
· youtube.users.list_friends (with paging)
|
· youtube.videos.list_by_tag (with paging)
· youtube.videos.list_by_user (with paging)
· youtube.videos.list_featured
· youtube.videos.list_by_related (with paging)
· youtube.videos.list_by_playlist (with paging)
· youtube.videos.list_by_category_and_tag (with paging)
|
由于这些API使用类似,这里举两个例子,详细使用见:http://www.youtube.com/dev_docs。
youtube.users.list_favorite_videos函数说明
描述:通过输入用户名(Yubube的注册用户名),检索出该用户的喜爱的video
参数:
User:Yubube的注册用户名
调用举例:
返回结果中共显示了10条机记录:这里只列举出一条信息。
<?xml version="1.0" encoding="utf-8"?>
<ut_response status="ok">
<video_list>
<total>10</total>
<video>
<author>j1j8</author>
<id>_pbHmupg
<title>Free Hugs Campaign Aberdeen</title>
<length_seconds>220</length_seconds>
<rating_avg>4.71</rating_avg>
<rating_count>14</rating_count>
<description>http://FreeHugsScotland.bebo.com Give a FREE HUG!!!! thats all i can say!!! If you spotted me please post it as a video response!</description>
<view_count>410</view_count>
<upload_time>1173659764</upload_time>
<comment_count>60</comment_count>
<tags>Aberdeen Aberdeenshire free hugs hug guy peace smile happy love John gives city sign hugging sharing friendship human</tags>
<url>http://www.youtube.com/?v=_pbHmupg
<thumbnail_url>http://sjl-static2.sjl.youtube.com/vi/_pbHmupg
</video>
<video>
...
</video>
...
</video_list>
</ut_response>
|
youtube.videos.list_by_tag (with paging) 函数说明
描述:通过输入的tag, 检索出所有的video;
参数:
l Method:youtube.videos.list_by_tag
l Dev_id:申请的developer ID,即Gy-vvp-8HnE
l Tag:检索的关键字
l Page:如果按页显示,取第几页数据。 可选项参数
l Per_page:一页显示记录的条数。 可选项参数
调用举例:
返回结果:显示了3条记录(2、3条记录略),其中粗体的信息是比较重要的。
<?xml version="1.0" encoding="utf-8" ?>
<ut_response status="ok">
<video_list>
<total>100347</total>
<video>
<author>MollywoodTO</author>
<id>b06exGCPThQ</id>
<title>THE GAYEST SPORT ON EARTH</title>
<length_seconds>467</length_seconds>
<rating_avg>4.25</rating_avg>
<rating_count>105</rating_count>
<description>Spandex Alert-The gayest sport on earth Hard-bodied men strut their stuff but in an oh, so gay, way. (and I mean that in a good way! lol)</description>
<view_count>122009</view_count>
<upload_time>1168200369</upload_time>
<comment_count>None</comment_count>
<tags>sport men sexy spandex athletic competition mollywoodto</tags>
<url>http://www.youtube.com/?v=b06exGCPThQ</url>
<thumbnail_url>http://sjc-static5.sjc.youtube.com/vi/b06exGCPThQ/2.jpg</thumbnail_url>
</video>
<video>
…
</video>
<video>
…
</video>
</video_list>
</ut_response>
|
youtube.videos.get_details 函数说明
描述:获取video的详细信息;
参数:
l Method:youtube.videos.get_details
l Dev_ID:申请的developer ID,即Gy-vvp-8HnE
l Video_ID:Video的ID,在前一个检索结果中有, 即 b06exGCPThQ。
调用举例:
返回结果:
<?xml version="1.0" encoding="utf-8"?>
<ut_response status="ok">
<video_details>
<author>Sander79</author>
<title>Lost & Found</title>
<rating_avg>4.56</rating_avg>
<rating_count>110</rating_count>
<tags>stopmotion stop-motion stop motion animation clay claymation</tags>
<description>Some stopmotion animations I lost over the years. I'm glad that I one day made a copy. Finding the copy was a lot more difficult : ) Enjoy!</description>
<update_time>1173398174</update_time>
<view_count>16501</view_count>
<comment_count>47</comment_count>
<upload_time>1155415077</upload_time>
<length_seconds>222</length_seconds>
<recording_date />
<recording_location />
<recording_country />
<comment_list>
<comment>
<author>joelsheldon</author>
<text>This is immense</text>
<time>1170859705</time>
</comment>
<comment>
...
</comment>
...
</comment_list>
<channel_list>
<channel>Film & Animation</channel>
</channel_list>
<thumbnail_url>http://sjl-static1.sjl.youtube.com/vi/ss_619Vlyzs/2.jpg</thumbnail_url>
<embed_status>ok</embed_status>
</video_details>
</ut_response>
|
2.3 如何播放检索到的video
2.3.1
使用http请求播放
请求URL:http://www.youtube.com/watch?v=ss_619Vlyzs
参数v:Videoid,可以通过搜索得到。
返回的是一个网页,其中包含了包放窗体,以及该video的相关信息。
2.3.2
将播放窗体嵌入到自己的页面内播放
如果想要将播放窗体嵌入到自己的页面内需要在html中加入如下代码:
<object>
<param name="movie" value="http://www.youtube.com/v/ss_619Vlyzs"></param>
<param name="wmode" value="transparent"></param>
<embed src="http://www.youtube.com/v/ss_619Vlyzs" type="application/x-shockwave-flash" wmode="transparent" width="425" height="350"></embed>
</object>
|
下面是一个完整的播放例子,将其保存为html文档即可运行。
<html>
<head>
</head>
<body>
<object>
<param name="movie" value="http://www.youtube.com/v/ss_619Vlyzs"></param>
<param name="wmode" value="transparent"></param>
<embed src="http://www.youtube.com/v/ss_619Vlyzs" type="application/x-shockwave-flash" wmode="transparent" width="425" height="350"></embed>
</object>
</body>
</html>
|
说明:由于我网速太慢,在测试中能播放的时候很少(我只播放成功三次),多数情况是显示的Loading状态,见下图:
3 Sample实现
例子说明: 通过Youtube的搜索API获取video信息。在从信息中得到video的id,使用此ID就能播放该媒体。我们不需关心媒体的格式。
由于播放控件是嵌入到页面中的,而且没有提供多种播放模式, 我们只能改变播放窗口的大小。 我们只能在播放前将设置播放窗口的大小,播放过程中无法改变其大小。
Sample提供两种收缩功能:
l 用户的喜爱的video搜索,即youtube.users.list_favorite_videos
l 关键字搜索,即youtube.videos.list_by_tag
操作说明:
l 01 选择检索模式
l 02 输入检索条件;电击SearchButton
l 03 选择播放媒体播放
l 04 播放该媒体
Sample下载:我的资源->演练实例:YoutubeAPI使用Sample