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

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

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

関連項目

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

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

関連項目

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

関連項目

希望する最大データキャプチャレート (1 秒あたりのフレーム数) です。使用できる最大レートは、カメラの性能によって異なります。このプロパティに設定した値をカメラがサポートしていない場合は、このフレームレートは達成されません。

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

関連項目

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

関連項目

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

関連項目

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

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

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

関連項目

activity イベントを呼び出すのに必要なモーション量を指定する数値です。指定できる値は 0 ～ 100 です。デフォルト値は 50 です。

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

関連項目

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

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

関連項目

ユーザーが [Macromedia Flash Player 設定] パネルの [プライバシー] でカメラへのアクセスを禁止したか (true)、または許可したか (false) を示すブール値です。この値が変わると、status イベントが送出されます。

関連項目

現在のカメラの名前を示すストリングです。カメラのハードウェアから返されるものです。

関連項目

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

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

関連項目

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

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

関連項目

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

関連項目

ビデオをキャプチャする Camera オブジェクトへの参照を返します。ビデオのキャプチャを実際に開始するには、Camera オブジェクトを Video オブジェクトに関連付ける必要があります。詳細については、Video.attachVideo() を参照してください。

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

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

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

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

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

getCamera() が null を返した場合、カメラは他のアプリケーションによって使用されているか、そのシステムにはカメラがインストールされていません。カメラがインストールされているかどうかを調べるには、names.length プロパティを使用します。getCamera() が参照するカメラをユーザーが選択するための [カメラ] ボックスを表示するには、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() を使用します。

関連項目

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

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

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

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

関連項目

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

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

• カメラがモーションをまったく検知しないようにするには、motionLevel パラメータに 100 を指定します。この場合、activity イベントは送出されません。この値は、通常はテスト目的にのみ使用します。たとえば、イベントが送出されたときに通常トリガされるハンドラを一時的に無効にする場合などに使用します。
• カメラが現在検知しているモーションの量を調べるには、activityLevel プロパティを使用します。
  
  モーションの精度 (sensitivity) の値がアクティビティの値に直接対応します。モーションがまったく存在しない場合、アクティビティ値は 0 です。継続的にモーションが発生している場合、アクティビティ値は 100 です。移動していない場合、アクティビティ値はモーション精度値よりも低くなります。移動している場合、アクティビティ値は頻繁にモーション精度値を超えます。

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

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

関連項目

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

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

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

関連項目

カメラがセッションを開始または終了したときに送出されます。

ActivityEvent.ACTIVITY 定数は、activity イベントオブジェクトの type プロパティ値を定義します。

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

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

status イベントオブジェクトの type プロパティの値を定義します。

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

関連項目

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

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);
        }
    }
}