Craving Explorer Site Script

Craving Explorer に対応するサイトを追加する為のスクリプトです。

利用方法

site-script フォルダにスクリプトを追加すると自動で認識されます。現在対応しているのものは Javascript(拡張子.js) のみになります。

対応しているページを表示すると、ツールバーの『動画のダウンロード』ボタンが有効になります。

スクリプト仕様

function isSiteUrl( url )

[概要]
ページの表示が完了すると呼び出されます。
スクリプトで対応している URL かどうかを返してください。

[引数] BSTR url
表示中の URL

[戻り値]
スクリプトで対応している URL の場合、true、それ以外は false を返してください。


function getVideoDetail( url )

[概要]
保存ボタン等から保存しようとしたときに呼び出されます。
URL で指定されたページの動画タイトル、URL を返してください。

[引数] BSTR url
保存する動画の URL

[戻り値]
配列[添字 'videoTitle' ] 動画のタイトルを返してください。
配列[添字 'videoUrl' ] 動画の URL を返してください。

注意事項

α公開ですので、仕様が変更になる可能性がありますのでご注意ください。

Craving Explorer Script

Craving Explorer のダウンロード、変換機能を外部アプリケーションから操作するための API です。OLE オートメーションを利用しているので、Java Script、Visual Basic 等、さまざまな言語から利用可能です。

現在作成途中のため、詳細な仕様はある程度実装が完了した時点で公開します。

利用サンプル

利用サンプルとして、タブブラウザ Sleipnir UserAction Extension との連携スクリプトを作成しています。

CravingExplorerDownload.js

このスクリプトを利用することで、Sleipnir のマウスジェスチャ等で、簡単に動画の変換/保存が行えます。

サンプルスクリプト利用方法

(1) Sleipnir を 公式ページ よりダウンロードし、インストールしてください。
(2) Sleipnir のプラグイン UserAction Extension をインストールしてください。
(3) [Sleipnir インストールフォルダ]\plugins\scripts に、スクリプトファイルをコピーしてください。
(4) Sleipnir のアクションとして、CravingExplorerDownload が追加されますので、マウスジェスチャやメニューに割り当ててください。
(5) 保存したい動画のページで、アクションを実行すると（ジェスチャの実行、メニューの選択でアクションが実行されます）、Craving Explorer で動画のダウンロードが開始されます。

※ Craving Explorer が起動していない状態では利用できません。

サンプルスクリプト解説

var craving = new ActiveXObject( 'CravingExplorer.Api' );
if ( craving != null ) {
craving.addDownloadItem( location.href, 'flv', true );
}

4 行の簡単なスクリプトです。

'flv' 部分を、template\convert.xml に記載されている ActionName に置き換えることで、任意の形式に変換してダウンロードできます。

true となっている部分を false にすることで、毎回保存先を指定することができます。

注意事項

現在公開 API は、一つのみですが、今後随時追加していく予定です。
API に関してはα公開ですので、仕様が変更になる可能性がありますのでご注意ください。

Customize Search Result

Craving Explorer では、検索結果の表示をカスタマイズすることができます。

HTMLを独自に拡張し、検索結果を表示しているので、HTML や CSS が少しでも理解できれば、簡単に検索結果のページをカスタマイズすることが可能です。

カスタマイズ方法

template フォルダにある、以下のファイルを直接編集してください。

YouTubeSearch.html
YouTube 検索の検索結果をカスタマイズできます。


YouTubeSearchThumbnail.html
YouTube(サムネイル)検索の検索結果をカスタマイズできます。


上記ファイルは、以下に記載する仕様に沿って作成されていますので、カスタマイズの参考にしてください。

テンプレート仕様

Search Name Block

[%SEARCH_NAME]	ブロックの開始
[%/SEARCH_NAME]	ブロックの終了

表示する検索エンジンを指定するためのブロックです。
どのエンジンを利用するかを決定する為のブロックで、検索結果としては表示されません。 以下の検索エンジンを指定可能です。
このブロックは、テンプレートの開始部分に必ず置く必要があります。

YOUTUBE	YouTube の検索結果を表示します。
AMAZON	Amazon の検索結果を表示します。

Global

以下の文字列がテンプレート全体で利用できます。

[$KEYWORD]	検索キーワード
[${SearchName}:RESULT-COUNT]	{SearchName} で指定した検索エンジンの検索結果数。SearchName には YOUTUBE が指定可能。(AMAZON の検索結果数は、現在未実装。)

YouTube

[%YOUTUBE]	ブロックの開始
[%/YOUTUBE]	ブロックの終了

YouTube の検索結果数分、ブロックの中が繰り返されます。
このブロックの中では、以下の文字列が置き換わります。

[$YOUTUBE-URL]	YouTube URL
[$FULL-SCREEN-URL]	フルスクリーン表示 URL
[$SAVE-FILE-FLV-URL]	FLV ファイル保存 URL
[$SAVE-FILE-AVI-URL]	AVI ファイル保存 URL
[$SAVE-FILE-MPEG-URL]	MPEG ファイル保存 URL
[$SAVE-FILE-WAV-URL]	WAV ファイル保存 URL
[$SAVE-FILE-MP3-URL]	MP3 ファイル保存 URL
[$THUMBNAIL-URL]	サムネイル画像 URL
[$TITLE]	タイトル
[$LENGTH]	再生時間
[$DESCRIPTION]	概要
[$TAGS]	タグ
[$RATEING-IMG-URL]	評価画像へのリンク
[$RATEING-COUNT]	評価人数

Amazon

[%AMAZON]	ブロックの開始
[%/AMAZON]	ブロックの終了

Amazon の検索結果数分、ブロックの中が繰り返されます。
このブロックの中では、以下の文字列が置き換わります。

[$DETAIL-PAGE-URL]	商品へのリンク
[$SMALL-IMAGE]	SmallImage へのリンク
[$MEDIUM-IMAGE]	MediumImage へのリンク
[$ASIN]	ASIN
[$AUTHOR]	製作者(autchor, creator, artist, manufacturer)
[$PRODUCT-GROUP]	商品カテゴリ
[$TITLE]	商品名
[$LOWEST-NEW-PRICE]	最安値(新品)
[$LOWEST-USED-PRICE]	最安値(中古)
[$AMAZON-PRICE]	Amazon 価格
[$AVAILABILITY]	状態
[$AVERAGE-RATING]	評価平均
[$AVERAGE-RATING-IMAGE]	評価平均画像

作成したテンプレートやスクリプトを 作者 にメールして頂ければ幸いです。サイト上で公開させていただきます。作成されたら是非ご連絡下さい。