ECHOMemberObjectは、個別メンバーを操作するためのオブジェクトです。

オブジェクトを生成する

オブジェクトフィールド

フィールドからデータを取得する

フィールドにデータをセットする

ACL（アクセスコントロール）が設定されているコンテンツへアクセスするには、予めアクセスが許可されているメンバーでログインしておく必要があります。

特定のメンバーでログインするには、ECHOMemberQuery.loginメソッド（同期通信によるログイン）もしくはEchoMemberQuery.loginInBackgroundメソッド（非同期通信によるログイン）を使用します。

try {
      ECHOMemberObject member = ECHOMemberQuery.login("メンバーインスタンスID", "メンバーログインID", "メンバーログインパスワード");
} catch (ECHOException e) {

      Log.e("Error", e.toString()); // ログインエラー

}

ログインに成功すると、以後ログアウトもしくはタイムアウトするまで、ログイン状態が維持されます。

ログアウトするには、ECHOMemberQuery.logoutメソッドを使用します。

ECHOMemberQuery.logout();

サーバーへメンバーを保存するには、pushメソッド（同期通信による保存）もしくはpushInBackgroundメソッド（非同期通信による保存）を使用します。

ECHOMemberObject member = new ECHOMemberObject("メンバーインスタンスID");

member.put("login_id", "john1234"); // メンバーログインIDをセット
member.put("password", "password"); // メンバーログインパスワードをセット
....

// 非同期でメンバーを保存
member.pushInBackground(new PushCallback<ECHOMemberObject>() {

      @Override // 保存完了後に実行するコールバックメソッドを定義
      public void done(ECHOMemberObject obj, ECHOException e) {
            if(e == null) { // 正常終了
                  Log.d("Complete", obj.toString());
            }else{ // 異常発生
                  Log.e("Error", e.toString());
            }
      }

});

サーバー上に存在する既存のメンバーを取得するには、fetchメソッド（同期通信による取得）もしくはfetchInBackgroundメソッド（非同期通信による保存）を使用します。

ECHOMemberObject member = new ECHOMemberObject("メンバーインスタンスID", "メンバーID");

// 非同期でメンバーデータを取得
member.fetchInBackground(new FetchCallback<ECHOMemberObject>() {

      @Override // 取得完了後に実行するコールバックメソッドを定義
      public void done(ECHOMemberObject obj, ECHOException e) {
            if(e == null) { // 正常終了
                  Log.d("Complete", obj.toString());
            }else{ // 異常発生
                  Log.e("Error", e.toString());
            }
      }

});

サーバー上に存在する既存のメンバーを削除するには、deleteメソッド（同期通信による削除）もしくはdeleteInBackgroundメソッド（非同期通信による削除）を使用します。

ECHOMemberObject member = new ECHOMemberObject("メンバーインスタンスID", "メンバーID");

// 非同期でメンバーデータを削除

member.deleteInBackground(new DeleteCallback<ECHOMemberObject>() {

      @Override // 削除完了後に実行するコールバックメソッドを定義
      public void done(ECHOMemberObject obj, ECHOException e) {
            if(e == null) { // 正常終了
                  Log.d("Complete", obj.toString());
            }else{ // 異常発生
                  Log.e("Error", e.toString());
            }
      }

});

メンバーを検索するには、ECHOMemberQuery.findメソッド（同期通信による検索）もしくはECHOMemberQuery.findInBackgroundメソッド（非同期通信による検索）を使用します。

検索条件は、第二引数にリスト制御パラメータを指定します。

// 非同期でメンバーを検索
ECHOMemberQuery.findInBackground("メンバーインスタンスID", new JSONObject("{q:\"検索キーワード\"}"), 
      new FindCallback<ECHOMemberObject>() {

            @Override // 取得完了後に実行するコールバックメソッドを定義
            public void done(List<ECHOMemberObject> objects, ECHOException e) {
                  if(e == null) { // 正常終了
                        Log.d("Complete", objects.toString());
                  }else{ // 異常発生
                        Log.e("Error", e.toString());
                  }
            }

      }
);

オブジェクトに現在設定されているACLを取得するには、getACLメソッドを使用します。

ECHOACLObject current_acl = member.getACL();

オブジェクトに新しいACLを設定するには、setNewACLメソッドを使用します。

ECHOACLObject new_acl = new ECHOACLObject(); // ACLオブジェクトを生成
new_acl.putEntryForAll(new ECHOACLEntry(false, false, false, false)); // 例：非ログイン訪問者の操作権限を全て奪う

member.setNewACL(new_acl); // 新しいACLをセット

member.push(); // セットしたACLを反映させるには、最後に必ず保存を実行してください