指定のuserIDのユーザーアカウントが現クライアントによって把握されているかどうかを示すBoolean値を返します。 与えられたユーザーアカウントは次のような場合に現クライアントによって把握されます:

• 指定したuserIDでログイン中の入室者のいるルームに現クライアントが入室あるいは観戦していて、さらにそのルームについての現クライアントのルーム更新レベルが入室者のログイン通知を含む
• 指定したuserIDでログイン中の観戦者のいるルームに現クライアントが入室あるいは観戦していて、さらにそのルームについての現クライアントのルーム更新レベルが観戦者のログイン通知を含む
• 現クライアントが指定したユーザーアカウントを観察している
• 現クライアントが指定したuserIDでログインしているクライアントを観察している
• 現クライアントがユーザーアカウントを監視していて(watchForAccounts()を参照)、さらに指定したユーザーアカウントがサーバー上に存在する
• 現クライアントがクライアントを監視していて(ClientManagerのwatchForClients()メソッドを参照)、さらに接続中のクライアントが指定したユーザーアカウントにログインした
• 現クライアントが指定したユーザーアカウントでログインした

パラメータ

関連項目

ユーザーアカウントに新たにセキュリティロールを追加します。 ロール（役割）追加の試行結果は AccountEvent.ADD_ROLE_RESULT イベントを通して返されます。これは AccountManager と、新たにロール（役割）を要求された UserAccount オブジェクトの両方を通して送出されます。 そのようなアカウントを把握していない場合、そのイベントはAccountManagerのみを通して送出されます。

ユーザーアカウントのロール（役割）は UserAccount クラスの addRole() メソッドを通して追加することもできます。

セキュリティロールについての詳細は、Union Server のセキュリティドキュメントを参照してください。

パラメータ

関連項目

     reactor.getAccountManager().addRole("tom", SecurityRole.MODERATOR);
     

     // イベントを登録します
     reactor.getAccountManager().addEventListener(
                                   AccountEvent.ADD_ROLE_RESULT,
                                   addRoleResultListener);
     
     // イベントリスナーを用意します
     protected function addRoleResultListener (e:AccountEvent):void {
       trace("Add role result for user [" + e.getUserID() + "], " 
            + "role [" + e.getUserID() + "]: "
            + e.getStatus());
     }
     

ユーザーアカウントのパスワードを変更します。 パスワード変更試行の結果はAccountManagerと変更がリクエストされているUserAccountオブジェクトを通して送出されるAccountEvent.CHANGE_PASSWORD_RESULTイベントを通して返されます。 そのようなアカウントを把握していない場合、そのイベントはAccountManagerのみを通して送出されます。

ユーザーアカウントのパスワードはUserAccountクラスのchangePassword()メソッドを通して変更することもできます。

パラメータ

関連項目

     reactor.getAccountManager().changePassword("ken", "xyz", "abc");
     

     // イベントを登録します
     reactor.getAccountManager().addEventListener(
                                   AccountManagerEvent.CHANGE_PASSWORD_RESULT,
                                   changePasswordResultListener);
     
     // イベントリスナーを用意します
     protected function changePasswordResultListener (e:AccountManagerEvent):void {
       trace("Change password result for [" + e.getUserID() + "]: " + e.getStatus());
     }
     

ユーザーアカウントを作成します。これは年齢、旅行予約、ハイスコアといったユーザー情報を永続的に格納するために使用します。 アカウント生成試行の結果はAccountManagerEvent.CREATE_ACCOUNT_RESULTイベントを通して返されます。 いったんアカウントが生成されると、クライアントはAccountManagerのlogin()メソッドを使用してそのアカウントにログインできます。

パラメータ

関連項目

もしそのアカウントがReactorによって把握されている場合、userIDによって指定されるアカウントへの参照を返します。 もしそのアカウントを把握していない場合、nullを返します。

パラメータ

把握しているユーザーアカウント数を返します。 AccountManagerがユーザーアカウントを監視しているとき(watchForAccounts()を参照してください)、getNumAccounts()は現在サーバー上に登録されている実際のユーザーアカウント数を返します。 AccountManagerがクライアントを監視していないとき、getNumAccounts()は現クライアントが知っているアカウント数だけを返します。 例えば、現クライアントが3アカウントを観察しており、サーバー上の他のアカウントに関して把握していない場合、たとえサーバー上に4以上のアカウントが登録されているとしても3を返します。

関連項目

もしこの AccountManager がアカウントを監視していれば、getNumAccountsOnServer() はサーバー上のアカウント数を返します。 そうでない場合は、getNumAccountsOnServer() は0を返します。 この AccountManager がアカウントを監視しているときは、getNumAccountsOnServer() メソッドは getNumAccounts() より高速な代替手段を提供します。

関連項目

把握している範囲でログイン済みのユーザーアカウント数を返します。

