カメラが検知しているモーション量です。0 (モーションは検知されていない) から 100 (大量のモーションが検知されている) までの値が設定されます。このプロパティの値は、setMotionLevel() メソッドに設定を渡す必要があるかどうかを判断するのに役立ちます。

Video.attachCamera() メソッドが呼び出されていないため、使用可能なカメラがまだ使用されていない場合は、このプロパティが -1 に設定されます。

圧縮されていないローカルビデオだけをストリーミングする場合、このプロパティはイベントハンドラに関数を割り当て済みであるときに限り設定されます。それ以外の場合は undefined になります。

関連項目

現在の送信ビデオフィードで使用できる最大帯域幅 (バイト単位) です。値 0 は、ビデオのフレーム品質を維持するために必要な帯域幅をフィードで使用できることを示します。

このプロパティの値を設定するには、setQuality() メソッドを使用します。

関連項目

現在のデータキャプチャレート (1 秒あたりのフレーム数) です。このプロパティを設定することはできません。ただし、setMode() メソッドを使用すると、これに関係する fps プロパティを設定することができます。このプロパティは、データをキャプチャする際の希望最大フレームレートを指定します。

関連項目

カメラの最大データキャプチャレート (1 秒あたりのフレーム数) です。最大データキャプチャレートは、カメラの性能によって異なります。このフレームレートを実現できない場合があります。

• このプロパティに必要な値を設定するには、setMode() メソッドを使用します。
• 現在のデータキャプチャレートを調べるには、currentFPS プロパティを使用します。

関連項目

現在のキャプチャの高さ (ピクセル単位) です。このプロパティに値を設定するには、setMode() メソッドを使用します。

関連項目

カメラのインデックスを指定する 0 から始まる整数です。これは、names プロパティから返される配列のインデックスと同じです。

関連項目

ビデオ圧縮アルゴリズムによって補間されるのではなく、完全送信されるビデオフレーム (キーフレームと呼ばれる) の数です。デフォルト値は 15 で、15 のフレームごとにフレームがキーフレームになります。1 はすべてのフレームがキーフレームであることを意味します。設定できる値は、1 ～ 48 です。

関連項目

カメラがキャプチャするローカルビューを、Flash Media Server を使用したライブ送信で使用されるように圧縮および解凍する (true) か、または圧縮されていない状態にする (false) かを示します。デフォルト値は false です。

圧縮したストリームは、ビデオの品質設定のプレビューなど、テスト目的で使用する場合には役立ちますが、非常に処理コストがかかります。ローカルビューは圧縮され、送信するためにライブ接続で使用されるように編集され、さらにローカルで表示するために解凍されます。

この値を設定するには、Camera.setLoopback() を使用します。このプロパティが true である場合に使用する圧縮率を設定するには、Camera.setQuality() を使用します。

関連項目

activity イベントを送出するために必要なモーションの量です。使用可能な値の範囲は 0 ～ 100 です。デフォルト値は 50 です。

ビデオは motionLevel プロパティの値に関係なく表示できます。詳細については、setMotionLevel()を参照してください。

関連項目

カメラがモーション検知を停止してから、activity イベントが呼び出されるまでの時間 (ミリ秒単位) です。デフォルト値は 2000 (2 秒) です。

この値を設定するには、setMotionLevel() を使用します。

関連項目

ユーザーが Flash Player の [プライバシー] ダイアログボックスでカメラへのアクセスを拒否した (true) か、許可した (false) かを示すブール値です。この値が変わると、status イベントが送出されます。

関連項目

カメラのハードウェアから返される、現在のカメラの名前です。

関連項目

[Adobe Flash Player 設定] パネルの [プライバシー] を表示せずに、使用できるすべてのカメラの名前を示すストリング配列です。この配列は ActionScript の他の配列と同じように動作します。この配列を使用して、それぞれのカメラの 0 から始まるインデックスと、システム上のカメラの数 (names.length) を調べることができます。詳細については、Array クラスの names を参照してください。

