日記/2007-12-18

YouTubeSearch プラグイン

　FreeStyleWikiの本家のサイトに投稿されているYouTube関連のプラグインには以下のようなものがあります。

• BugTrack-plugin/300 YouTube動画を埋め込むプラグイン
  • BBS雑談掲示板/225 ニコニコ動画貼りたい
• BugTrack-plugin/315 YouTube の動画を貼付ける

　これらはいずれもVideoのIDを指定するものですが、このIDを調べるのがめんどくさい。
　YouTube APIを使えば単語を与えて検索できることも知ってはいたのですが、これを使うにはデベロッパーIDの取得が必要だと思いこんでいて、これがまためんどくさい。
　ところがこの記事を見てデベロッパーIDが必要ないことがわかり、では、ということで、単語から関連するYouTubeの動画が得られるFreeStyleWiki用プラグインを作成してみました。

キャッシュ対応　2008/03/29追記

　YouTubeでの検索が非常に重いときがあり、例えば「アメトーーク！昭和アニメソング芸人」のページのように、同一ページにこのプラグインがべたべた貼ってあったりすると、ページの表示がなかなかなされないことがありました。
　そこで、明示的に指定しない限り、検索結果をキャッシュすることにして、従来のようにページ表示のたびに検索に行くのをやめました。これでページの表示が高速化されるものと思います。
　このキャッシュ対応にはStorableモジュールを使っています。StorableはPerl5.8.0から標準モジュールとなっていますので何もしなくても使えますが、それ以前のバージョンでは別途インストールする必要があります。ご注意ください。

使い方

{{youtubesearch 電気グルーヴ,300,250,5,off}}

　検索語の次の「300」「250」は表示する画像の幅、高さを示します。省略するとそれぞれ、「425」「355」になります。
　次の「5」は表示する画像の件数の上限の指定です。省略すると「1」になります。
　最後の「off」は、キャッシュしないことを明示的に示す指定です。省略したり、off以外を指定した場合には、常にキャッシュを行います。キャッシュを行うと、YouTubeでの検索結果をキャッシュファイルに保存し、プラグインが記載されているページの更新日時がキャッシュファイルよりも新しくなるまではそのキャッシュファイルに保存されている結果を用い、改めて検索を行うことはありません。
　

　
　その他の本プラグインの使用例はこちら。上記の例同様、ミュージシャンの名前と曲名で検索して、ミュージックビデオを表示するというCDTube的使い方をしています。

埋め込み無効対応　2008/08/30追記

　通常は、検索結果として得られた動画は、プラグインが記載されているページ内で再生する埋め込み動画として取り扱いますが、「リクエストによる埋め込み無効」が指定されている場合には、サムネイル画像およびその動画のYouTubeのページへのリンクを表示します。

{{youtubesearch 孤独のメッセージ　ポリス}}

インストール

• 以下のファイルをダウンロードし、./plugin以下にインストールする。
  • youtubesearch.zip(359)
• さらに以下のモジュールを./lib以下にインストールする。
  • Unicode::RecursiveDowngrade

参考および関連情報

• 俺流amazonの作り方
  • コードは、AmazonSearch プラグインと同様、この本からのパクリ。ありがとうございます。
• Developer's Guide: The Protocol - YouTube Data API - Google Code
• PerlでYouTubeのGData検索をする
  • この記事を見てこのプラグインを作成しました。ありがとうございます。
• BugTrack-plugin/300 YouTube動画を埋め込むプラグイン
  • コードの一部をパクリました。ありがとうございます。

追記

• FreeStyleWikiの本家のサイトのBugTrack-plugin/363に投稿しました。
• 2008/03/29にキャッシュ対応しました。
• 2008/06/17に、使用例で用いる検索語を「殿様のフェロモン」から「電気グルーヴ」に変更しました（前者では何も引っかからなくなったため）
• 2008/08/30に埋め込み無効対応しました。
• 2010/01/06にYouTubeSearch2 プラグインを追加しました。上記インストール手順でYouTubeSearch2 プラグインもインストールされますが、使用するためにはさらに設定が必要です。詳しくはYouTubeSearch2 プラグインのページを参照してください。