python3.4 pafyモジュールの覚書
pafyモジュールを使ってみたかったので、ドキュメントの内容を適当に訳してみました。
〜〜以下ドキュメントの内容～～
import pafyurl='https://www.youtube.com/～～～～～～'#pafyのインスタンスを作る
video=pafy.new(url)
"""
pafy.new(video_url[, basic=True][, gdata=False][, signature=True][, size=False][, callback=None])
パラメータ※デフォルト値が推奨
url(str)
→動画のURLまたはvideoIDを指定
base(bool)
→True：初期設定。基本的なメタデータとストリームを取得
→False：メタデータとストリームを取得しない
gdata(bool)
→False：初期設定
→True：アップロード日、説明、カテゴリ、ユーザー名、like、dislikeなどのgdata情報を取得する
signature (bool)
→True：初期設定
→False：設定しても意味はない（今後のバージョンで削除予定）
size(bool)
→False：初期設定
→True：それぞれのストリームのサイズを取得
callback(function)
→ステータスの文字列を受け取るための関数
戻り値→pafyクラスのインスタンス
"""
#インスタンス「pafy.new(url)」のアトリビュート
#ビデオの作者(str)
print(video.author)
#サムネイルのURL(str)
print(video.bigthumb)
#大きいサムネイルのURL(str)
print(video.bigthumbhd)
#動画のカテゴリー(str)
print(video.category)
#動画の説明(str)
print(video.description)
#動画のdislike(int)
print(video.dislikes)
#動画のslike(int)
print(video.likes)
#動画の再生時間「HH:MM:SS」(str)
print(video.duration)
#動画のキーワード(list)
print(video.keywords)
#動画の再生時間「秒単位」(int)
print(video.length)
#動画の公開日「2010-10-12 21:40:19」（str）
print(video.published)
#動画の評価「0-5」(float)
print(video.rating)
#小さいサムネイルのURL(str)
print(video.thumb)
#動画のタイトル(str)
print(video.title)
#動画のアップロード者の名前(str)
print(video.username)
#動画の11文字のID(str)
print(video.videoid)
#動画の再生回数(int)
print(video.viewcount)
#stream型のリストを返すインスタンス「pafy.new(url)」のアトリビュート
#映像と音声両方を含むストリーム
print(video.streams)
#音声のみのストリーム「.m4a .oggなど」
print(video.audiostreams)
#映像のみのストリームのリスト
print(video.videostreams)
#オーディオストリームにエンコードされたogg vorbisのリスト
print(video.oggstreams)
#ビデオストリームにエンコードされたaccのリスト
print(video.m4astreams)
#利用可能なすべてのストリームのリスト
print(video.allstreams)
#pafyインスタンスのメソッド
#pafyインスタンスで指定された動画の最高画質のストリームにアクセスするためのメソッド
#映像、音声つきの最高の解像度を持つstream型を返す
stream_1=video.getbest()
print(stream_1)
#最高のビットレートの音声のみのstream型を返す
stream_2=video.getbestaudio()
print(stream_2)
#映像のみの最高解像度のstream型を返す
stream_3=video.getbestvideo()
print(stream_3)
"""
Pafy.getbest([preftype="any"][, ftypestrict=True])
Pafy.getbestaudio([preftype="any"][, ftypestrict=True])
Pafy.getbestvideo([preftype="any"][, ftypestrict=True])
パラメータ
preftype(str)
→優先するファイル形式。選択した形式でstream型を返すmp4、webm、flv、3gpなど。
ftypestrict(bool)
→True：初期設定
→False：preftypeで選択されたファイル形式の最高画質よりも高い画質を持つ他の形式があった場合、
他の形式の最高画質のstream型を返す
戻り値→stream型
"""
#ストリームのアトリビュート
#ストリームへのダイレクトアクセスURL。wgetやcurlで動画をダウンロードするために使用することができる(str)
print(stream_1.url)
#ストリームへのダイレクトアクセスhttps URL。(str)
print(stream_1.url_https)
#ストリームのビットレート。オーディオストリームのみ対応。「256k」(str)
print(stream_2.bitrate)
#ストリームの解像度。ビデオストリームのみ対応。「(640, 360)」(tuple)
print(stream_1.dimensions)
#ストリームの拡張子(str)
print(stream_1.extension)
#ストリームのメディアタイプ「"normal","audio","video"」(str)
print(stream_1.mediatype)
#ストリームの品質。videoであれば解像度「820x640」(str)、audioであればビットレート。
print(stream_1.quality)
#ストリームの解像度「820x640」(str)。オーディオストリームの場合「0x0」となる(str)
print(stream_1.resolution)
#オーディオストリームのビットレート(int)
print(stream_1.rawbitrate)
#ストリームが3D映像であるか否か(bool)
print(stream_1.threed)
#ストリームのタイトル。インスタンスのtitle属性と同様
print(stream_1.title)
#ストリームに関する追加の注意事項（6チャンネルサラウンドなど）(str)
print(stream_1.notes)
#stream型のメソッド
#ストリームのファイルサイズを返す
filesize=stream_1.get_filesize()
print(filesize)
#ストリームのダウンロード
stream_1.download()
"""
Stream_1.download([filepath=""][, quiet=False][, callback=None][, meta=False][, remux_audio=False])
パラメータ
filepath(str)
→ストリームを保存する場所を指定
quiet(bool)
→False：初期設定
→True：ダウンロードの進行状況を出力しない
callback(function or None)
→ダウンロードの進捗状況を受け取る関数を記載できる
meta(bool)
→Falese：初期設定
→True：videoIDとitagをファイル名に追記する
remux_audio(bool)
→False：初期設定
→True：リマックスオーディオファイルをダウンロードする場合
戻り値→(str)
"""