names プロパティが呼び出されると、ハードウェアを広範囲にわたって調べる必要があります。このため、配列を作成するまでに数秒間かかることがあります。ほとんどの場合は、デフォルトのカメラを使用できます。

関連項目

必要な画質レベルです。各ビデオフレームに適用される圧縮率によって決まります。指定できる品質値は 1 (最低品質、最大圧縮率) ～ 100 (最高品質、圧縮なし) です。デフォルト値は 0 です。これは、使用できる帯域幅を超えることがないように、画質が必要に応じて変更されることを示します。

このプロパティの値を設定するには、setQuality() メソッドを使用します。

関連項目

現在のキャプチャの幅 (ピクセル単位)。このプロパティに必要な値を設定するには、setMode() メソッドを使用します。

関連項目

ビデオをキャプチャする Camera オブジェクトへの参照を返します。ビデオのキャプチャを開始するには、Camera オブジェクトを Video オブジェクトに関連付ける必要があります。詳細については、Video.attachCamera() のトピックを参照してください。ビデオを Flash Media Server に送信するには、NetStream.attachCamera() を呼び出して、Camera オブジェクトを NetStream オブジェクトに関連付けます。

getCamera() メソッドを複数回呼び出した場合は、同じカメラドライバへの参照が返されます。したがって、firstCam:Camera = getCamera() と secondCam:Camera = getCamera() のようなコードが含まれている場合、firstCam と secondCam はどちらも、ユーザーのデフォルトである同じカメラを参照します。

一般には、name パラメータの値は指定せず、単に getCamera() を使用してデフォルトのカメラへの参照を取得します。ユーザーは、このセクションで後述する [カメラ] ボックスで、Flash Player で使用するデフォルトのカメラを指定できます。

SWF ファイルで getCamera() から返されたカメラにアクセスしようとすると、そのカメラへのアクセスを許可するか拒否するかをユーザーが選択できるダイアログボックスが表示されます。アプリケーションウィンドウのサイズは必ず 215×138 ピクセル以上に設定してください。これは、ダイアログボックスを表示するために必要な Flash Player の最小サイズです。ユーザーがこのダイアログボックスに応答すると、Flash Player はユーザーの応答を示す status イベントで情報オブジェクトを返します。Camera.muted はユーザーがカメラへのアクセスを拒否したことを示し、Camera.Unmuted は許可したことを示します。status イベントを使用せずにユーザーがカメラへのアクセスを拒否したか許可したかを判断するには、muted プロパティを使用します。

再生中の SWF ファイルを右クリック (Windows) または Control キーを押しながらクリック (Macintosh) し、[設定] を選択して [プライバシー] ダイアログで [後で確認] を選択すると、ユーザーは特定のドメインに対する永続的なプライバシー設定を指定することもできます。

ActionScript からユーザーに対して許可または拒否の値を設定することはできません。ただし、Security.showSettings(SecurityPanel.PRIVACY) を呼び出すことで、ユーザーに対して [プライバシー] ダイアログボックスを表示できます。ユーザーが [後で確認] を選択した場合、SWF ファイルがこのドメインからカメラにアクセスすることを許可するか禁止するかを確認するメッセージは表示されません。

getCamera() が null を返した場合、カメラは他のアプリケーションによって使用されているか、そのシステムにはカメラがインストールされていません。カメラがインストールされているかどうかを調べるには、names.length プロパティを使用します。getCamera() が参照するカメラをユーザーが選択するための、[Macromedia Flash Player 設定] パネルの [カメラ] を表示するには、System.showSettings(SecurityPanel.CAMERA) を使用します。

カメラのハードウェアスキャンには時間がかかります。カメラが 1 つでも見つかると、その Flash Player インスタンスの存続中は、ハードウェアが再びスキャンされることはありません。しかし、カメラが見つからなかった場合は、getCamera が呼び出されるたびにハードウェアがスキャンされます。この動作は、ユーザーがカメラを接続するのを忘れた場合に便利です。getCamera を呼び出すための [再試行] ボタンを SWF ファイルに用意すると、ユーザーが SWF ファイルを再起動しなくてもカメラを見つけることができます。

