コンストラクタ

指定のclientIDのクライアントが現クライアントによって把握されているかどうかを示す論理値を返します。 クライアントは次の状況で把握されます:

• このClientManagerが複数のクライアントと、Unionサーバーに接続されている特定のIDを持つクライアントを監視しています。 ClientManagerクラスのwatchForClients()メソッドを参照してください。
• 現クライアントが入室または観戦しているルーム内には指定のclientIDのクライアントがおり、そのルームについての現クライアントの更新レベルが入室者リスト更新を含んでいます(UpdateLevelsクラスを参照してください)。
• 現クライアントが入室または観戦しているルームを指定のclientIDのクライアントが観戦しており、そのルームについての現クライアントの更新レベルが観戦者リスト更新を含んでいます(UpdateLevelsクラスを参照してください)。
• 現クライアントが指定のclientIDのクライアントを観察しています。 ClientManagerのobserveClient()メソッドを参照してください。
• 指定のclientIDのクライアントがログインし、現クライアントがユーザーアカウントを監視しています。 AccountManagerのwatchForAccount()メソッドを参照してください。
• 指定のclientIDのクライアントがアカウントにログインし、現クライアントがそのアカウントを観察しています。 AccountManagerのobserveAccount()メソッドを参照してください。
• 指定のclientIDのクライアントが現クライアントです。

パラメータ

このオブジェクトを永久に無効化します。 このオブジェクトは再利用できません。 dispose()メソッドの目的はこのオブジェクトをガーベッジコレクトの対象とすることです（例えば、.swfファイルをアンロードする前に）。 ClientManagerクラスのdispose()メソッドはReactorクラスのdispose()が発動したときに自動的に発動します。

渡されたclientIDs内の全クライアントの指定した属性の値を含むオブジェクトの配列を返します 配列中の各オブジェクトはclientIDプロパティ（そのクライアントのID）とvalueプロパティ（その属性値）を持ちます。 clientIDs内のクライアントで、存在しないか指定の属性にセットされた値を持たないもののvalueプロパティはnullになります。

クライアント属性についての詳細はClientクラスのsetAttribute()メソッドを参照してください。

パラメータ

関連項目

     var theRoom:Room = reactor.getRoomManager().getRoom("examples.chatroom");
     var clientList:Array = theRoom.getClientIDs();
     // ここで、"username"属性はグローバルなので、attrScopeは省略されます。
     var attrList:Array = reactor.getClientManager().getAttributeForClients(
                                                                    clientList,
                                                                    "age");
     
     for each (var item:Object in attrList) {
       trace("The value of 'age' for client "
             + item.clientID + " is: " + item.value);
     }

指定のクライアントを表すオブジェクトを返します。 デフォルトでは、そのオブジェクトはnet.user1.reactor.Clientクラスのインスタンスです。 しかし、指定したスコープのクライアントとしてカスタムクラスが指定されていた場合、オブジェクトはそのカスタムクラスのインスタンスとなります。 ClientのカスタムクラスはIClientのsetClientClass()メソッド、RoomクラスのsetDefaultClientClass()メソッドとClientManagerのsetDefaultClientClass()メソッドを通して指定できます。

クライアントオブジェクトのクラスは次のように決定されます:

• もしクライアントがこのスコープでカスタムクラスを指定している場合、そのクライアントオブジェクトのクラスはそのカスタムクラスです
• その他に、もしルームがこのスコープでカスタムクラスを指定している場合、そのクライアントオブジェクトのクラスはそのカスタムクラスです
• その他に、もしClientManagerがこのスコープでカスタムクラスを指定している場合、そのクライアントオブジェクトのクラスはそのカスタムクラスです
• その他の場合はそのクライアントオブジェクトのクラスはnet.user1.reactor.Clientです

パラメータ

関連項目

指定した属性名と値と一致する属性名と値を持っているようなクライアントで、ClientManagerが把握している最初のものを返します。 一致する属性を持つクライアントがなかった場合、nullを返します。

パラメータ

関連項目

userIDによって指定されるアカウントにログインしたクライアントを返します。 もし指定したuserIDを使ってログインしているクライアントを把握していない場合、nullを返します。

パラメータ

関連項目

現クライアントが把握している全てのクライアントオブジェクトのリストを返します。 リスト内の各クライアントオブジェクトはnet.user1.reactor.Clientかカスタムクライアントクラスのどちらかのインスタンスであり、次のように決定されます:

• もしそのクライアントがグローバルスコープでカスタムクラスを指定している場合、そのクライアントオブジェクトのクラスはそのカスタムクラスです。
• その他に、もしClientManagerがカスタムクラスを指定している場合、そのクライアントオブジェクトのクラスはそのカスタムクラスです
• その他の場合はそのクライアントオブジェクトのクラスはnet.user1.reactor.Clientです

関連項目

このアプリケーション内のクライアントが使用するグローバルのデフォルトクラスを返します。

関連項目

指定したクライアントIDの内部のClientオブジェクトを返します。 このメソッドは次の状況でのみ必要とされます。 CustomClientを拡張していないカスタムクライアントクラスを指定したとき、IClientを直接実装してClientインスタンスを構成する必要があります。 そのような構成されたインスタンスを得るために、カスタムクラスはgetInternalClient()を使用する必要があります。 そうでない場合は、クライアントアプリケーションはgetInternalClient()ではなく、getClient()を通してClientオブジェクトを取得するべきです。

パラメータ

関連項目

自分自身を除いて、現クライアントがこれまでに把握したクライアントの合計数を返します。

関連項目

現クライアントを除いてReactorが把握しているクライアント数を返します。 ClientManagerがクライアントを監視しているとき(watchForClients()を参照してください)、getNumClients()は現在Unionサーバーに接続している実際のクライアント数を返します。 ClientManagerがクライアントを監視していないとき、getNumClients()は減クライアントが気づいているクライアント数のみを返します。 例えば、もし現クライアントが他の3クライアントと一つのルームに入室しており、サーバー上の他のクライアントに関して把握していない場合、getNumClients()はたとえサーバー上に4以上のクライアントが接続しているとしても3を返します。

関連項目

もしClientManagerがクライアントを監視している場合、getNumClientsOnServer()はサーバー上のクライアント数を返します。そうでない場合、getNumClientsOnServer()は0を返します。

関連項目

もし指定のclientIDを持つクライアントが監視中のクライアントリスト内にある場合はtrueを、そうでない場合はfalseを返します。

パラメータ

もし指定のclientIDを持つクライアントが現在観察されている場合はtrueを、そうでない場合はfalseを返します。

パラメータ

関連項目

現クライアントが現在クライアントを監視しているかどうかを示します。

関連項目

現クライアントをclientIDで指定したクライアントのオブザーバーとして登録するようにサーバーに要求します。 この要求の結果はClientManagerによってトリガーされるClientEvent.OBSERVE_RESULTイベントを通して返されます。 もしその要求が成功すると、Reactorは(もしまだ無い場合は)そのクライアントについてのClientオブジェクトを生成し、ClientEvent.OBSERVEイベントがClientManagerによってトリガーされます。 Clientオブジェクトはサーバー側のそのクライアントの状態と同期されるようになります。 その後もし指定したクライアントの状態が変化すると、現クライアントは次の方法で通知を受けます:

• 観察下のクライアントの属性の変更: そのClientオブジェクトがAttributeEvent.UPDATEイベントをトリガーします
• 観察下のクライアントの属性の削除: そのClientオブジェクトがAttributeEvent.DELETEイベントをトリガーします
• 観察下のクライアントのルームへの入室: そのClientオブジェクトがClientEvent.JOIN_ROOMイベントをトリガーします
• 観察下のクライアントのルームからの退室: そのClientオブジェクトがClientEvent.LEAVE_ROOMイベントをトリガーします
• 観察下のクライアントのルーム観戦の開始: そのClientオブジェクトがClientEvent.OBSERVE_ROOMイベントをトリガーします
• 観察下のクライアントのルーム観戦の停止: そのClientオブジェクトがClientEvent.STOP_OBSERVING_ROOMイベントをトリガーします
• 観察下のクライアントのユーザーアカウントへのログイン: 現クライアントのAccountManagerがAccountEvent.LOGINイベントをトリガーします
• 観察下のクライアントのユーザーアカウントからのログオフ: 現クライアントのAccountManagerがAccountEvent.LOGOFFイベントをトリガーします
• 観察下のクライアントの切断: 現クライアントのClientmanagerがClientManagerEvent.CLIENT_DISCONNECTEDイベントをトリガーします

クライアントの観察を停止するには、ClientのstopObserving()メソッドを使用してください。

クライアントの観察は、クライアントのマッチメイキングか管理者インターフェースを用いるアプリケーションでよくあるように、クライアントが任意のクライアントリストの状態を常に通知してもらいたいときに使用します。

