MessageChannel  - AS3

MessageChannel が送信ワーカーからの 1 つ以上のメッセージを内部メッセージキューに持つかどうかを示します。

MessageChannel オブジェクトの現在の状態を示します（open、closing、または closed）。このプロパティで有効な値は、MessageChannelState クラスで定数として定義されています。

関連する API エレメント

イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。イベントリスナーは、特定のタイプのイベント、段階、および優先度に関する表示リスト内のすべてのノードに登録できます。

イベントリスナーが正常に登録された後に、addEventListener() をさらに呼び出して優先度を変更することはできません。リスナーの優先度を変更するには、最初に removeListener() を呼び出す必要があります。その後、同じリスナーを新しい優先度レベルで再度登録できます。

リスナーが登録された後に、addEventListener()（type または useCapture に別の値を設定）を再度呼び出すと、別のリスナー登録が作成されることに注意してください。例えば、最初にリスナーを登録するときに useCapture を true に設定すると、そのリスナーはキャプチャ段階のみでリスニングします。同じリスナーオブジェクトを使用して再度 addEventListener() を呼び出すと（このとき、useCapture に false を設定）、異なる 2 つのリスナーが登録されます。1 つはキャプチャ段階でリスニングするリスナーで、もう 1 つはターゲット段階とバブリング段階でリスニングするリスナーです。

ターゲット段階またはバブリング段階のみを対象とするイベントリスナーを登録することはできません。登録時にこれらの段階が組み合わされるのは、バブリングはターゲットノードの祖先にしか適用されないためです。

イベントリスナーが不要になった場合は、removeEventListener() を呼び出して、イベントリスナーを削除します。削除しない場合、メモリの問題が発生する可能性があります。ガベージコレクションでは、オブジェクトの送出が行われている限り、リスナーを削除しないので、イベントリスナーは自動的には削除されません（useWeakReference パラメーターが true に設定されていない場合）。

EventDispatcher インスタンスをコピーしても、それに関連付けられているイベントリスナーはコピーされません。新しく作成したノードにイベントリスナーが必要な場合は、ノードを作成した後に、リスナーを関連付ける必要があります。ただし、EventDispatcher インスタンスを移動した場合は、関連付けられているイベントリスナーも一緒に移動されます。

イベントがノードで処理されるときに、イベントリスナーがそのノードに登録中であれば、イベントリスナーは現在の段階ではトリガーされません。ただし、バブリング段階など、イベントフローの後の段階でトリガーすることができます。

イベントがノードで処理されているときにイベントリスナーがノードから削除された場合でも、イベントは現在のアクションによってトリガーされます。削除された後は、その後の処理で再び登録されない限り、イベントリスナーは二度と呼び出されません。

パラメーター

function(evt:Event):void

すべてのメッセージが受信されたら、現在の MessageChannel を閉じるように指示します。

このメソッドを呼び出すと、メッセージをキューに追加するための send() メソッドを呼び出せなくなります。send() 呼び出しは失敗し、false が返されます。

また、既にキューで待機しているメッセージを受信するための receive() メソッドのみを呼び出すことができます。キューが空の場合、receive() 呼び出しは null を返します。

このメッセージチャンネルで送信したメッセージのキューから単一のメッセージオブジェクトを取得します。

送信ワーカーのコードが MessageChannel オブジェクトの send() メソッドを呼び出すたびに、1 つのオブジェクトがメッセージチャンネルの内部メッセージキューに追加されます。これらのオブジェクトは、receive() メソッドを呼び出す受信ワーカーによって 1 つずつ削除されるまでキューに積み上げられます。メッセージオブジェクトは、送信された順番に受信されます。

受信するメッセージオブジェクトがキューに含まれているかどうかを確認するには、messageAvailable プロパティを使用します。

