このドキュメントでは、YouTube クロムレス プレーヤーのリファレンス情報を提供します。

目次

概要

YouTube クロムレス プレーヤーは、YouTube プレーヤーのカスタマイズに使用します。デベロッパーは、独自のコントロール、プレーヤー「クロム」、さらにはカスタム再生リストやメニューなどの動作を使用して、YouTube プレーヤーを柔軟にカスタマイズできます。

要件

エンド ユーザー側に Flash Player 8 以上がインストールされている必要があります。この要件が満たされていることを確認するため、SWFObject を使用して SWF を埋め込み、ユーザーの Flash Player のバージョンを検出することをお勧めします。

スタート ガイド

まずはデベロッパー キーが必要です。デベロッパー キーを取得するには、登録ページにアクセスしてください。

クロムレス プレーヤーは、2 つの SWF ファイルから構成されています。apiplayer.SWF には、実際の動画再生機能が含まれています。cl.SWF は、apiplayer.SWF を読み込んでプレーヤーの API 関数を公開するための読み込み SWF です。apiplayer.SWF のセキュリティ サンドボックス制約も設定するため、SWF を読み込んだとしても、プレーヤー内の要素に直接アクセスすることはできません。

プレーヤーは、2 つの方法で制御できます。1 つは、その SWF を別の SWF (Flash、ウェブサイトなど) に読み込む方法、もう 1 つはその SWF を HTML ページに直接埋め込んで JavaScript で制御する方法です。このJavaScript コントロールは、埋め込みプレーヤーの JavaScript API とまったく同じものです。

クロムレス プレーヤー SWF を読み込む URL は次のようになります。

http://gdata.youtube.com/apiplayer?key=DEV_KEY

関数

JavaScript API ドキュメントに記載されている操作に加え、以下の操作を実行できます。

loadVideoById(videoId:String, startSeconds:Number):Void

指定された動画を読み込み、その動画の再生を開始します。startSeconds (浮動小数点数も指定可) を指定すると、指定した時間に最も近いキーフレームから再生が開始されます。

cueVideoById(videoId:String, startSeconds:Number):Void

指定された動画のサムネイルを読み込み、プレーヤーでの動画の再生を準備します。playVideo() または seekTo() が呼び出されるまで FLV は要求されません。startSeconds には、playVideo() が呼び出されたときに動画の再生を開始する時間を、浮動小数点数または整数を指定できます。startSeconds を指定した状態で seekTo() を呼び出すと startSeconds は無視され、seekTo() コールで指定した時間から再生が開始されます。動画がキューに登録されて再生の準備が整うと、動画キュー イベント (5) がブロードキャストされます。

setSize(width:Number, height:Number):Void

クロムレス プレーヤーのサイズを設定します。このメソッドは、MovieClip の幅と高さを直接設定したい場合に使用します。なお、このメソッドでは動画プレーヤーの比率が制限されていないため、4:3 のアスペクト比を維持する必要があります。プレーヤーを HTML に直接埋め込む場合は、サイズは自動的に Stage.width および Stage.height の値に更新されます。したがって、クロムレス プレーヤーを HTML ページに直接埋め込む場合も、setSize() を呼び出す必要はありません。この SWF を別の SWF に読み込むときのデフォルト サイズは、320 x 240 ピクセルです。

例

JavaScript API の使用

クロムレス プレーヤーを HTML ページに読み込む際には、その SWF の URL に変数を追加して JavaScript API を有効にします。

http://gdata.youtube.com/apiplayer?key=dev_key&enablejsapi=1

使用できる API メソッドの一覧、および JavaScript API の使用例については、リファレンス ドキュメントをご覧ください。

JavaScript API を使用したクロムレス プレーヤーの例については、こちらこちら</a>をご覧ください。

別の SWF へのプレーヤーの読み込み

クロムレス プレーヤーを別の SWF に読み込む方法については、ActionScript 2.0 のドキュメントをご覧ください。上で説明した API が追加されていますが、それ以外のAPI コールはすべて同じです。

トップへ戻る