関連項目

もし指定したuserIDのアカウントが現在監視アカウントリスト内にある場合、trueを返します。それ以外の場合はfalseを返します。

パラメータ

もし指定したuserIDのアカウントが現在観察されている場合、trueを返します。それ以外の場合はfalseを返します。

パラメータ

関連項目

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

関連項目

指定のuserIDとpasswordを使用して現クライアントをログインさせます。 ログイン試行の結果はAccountManagerによってトリガーされるAccountEvent.LOGIN_RESULTイベントを通して返されます。

もしその試行が成功すると、AccountManagerと現クライアントについてのUserAccountオブジェクト(つまりreactor.self().getAccount())がAccountEvent.LOGINイベントをトリガーし、そのアカウントの永続属性が自動的にロードされます。 もし指定のユーザーIDが別のクライアントIDのもとでログイン済みであれば、前のクライアントは新たなログイン処理の前にログオフされ、切断されます。

ルームをスコープとした永続アカウント属性は現クライアントがルームに入室するか観戦するときに自動的にロードされます。 もし現クライアントがログイン時に既にルームに入室か観戦している場合、そのルームについてのルームをスコープとした属性もログイン時にロードされます。

login()メソッドは他のクライアントをログインさせるためには使用できませ。このメソッドは現クライアントのみに適用されます。

パラメータ

関連項目

     reactor.getAccountManager().login("ken", "abc");
     

     // イベントを登録します
     reactor.getAccountManager().addEventListener(AccountEvent.LOGIN_RESULT,
                                                  loginResultListener);
     
     // イベントリスナーを用意します
     protected function loginResultListener (e:AccountEvent):void {
       trace("Login result for [" + e.getUserID() + "]: " + e.getStatus());
     }
     

ユーザーアカウントをログオフさせます。 ログオフ試行の結果はAccountManagerとログオフ中のクライアントのUserAccountオブジェクトを通して送出されるAccountEvent.LOGOFF_RESULTイベントを通して返されます。 そのようなユーザーアカウントを把握していない場合、そのイベントはAccountManagerのみを通して送出されます。

login()と違って、logoff()メソッドは他のクライアントにも使用できます。 しかしながら、他のクライアントをログオフさせるためには、ログオフ要求を行うクライアントは十分な権限を有している必要があります。

パラメータ

関連項目

現クライアントをuserIDで指定したユーザーアカウントのオブザーバーとして登録するようにサーバーに要求します。 もしその要求が成功すると、Reactorは(もしまだ無い場合は)そのアカウントについてのUserAccountオブジェクトを生成し、そのオブジェクトとAccountManagerを通してAccountEvent.OBSERVE_RESULTを送出します。 UserAccountオブジェクトはそのアカウントのサーバー側の状態との同期も行い、そのためUserAccountはAccountEvent.SYNCHRONIZEイベントをトリガーします。 その後もし指定したユーザーアカウントの状態が変化すると、現クライアントは次の方法で通知を受けます:

• 観察されているアカウントがログイン：現クライアントのAccountManagerとUserAccountオブジェクトがAccountEvent.LOGINイベントをトリガーする
• 観察されているアカウントがログオフ：現クライアントのAccountManagerとUserAccountオブジェクトがAccountEvent.LOGOFFイベントをトリガーする
• 観察されているアカウントが削除された：現クライアントのAccountManagerがAccountEvent.ACCOUNT_REMOVEDイベントをトリガーする

ユーザーアカウントの観察を停止するには、UserAccountのstopObserving()メソッドを使用してください。

アカウントの観察は、フレンドリストシステムやアカウント管理機能を用いるアプリケーションで要求されるように、クライアントが任意のユーザーアカウントリストの状態を常に通知してもらいたいときに使用します。

パラメータ

関連項目

既存のユーザーアカウントを除去します。 アカウント除去試行の結果はAccountManagerEvent.REMOVE_ACCOUNT_RESULTイベントを通して返されます。 ユーザーアカウントが除去された時に該当ユーザーとしてログインしているクライアントがいる場合、そのクライアントはAccountEvent.LOGOFFイベントを受信し、サーバーから自動的に切断されます。

パラメータ

関連項目

ユーザーアカウントからセキュリティロールを除去します。 ロール（役割）除去の試行結果は AccountEvent.REMOVE_ROLE_RESULT イベントを通して返されます。これは AccountManager と、ロール（役割）の除去を要求された UserAccount オブジェクトの両方を通して送出されます。 そのようなアカウントを把握していない場合、そのイベントはAccountManagerのみを通して送出されます。

ユーザーアカウントのロール（役割）は UserAccount クラスの removeRole() メソッドを通して除去することも可能です。

パラメータ