通常、send() に渡されたオブジェクトは、AMF3 フォーマットで直列化されます。receive() 呼び出しによってオブジェクトがキューから削除されると、受信ワーカーの ActionScript オブジェクト（元のオブジェクトのコピー）に直列化解除され、ワーカーはそのコピーへの参照を受け取ります。オブジェクトのタイプによっては、コピーでなくワーカー間で共有されます。その場合、受信ワーカーが取得したオブジェクトは、オブジェクトの新しいコピーではなく、共有オブジェクト自体への参照です。この場合について詳しくは、send() メソッドの説明を参照してください。

メッセージキューが空で blockUntilReceived パラメーターに true を渡すと、メソッドの動作が変わります。その場合、ワーカーは receive() 呼び出しで実行スレッドを一時停止し、その他のコードを実行しません。送信ワーカーが send() を呼び出すと、メッセージを受信して receive() 呼び出しが完了します。次に、ワーカーは、receive 呼び出しに続くコードの次の行からコードの実行を再開します。

パラメーター

関連する API エレメント

EventDispatcher オブジェクトからリスナーを削除します。対応するリスナーが EventDispatcher オブジェクトに登録されていない場合は、このメソッドを呼び出しても効果はありません。

パラメーター

送信ワーカーからオブジェクトを送信し、受信ワーカーのメッセージキューに追加します。

arg パラメーターには、ほとんどすべてのオブジェクトを渡すことができます。後述の例外を除いて、arg パラメーターに渡されるすべてのオブジェクトは、参照からは渡されません。send() が呼び出されてからあるワーカーのオブジェクトに対して行われた変更は、別のワーカーには引き継がれません。オブジェクトを AMF3 フォーマットに直列化し、receive() が呼び出されて受信ワーカーの新しいオブジェクトに直列化解除されることで、オブジェクトがコピーされます。そのため、表示オブジェクトを含む、AMF3 フォーマットに直列化できないすべてのオブジェクトは、arg パラメーターに渡せません。カスタムクラスが適切に渡されるようにするために、クラス定義は、flash.net.registerClassAlias() 関数または [RemoteClass] メタデータを使用して登録する必要があります。どちらの方法でも、両方のワーカーのクラスのバージョンに同じエイリアスを使用する必要があります。

オブジェクトはワーカー間で共有されないという規則の例外として、5 つのタイプのオブジェクトがあります。

• Worker
• MessageChannel
• 共有可能 ByteArray（shareable プロパティを true に設定した ByteArray オブジェクト）
• Mutex
• Condition

これらのオブジェクトのインスタンスを arg パラメーターに渡すと、各ワーカーは、同じ基になるオブジェクトへの参照を持ちます。あるワーカーのインスタンスに対して行われた変更は、別のワーカーで即座に利用できます。また、send() を使用して 2 回以上それらのオブジェクトの同じインスタンスを渡すと、ランタイムは受信ワーカーにオブジェクトの新しいコピーを作成しません。代わりに、同じ参照が再利用され、システムメモリの使用を減らします。

デフォルトでは、このメソッドはオブジェクトをキューに追加して直ちに戻り、コードの次の行の実行を続行します。キューがあるサイズを超えないようにする場合は、queueLimit パラメーターを使用して、キューで許可するアイテムの最大数を指定します。send() を呼び出したときにキューのアイテム数が指定した制限を超える場合、ワーカーは send() 呼び出しで実行スレッドを一時停止します。キューサイズが指定したキュー制限を下回るのに十分な回数だけ受信ワーカーが receive() を呼び出すと、send() 呼び出しが完了します。次に、ワーカーはコードの次の行から実行を続行します。

パラメーター

関連する API エレメント

指定されたオブジェクトのストリング表現を返します。

注意：Object クラスのメソッドは、Object のプロトタイプに動的に作成されます。Object のサブクラスでこのメソッドを再定義する場合は、override キーワードを使用しないでください。例えば、Object のサブクラスでは、基本クラスのオーバーライドを使用する代わりに function toString():String が実装されます。

送信ワーカーが、MessageChannel インスタンスのキューで新しいメッセージオブジェクトが使用できることを示す、この MessageChannel オブジェクトの send() メソッドを呼び出すたびに送出されます。

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

メッセージチャンネルの state プロパティの値が変更されたときに送出されます。

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