ユーザー管理
属性を使用して、アプリケーションのユーザーに関する追加情報を管理することができます。ユーザー属性は、キーと値のペアです。SDKは、以下のタイプの属性をサポートしています:
- ユーザーが使用可能な属性。このタイプの属性の値は、ユーザーによって入力されるか、クライアント側のゲーム内ロジックに従って指定されます。例:名前やキャラクターの属性、ゲームの難易度など。
- 読み出し専用の属性。このタイプの属性の値は、アプリケーションのサーバー側で入力して編集します。あまり変更する必要のないゲームキャラクターのステータスやユーザーのパラメータの設定に使用することをお勧めします。例:ボーナス獲得のチャンス、ゲームキャラクターキーパラメータ、ユーザーのカテゴリなどに使用します。
ユーザー属性を管理するには、以下のSDKメソッドを使用します:
UpdateUserAttributes
— ローカルにキャッシュされたユーザが編集可能な属性のリストを更新します。UpdateUserReadOnlyAttributes
— ローカルにキャッシュされた読み出し専用属性のリストを更新します。ModifyUserAttributes
— ユーザー属性のリストを作成または編集し、サーバー側で変更が行われます。RemoveUserAttributes
— 指定されたIDのユーザー属性を削除すると、サーバー側で変更が行われます。
読み出し専用属性を使用する場合は、サーバートークンまたはパブリッシャーアカウントトークンを使用して認証を行うことができます。
パブリッシャーアカウントトークンを取得するには
- パブリッシャーアカウントを入力します。
- ブラウザの開発者ツールを使って、クッキーファイルの表示ページに移動します。
pa-v4-token
パラメーターから値をコピーしてAuthorization
ヘッダーに貼り付けます。
ユーザーは、ユーザーアカウントから以下のデータを設定することができます:
- 公開されたプロフィールデータ:
- アバター
- ニックネーム
- 個人ユーザーデータ:
- 名前と苗字
- 誕生日
- 性別
- 電話番号
- メール
APIコールを使ってユーザーアカウントを管理することができます。Login & Account Systemプラグインには以下のメソッドが実装されています:
UpdateUserDetails
— ローカルにキャッシュされたユーザーデータを更新します。
ModifyUserDetails
— 指定されたユーザーデータを変更します。UpdateUserEmail
— ローカルにキャッシュされたユーザーの電子メールを更新します。UpdateUserPhoneNumber
— ローカルにキャッシュされたユーザーの電話番号を更新します。ModifyUserPhoneNumber
—ユーザーの電話番号を変更します。RemoveUserPhoneNumber
— ユーザーの電話番号を削除します。ModifyUserProfilePicture
— ユーザーのアバターを変更します。RemoveProfilePicture
— ユーザーのアバターを削除します。
友達システムを使用すると、ユーザーがお互いを見つけたり、ソーシャルコネクションを設定したりすることができます。SDKは以下の機能をサポートしています:
- ニックネームで探す
- ソーシャルネットワークから友達のリストを取得する
- 友達リストを管理、招待状を送信、友達を追加と削除、ユーザーをブロックするなど
- ユーザーアカウントによる個人情報を管理する
友達システムを実装するには、アプリケーションにユーザーアカウントの機能を持たせる必要があります。このシステムでの作業方法は、ユーザーアカウントから以下のパラメータを使用します:
- ユーザーID
- アバター
- ニックネーム
友達システムが正常に動作するためには、ユーザーがニックネームを指定する必要があります。以下のニックネーム指定ロジックを実装してください:
- ログインとパスワードで登録した名前をニックネームとして使用してください。
- ソーシャル認証やプラットフォームアカウントでのニックネーム要求を実装してください。
SDKメソッド
Login & Account Systemには、フレンドシステムとの連携方法として、以下の方法があります:
UpdateFriends
— ローカルにキャッシュされたユーザーフレンドデータを更新します。
ModifyFriends
— ユーザーのソーシャルコネクションのステータスを更新します。ソーシャルコネクションのステータスは、以下の動作によって影響を受けます:- 友達申請の送信と取り消し
- 友達申請の受諾と拒否
- 友達リストからユーザーの削除
- ユーザーのブロックまたはブロック解除
UpdateSocialFriends
— ローカルにキャッシュされたユーザーの友人のデータをソーシャルネットワークから更新します。
GetUserProfile
— ユーザーの公開プロフィールからデータを取得します。
SearchUsersByNickname
— ニックネームでユーザーを検索します。
LinkSocialNetworkToUserAccount
— ユーザーアカウントと、プレイヤーが認証に使用するソーシャルネットワークをリンクします。
UpdateLinkedSocialNetworks
— ユーザーのソーシャルネットワークデータを更新します。
ソーシャルネットワークの友達システムの実装
ユーザーがアプリケーション内でソーシャルネットワーク上の友達と対話できるようにするには、エクソラ側で友達データの保存を設定します:
- パブリッシャーアカウントに移動します。
- ログインブロックで開くをクリックして、ログインプロジェクトに移動します。
- ログインプロジェクトブロックで開きてセットアップするをクリックします。
- 一般設定 > 認証に移動します。
- ソーシャルネットワークからの友人を保存するトグルをオン>に切り替えます。
- 変更を保存します。
ソーシャルネットワークの友達をアプリケーション内のプレーヤーが利用できるようにするには、以下のロジックをアプリケーションに実装します:
LinkSocialNetworkToUserAccount
を使用してソーシャルネットワークをプレイヤーのアカウントにリンクします。UpdateUsersFriends
を使用して友達リストを更新します。UpdateSocialFriends
を使用してリンクされたソーシャルネットワークの友達リストを取得します。
誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。