マイクが検知している音量です。値の範囲は 0 (サウンドが検知されていない) ～ 100 (非常に大音量が検知されている) です。このプロパティ値に基づいて、Microphone.setSilenceLevel() メソッドに渡す適切な値を判断できます。

マイクを利用できる状態であっても、Microphone.getMicrophone() がまだ呼び出されていないためにまだ使用されていない場合は、このプロパティは -1 に設定されます。

関連項目

オーディオ圧縮に使用するコーデックです。デフォルトで使用されるコーデックは、Nellymoser コーデックです。列挙クラス SoundCodec は、codec プロパティに対して有効な各値を含みます。

関連項目

Speex コーデックを使用する場合の、エンコードされた音質です。指定できる値は、0 ～ 10 です。デフォルト値は 6 です。次の表に示すとおり、値が大きいほど質は高くなりますが、必要な帯域幅も増えます。リストされたビットレートの値はネットのビットレートを表し、パケットのオーバーヘッドは含まれません。

関連項目

1 パケット（メッセージ）で送信される Speex 音声フレームの数です。各フレームの長さは 20 ミリ秒です。デフォルト値は、1 パケットあたり 2 フレームです。

メッセージ内の Speex フレームが増えるほど、必要な帯域幅は減りますが、メッセージの送信が遅れます。Speex フレームが少ないほど、必要な帯域幅は増えますが、遅延が軽減されます。

マイクによるサウンドのゲイン（増幅率）は、シグナルが転送前にマイクで増幅される量を表します。値 0 は 0 倍、つまりサウンドが送信されないことを示します。

この設定はステレオのボリュームつまみのようなものと考えることができます。0 は消音、50 は通常のボリューム、50 より小さい値は通常よりも低いボリューム、50 より大きい値は通常よりも大きいボリュームを表します。有効な値は 0 ～ 100 で、デフォルト値は 50 です。ユーザーは [Flash Player 設定] パネルの [マイク] を使用してこの値を変更できます。

関連項目

マイクのインデックスです。これは、Microphone.names から返される配列のインデックスと同じです。

関連項目

ユーザーがマイクへのアクセスを拒否しているか (true)、許可しているか (false) を指定します。この値が変わると、status イベントが送出されます。詳細については、Microphone.getMicrophone()を参照してください。

関連項目

サウンドキャプチャハードウェアから返される現在のサウンドキャプチャデバイスの名前です。

関連項目

使用可能なすべてのサウンドキャプチャデバイスの名前を含むストリングの配列です。この名前は、ユーザーに [Flash Player 設定] パネルの [プライバシー] を表示せずに返されます。この配列により、各サウンドキャプチャデバイスの 0 から始まるインデックスと、システム上の各サウンドキャプチャデバイスの数 (Microphone.names.length プロパティ) を調べることができます。詳細については、Array クラスのエントリを参照してください。

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

メモ : 現在のマイクの名前を調べるには、name プロパティを使用します。

関連項目

マイクのサウンドキャプチャレート (kHz) です。許容される値は、使用するサウンドデバイスがサポートする 5、8、11、22、または 44 のいずれかです。

デフォルト値は 8 kHz ですが、サウンドキャプチャデバイスがこの値に対応している必要があります。対応していない場合、デフォルト値はそのサウンドキャプチャデバイスが対応している 8 kHz よりも高いレートのうち、8 kHz に最も近い値になります。通常は 11 kHz です。

マイクを有効化したり、activity イベントを送出するために必要な音量です。デフォルト値は 10 です。

関連項目

マイクがサウンド検知を停止してから、activity イベントが送出されるまでの時間 (ミリ秒単位) です。デフォルト値は 2000 (2 秒) です。

この値を設定するには、Microphone.setSilenceLevel() メソッドを使用します。

関連項目

loopback モードになっているとき、この microphone オブジェクトのサウンドを制御します。

エコー抑制が有効になっている場合は true、それ以外の場合は false に設定します。Flash Player 設定パネルの [マイク] でユーザーが [エコーを減らす] を選択していない限り、デフォルト値は false です。

関連項目

オーディオをキャプチャする Microphone オブジェクトの参照を返します。オーディオのキャプチャを開始するには、Microphone オブジェクトを NetStream オブジェクトに接続する必要があります。NetStream.attachAudio() () のトピックを参照してください。

Microphone.get() を複数回呼び出すと、同じマイクが参照されます。このため、コードに mic1 = Microphone.get() という行と mic2 = Microphone.get() という行が含まれている場合、mic1 と mic2 はどちらも同じデフォルトのマイクを参照します。

デフォルトのマイクを取得するには、-1 を指定して getMicrophone() を呼び出す必要があります。パラメータを指定せずに getMicrophone() を呼び出すと、リスト内の最初のマイクが返されます。

現在の Microphone オブジェクトのインデックス値を取得するには、index プロパティを使用します。次に、Microphone クラスの他のメソッドにこの値を渡します。