パラメータ

関連項目

ビデオ圧縮アルゴリズムによって補間されるのではなく、(キーフレームと呼ばれる) 完全送信されるビデオフレームを指定します。このメソッドは、Flash Media Server を使用してビデオを送信している場合にだけ使用できます。

Flash Video 圧縮アルゴリズムでは、ビデオの最後のフレームからの変更のみを送信して、ビデオを圧縮します。これらの変更部分が補間フレームと見なされます。ビデオのフレームは、前のフレームの内容に応じて補間されます。ただし、キーフレームは完全なビデオフレームであるため、前のフレームから補間されることはありません。

keyFrameInterval パラメータの値を設定する方法を判別するには、帯域幅の使用量とビデオ再生アクセシビリティの両方を検討します。たとえば、keyFrameInterval に対して大きい値を指定すると (キーフレームの送信が少なくなる)、帯域幅の使用量が減少します。ただし、これはビデオの特定のポイントで再生ヘッドの位置を指定する際に要する時間を増やすことになります。ビデオを再開するには、前のビデオフレームをより多く補間する必要があります。

逆に、keyFrameInterval に対して小さい値を指定すると (キーフレームの送信が多くなる)、ビデオフレーム全体の送信が多くなるため、帯域幅の使用量が増加しますが、録画済みのビデオ内で特定のビデオフレームをシークする際に要する時間は減ります。

パラメータ

関連項目

カメラのローカルビューに対して圧縮したビデオストリームを使用するかどうかを指定します。このメソッドは、Flash Media Server を使用してビデオを送信している場合にだけ使用できます。compress を true に設定すると、リアルタイムで表示したときの、ユーザーに対するビデオの表示状態をより正確に確認できます。

圧縮したストリームは、ビデオの品質設定のプレビューなど、テスト目的で使用する場合には役立ちますが、ローカルビューは単純に圧縮されないため、非常に処理コストがかかります。ローカルビューは圧縮されたら、送信するためにライブ接続で使用される形式に編集され、ローカルで表示するために解凍されます。

compress を true に設定した場合に使用する圧縮率を設定するには、Camera.setQuality() を使用します。

パラメータ

関連項目

カメラのキャプチャモードを指定の要件に最も近いネイティブモードに設定します。指定したすべてのパラメータに一致するネイティブモードがカメラにない場合は、要求したモードに最も近いキャプチャモードが選択されます。これにより、画像の一部が切り取られたり、フレームが削除される可能性があります。

デフォルトでは、画像のサイズを維持するために、必要に応じてフレームが削除されます。削除されるフレームの数を最小限に抑えるには、false を favorArea パラメータで渡します。ただし、これによって画像のサイズは小さくなります。

ネイティブモードを選択した場合は、指定した縦横比ができる限り維持されます。たとえば、myCam.setMode(400, 400, 30) コマンドを実行し、そのカメラで利用できる最大の幅と高さが 320 および 288 である場合は、幅と高さがともに 288 に設定されます。幅と高さを同じ値に設定することで、要求された 1:1 の縦横比が維持されます。

要求した値に最も近いモードが選択された後に、割り当てられた幅、高さ、ビデオキャプチャレートを調べるには、width、height、および fps の各プロパティを使用します。

Flash Media Server を使用する場合は、単一のフレームのキャプチャまたはコマ撮り写真の作成もできます。詳細については、NetStream.attachCamera() のトピックを参照してください。

パラメータ

関連項目

activity イベントを送出するために必要なモーションの量を指定します。アクティビティがない場合に、モーションが停止したと判定してイベントを送出するまでの時間をミリ秒単位で設定することもできます。

メモ :ビデオは motionLevel パラメータの値に関係なく表示できます。このパラメータは、ビデオを実際にキャプチャまたは表示するかどうかではなく、イベントを送出するタイミングと状況のみを決定します。