関連項目

     reactor.getAccountManager().removeRole("tom", SecurityRole.MODERATOR);
     

     // イベントを登録します
     reactor.getAccountManager().addEventListener(
                                   AccountEvent.REMOVE_ROLE_RESULT,
                                   removeRoleResultListener);
     
     // イベントリスナーを用意します
     protected function removeRoleResultListener (e:AccountEvent):void {
       trace("Remove role result for user [" + e.getUserID() + "], " 
            + "role [" + e.getUserID() + "]: "
            + e.getStatus());
     }
     

もし現クライアントがログインしている場合、現在のクライアントのユーザーアカウントへの参照を返します。 もし現クライアントが未ログインの場合、nullを返します。

アカウントの監視を停止するようにサーバーに要求します。 応答として、サーバーはアカウントが追加または除去されるときにもう通知を送信しません。 stopWatchingForAccounts()要求の結果はAccountManagerEvent.STOP_WATCHING_FOR_ACCOUNTS_RESULTを通して返されます。

関連項目

サーバー上のユーザーアカウントのリストを送信し、その後ユーザーアカウントが作成か除去されたときにはいつでも通知を送信するようにサーバーに要求します。 この通知はAccountManagerEvent.ACCOUNT_ADDEDイベントかAccountManagerEvent.ACCOUNT_REMOVEDイベントのどちらかをトリガーします。 watchForAccounts()要求の結果はAccountManagerEvent.WATCH_FOR_ACCOUNTS_RESULTを通して返されます。

watchForAcounts()メソッドはサーバー上の全ユーザーアカウントの同期リストを表示したい管理アプリケーションで使用されます。

関連項目

AccountManagerがUnionサーバーからユーザーアカウントの作成を通知されるときに送出されます。 このイベントはAccountManagerがユーザーアカウントを監視しているときにのみ利用可能です(watchForAccounts()を参照してください)。

関連項目

AccountManagerがUnionサーバーからユーザーアカウントの削除を通知されるときに送出されます。 このイベントはAccountManagerがユーザーアカウントを監視しているときにのみ利用可能です(watchForAccounts()を参照してください)。

関連項目

関連項目

現クライアントがアカウントのパスワードを変更するときに送出されます。 ユーザーはAccountManagerのchangePassword()メソッドかUserAccountオブジェクトのchangePassword()メソッドを通して自分自身のパスワードを変更できます。 十分な権限があれば、現クライアントは他ユーザーのパスワードを変更できます。 サーバーサイドのコードは任意のユーザーのパスワードを変更できます。

関連項目

• Status.SUCCESS
• Status.ERROR
• Status.AUTHORIZATION_FAILED
• Status.ACCOUNT_NOT_FOUND

関連項目

• Status.SUCCESS
• Status.ERROR
• Status.ACCOUNT_EXISTS

関連項目

現クライアントによって把握されているクライアントのいずれかがログインするときに送出されます。 クライアントが現クライアントによって把握される状況のリストについては、ClientManagerのclientIsKnown()メソッドを参照してください。 しかしながら、RoomクラスのsetUpdateLevels()メソッドを通して"入室者ログインログオフ更新"と"観戦者ログインログオフ更新"を無効化することで、現クライアントがルーム入室者とルーム観戦者のログイン通知を受けないようにもできる点に留意してください。

AccountEvent.LOGINイベントはログインしたクライアントのClientオブジェクトを通して送出され、次にログインしたアカウントのUserAccountオブジェクト、次にAccountManagerからも送出されます。

関連項目

• Status.SUCCESS
• Status.ERROR
• Status.ALREADY_LOGGED_IN
• Status.AUTHORIZATION_FAILED
• Status.ACCOUNT_NOT_FOUND

関連項目

現クライアントによって把握されているユーザーアカウントのいずれかがログオフするときに送出されます。 クライアントが現クライアントによって把握される状況のリストについては、ClientManagerのclientIsKnown()メソッドを参照してください。 しかしながら、RoomクラスのsetUpdateLevels()メソッドを通して"入室者ログインログオフ更新"と"観戦者ログインログオフ更新"を無効化することで、現クライアントがルーム入室者とルーム観戦者のログオフ通知を受けないようにもできる点に留意してください。

AccountEvent.LOGOFFイベントはログオフしたクライアントのClientオブジェクトを通して送出され、次にログオフしたアカウントのUserAccountオブジェクト、次にAccountManagerからも送出されます。

関連項目

• Status.SUCCESS
• Status.ERROR
• Status.AUTHORIZATION_FAILED
• Status.NOT_LOGGED_IN
• Status.ACCOUNT_NOT_FOUND

関連項目

関連項目

関連項目

• Status.SUCCESS
• Status.ERROR
• Status.ACCOUNT_NOT_FOUND
• Status.AUTHORIZATION_FAILED

関連項目

関連項目

関連項目

関連項目

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

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

関連項目

関連項目

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

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

関連項目