通常は、index の値を渡さないでください。デフォルトのマイクへの参照を取得するには、単に Microphone.getMicrophone() メソッドを使用します。[マイク] パネルを使用することで、アプリケーションで使用するデフォルトのマイクをユーザーが指定できます。index で値を渡すと、ユーザーが使用するのとは異なるマイクが参照される可能性があります。index を使用できるのは、アプリケーションで 2 つのマイクから同時にオーディオをキャプチャする場合など、特殊な場合です。

SWF ファイルが Microphone.getMicrophone() メソッドから返されたオブジェクトにアクセスしようとすると（NetStream.attachAudio() を呼び出す場合など）、プライバシーダイアログボックスが表示されます。ユーザーは、そこでマイクへのアクセスを許可するか拒否するかを選択できます。ステージのサイズは必ず 215 × 138 ピクセル以上に設定してください。これは、ダイアログボックスを表示するために必要な最小サイズです。

ユーザーがこのダイアログボックスに応答すると、ユーザーの応答を示す status イベントが送出されます。Microphone.muted プロパティを確認して、ユーザーがマイクへのアクセスを許可したか、拒否したかを判別することもできます。

Microphone.getMicrophone() が null を返すのは、マイクが他のアプリケーションで使用されているか、そのシステムにマイクが取り付けられていないかのどちらかの場合です。マイクがインストールされているかどうかを調べるには、Microphones.names.length を使用します。Flash Player の [マイク] パネルを表示して、Microphone.getMicrophone で参照するマイクをユーザーが選択できるようにするには、Security.showSettings() () を使用します。

パラメータ

関連項目

マイクによってキャプチャされたオーディオをローカルスピーカーに転送します。

パラメータ

サウンドと見なす最小入力レベルと、実際に無音状態が始まったと見なすまでの無音時間の長さを設定します。後者は省略可能です。

• マイクがサウンドをまったく検知しないようにするには、silenceLevel に値 100 を渡します。こうすると、activity イベントが送出されることはありません。
• マイクが現在検知している音量を調べるには、Microphone.activityLevel を使用します。

アクティビティ検知とは、人が話していることをオーディオレベルに基づいて検知する機能のことです。誰も話していないときは、関連付けられているオーディオストリームを送信する必要がないので、帯域幅を節約できます。この情報を利用して、ユーザー (または他の誰か) が話していないことを視覚的なフィードバックとして示すこともできます。

サイレンス値はアクティビティ値に直接対応します。完全なサイレンスのアクティビティ値は 0 です。継続的な大音量 (現在のゲイン設定に基づく最大の音量) のアクティビティ値は 100 です。ゲイン (増幅率) を適切に調整すると、話していないときにはアクティビティ値がサイレンス値よりも小さくなります。話しているときには、アクティビティ値はサイレンス値よりも大きくなります。

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

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

パラメータ

関連項目

オーディオコーデックのエコー抑制機能を使用するかどうかを指定します。Flash Player 設定パネルの [マイク] でユーザーが [エコーを減らす] を選択していない限り、デフォルト値は false です。

エコー抑制とは、スピーカーから出たサウンドが同じコンピュータのマイクによって拾われるオーディオフィードバックの影響を減らす機能のことです。これは、フィードバックを完全に除去するエコー除去機能とは異なります。

一般に、キャプチャするサウンドをヘッドセットではなく同じコンピュータのスピーカーで再生する場合には、エコー抑制機能を使用することが推奨されます。サウンド出力デバイスをユーザーが選択できるようにした SWF ファイルでは、ユーザーがスピーカーを選択し、マイクも使用する場合に Microphone.setUseEchoSuppression(true) を呼び出すことをお勧めします。

ユーザーは、Flash Player 設定パネルの [マイク] でこれらの設定を調整することもできます。

パラメータ

関連項目

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

activating プロパティを true に設定して、このイベントをトリガするために必要な音量を指定するか、activating プロパティを false に設定して、このイベントをトリガするためにサウンドなしで経過する必要がある時間を指定するには、Microphone.setSilenceLevel() () を使用します。

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

関連項目

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

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

関連項目

2 つのリスナーは、activity および status のイベントを受け取ります。activity イベントはセッションの開始時と終了時（存在する場合）に送出され、activityHandler() メソッドによって捕捉されます。このメソッドはイベントの情報をトレースします。status イベントは、関連付けられた Microphone オブジェクトがステータス情報をレポートした場合に送出され、statusHandler() メソッドを使用して捕捉、トレースされます。

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

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.media.Microphone;
    import flash.system.Security;

    public class MicrophoneExample extends Sprite {
        public function MicrophoneExample() {
            var mic:Microphone = Microphone.getMicrophone();
            Security.showSettings("2");
            mic.setLoopBack(true);
                    
            if (mic != null) {
                mic.setUseEchoSuppression(true);
                mic.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
                mic.addEventListener(StatusEvent.STATUS, statusHandler);
            }
        }

        private function activityHandler(event:ActivityEvent):void {
            trace("activityHandler: " + event);
        }

        private function statusHandler(event:StatusEvent):void {
            trace("statusHandler: " + event);
        }
    }
}