パラメータ

関連項目

Sends a message to a set of specified clientIDs. メッセージを一つのクライアントのみに送信するには、ClientのsendMessage()メソッドを使用してください。

メッセージを受信するには、受信するクライアントはMessageManagerのaddMessageListener()メソッドを通してメッセージリスナーを登録する必要があります。 例えば、

    // "SMILE"と名づけられたメッセージをクライアントIDが 2, 34, および84のクライアントに送信します
    reactor.getClientManager().sendMessage("SMILE", ["2", "34", "84"]);
    
    // 受信するクライアント内のコードで、メッセージを登録します
    connection.getMessageManager().addMessageListener("SMILE",
                                                      smileListener);
    
    // SMILEメッセージを受信したときに呼び出されるメソッドです
    protected function privateMessageListener (fromClient:IClient,
                                               messageText:String):void {
      trace("Smile from client: " + fromClient.getClientID());
    }
    

ルーム内の全てのクライアントにメッセージを送信するには、RoomのsendMessage()メソッドを使用します。

サーバー上の全てのクライアントにメッセージを送信するには、ServerのsendMessage()メソッドを使用します。

パラメータ

関連項目

クラスをReactorアプリケーション内の全クライアントのデフォルトクラスとして使用するように割り当てます。

デフォルトでは、全てのクライアントはIClientを実装したClientクラスのインスタンスによって表されます。 しかし、カスタムクラスによってクライアントを表すこともできます。 カスタムクライアントクラスはClientクラスのsetClientClass()メソッドを通して、基本的にクライアントごとに指定できます。 または、RoomクラスのsetDefaultClientClass()メソッドを通してカスタムクライアントクラスをルームごとに指定することができます。 または、ClientManagerクラスのsetDefaultClientClass()メソッドを用いると、カスタムクライアントクラスをグローバルに割り当てられます。 クラスがsetDefaultClientClass()を通じてグローバルに指定されているときは、scope未指定のClientManagerのgetClient()を通して取得されるいずれのクライアントのクライアントクラスにもそれが使用されます。

RoomのsetDefaultClientClass()メソッドを通して指定された全てのカスタムクラスはグローバルのデフォルトクライアントクラスを上書きします。 似たように、ClientのsetClientClass()メソッドを通して指定されたカスタムクラスはいずれもルームとグローバルのデフォルトクライアントクラスをオーバーライドします。

パラメータ

関連項目

クライアントの監視を停止するようにサーバーに要求します。 応答として、サーバーはクライアントが接続または切断するときにもう通知を送信しません。

stopWatchingForClients()要求の結果はClientManagerEvent.STOP_WATCHING_FOR_CLIENTS_RESULTを通して返されます。

関連項目

現在サーバーに接続中のクライアントのリストを送信し、その後クライアントが接続か切断したときにはいつでも通知を送信するようにサーバーに要求します。 クライアントリストが準備できると、ClientManagerはClientManagerEvent.SYNCHRONIZEイベントを送出します。 その後のクライアントの接続はClientManagerEvent.CLIENT_CONNECTEDイベントをトリガーします。 その後の切断はClientManagerEvent.CLIENT_DISCONNECTEDイベントをトリガーします。

watchForClients()要求の結果はClientManagerEvent.WATCH_FOR_CLIENTS_RESULTを通して返されます。

関連項目

ClientManagerがUnionサーバーからクライアントの接続を通知されたときに送出されます。 このイベントはClientManagerがクライアントを監視しているときにのみ利用可能です(watchForClients()を参照してください)。

関連項目

ClientManagerがUnionサーバーからクライアントの切断を通知されたときに送出されます。 このイベントはClientManagerがクライアントを監視している(watchForClients()を参照)か、切断したクライアントを観察しているとき(observeClient()を参照)にのみ利用可能です。

関連項目

関連項目

関連項目

関連項目

関連項目

ClientManagerが先に行われたstopWatchingForClients()要求の結果を受信するときに送出されます。 試行結果を診断するには、getStatus()を使用します。これは次の値をとる可能性があります。

• Status.SUCCESS
• Status.ERROR
• Status.NOT_WATCHING

関連項目

関連項目

ClientManagerが先に行われたwatchForClients()要求の結果を受信するときに送出されます。 要求の結果を究明するためには、getStatus()を使用してください。これは次の戻り値のうちどれかになります:

• Status.SUCCESS
• Status.ERROR
• Status.ALREADY_WATCHING

関連項目