カメラがモーションをまったく検知しないようにするには、motionLevel パラメータに 100 を指定します。この場合、activity イベントは送出されません。この値は、通常はテスト目的にのみ使用します。たとえば、イベントが送出されたときに通常トリガされるハンドラを一時的に無効にする場合などに使用します。

カメラが現在検知しているモーションの量を調べるには、activityLevel プロパティを使用します。モーションの精度 (sensitivity) の値がアクティビティの値に直接対応します。モーションがまったく存在しない場合、アクティビティ値は 0 です。継続的にモーションが発生している場合、アクティビティ値は 100 です。移動していない場合、アクティビティ値はモーション精度値よりも低くなります。移動している場合、アクティビティ値は煩雑にモーション精度値を超えます。

このメソッドの目的は Microphone.setSilenceLevel() メソッドに似ています。どちらのメソッドも、activity イベントの送出方法を指定するために使用します。ただし、パブリッシュするストリームに対する影響という点では、この 2 つのメソッドは大きく異なります。

• Microphone.setSilenceLevel() は帯域幅を最適化するように設計されています。オーディオストリームが無音と考えられる場合には、オーディオデータは送信されません。代わりに、無音状態が始まったことを示すメッセージが送信されます。
• Camera.setMotionLevel() はモーションを検知し、使用する帯域幅には影響しないように設計されています。ビデオストリームでモーションが検知されない間も、ビデオは送信されます。

パラメータ

関連項目

現在の送信ビデオフィードの 1 秒あたりの最大帯域幅、または必要な画質を設定します。一般に、このメソッドは、Flash Media Server を使用してビデオを送信している場合にだけ使用します。

このメソッドを使用して、送信ビデオフィードの要素として帯域幅と画質のどちらがそのアプリケーションにとって重要かを指定します。

• 帯域幅の使用量を優先する場合は、bandwidth に数値を、quality に 0 を指定します。こうすると、指定した帯域幅内で最高品質のビデオが送信されます。必要であれば、指定の帯域幅を超えるのを防ぐために、画質が下げられます。一般には、モーションが増えるほど、画質は下がります。
• 画質を優先する場合は、bandwidth に 0 を、quality に数値を指定します。こうすると、指定した画質を維持するために必要なだけの帯域幅が使われます。必要であれば、画質を維持するためにフレームレートが下げられます。一般には、モーションが増えるほど、使用する帯域幅も増加します。
• 帯域幅と品質の両方の重要性が同程度である場合は、両方のパラメータに数値を指定します。指定の品質を達成でき、指定の帯域幅を超えない範囲のビデオが送信されます。必要であれば、指定の帯域幅を超えることなく画質を維持するために、フレームレートが下げられます。

パラメータ

関連項目

カメラがセッションを開始または終了したときに送出されます。Camera.setMotionLevel() を呼び出して、activity イベントをトリガするために必要なモーション量を指定するか (activating 値を true に設定)、activity イベントをトリガする前に経過する必要があるアクティビティを実行しない時間を指定します (activating 値を false に設定)。

このイベントには、次のプロパティがあります。

カメラがそのステータスをレポートしたときに送出されます。code プロパティの値が "Camera.muted" である場合、SWF ファイルのカメラへのアクセス許可を拒否したことになります。code プロパティの値が "Camera.Unmuted" の場合、SWF ファイルがユーザーのカメラにアクセスすることをユーザーが許可しています。

このイベントには、次のプロパティがあります。

関連項目

メモ :この例を正しく機能させるには、コンピュータにカメラを接続しておく必要があります。

package {
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    import flash.events.*;
    import flash.media.Camera;
    import flash.media.Video;

    public class CameraExample extends Sprite {
        private var video:Video;
        
        public function CameraExample() {
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            
            var camera:Camera = Camera.getCamera();
            
            if (camera != null) {
                camera.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
                video = new Video(camera.width * 2, camera.height * 2);
                video.attachCamera(camera);
                addChild(video);
            } else {
                trace("You need a camera.");
            }
        }
        
        private function activityHandler(event:ActivityEvent):void {
            trace("activityHandler: " + event);
        }
    }
}