ユーザー管理
属性を使用して、アプリケーションのユーザーに関する追加情報を管理することができます。ユーザー属性は、キーと値のペアです。SDKは、以下のタイプの属性をサポートしています:
- ユーザーが使用可能な属性。このタイプの属性の値は、ユーザーによって入力されるか、クライアント側のゲーム内ロジックに従って指定されます。例:名前やキャラクターの属性、ゲームの難易度など。
- 読み出し専用の属性。このタイプの属性の値は、アプリケーションのサーバー側で入力して編集します。あまり変更する必要のないゲームキャラクターのステータスやユーザーのパラメータの設定に使用することをお勧めします。例:ボーナス獲得のチャンス、ゲームキャラクターキーパラメータ、ユーザーのカテゴリなどに使用します。
ユーザー属性を管理するには、以下のSDKメソッドを使用します:
GetUserAttributes
— ユーザー属性のリストを取得します。Get user’s attributes from client APIコールはSDKメソッドと一緒に使用されます。UpdateUserAttributes
— ユーザー属性の値を更新します。Update user’s attributes from client APIコールはSDKメソッドと一緒に使用されます。RemoveUserAttributes
— 指定したIDを持つユーザー属性を削除し、変更はサーバー側で行われます。Update user’s attributes from client APIコールはSDKメソッドと一緒に使用されます。
読み出し専用属性を使用する場合は、サーバートークンまたはパブリッシャーアカウントトークンを使用して認証を行うことができます。
パブリッシャーアカウントトークンを取得するには
- パブリッシャーアカウントを入力します。
- ブラウザの開発者ツールを使って、クッキーファイルの表示ページに移動します。
pa-v4-token
パラメーターから値をコピーしてAuthorization
ヘッダーに貼り付けます。
ユーザーは、ユーザーアカウントから以下のデータを設定することができます:
- 公開されたプロフィールデータ:
- アバター
- ニックネーム
- 個人ユーザーデータ:
- 名前と苗字
- 誕生日
- 性別
- 電話番号
- メール
APIコールを使ってユーザーアカウントを管理することができます。Login & Account Systemアセットには以下のメソッドが実装されています:
GetUserInfo
— ローカルにキャッシュされたユーザーデータを更新します。
UpdateUserInfo
— 指定されたユーザーデータを変更します。GetUserPhoneNumber
— ローカルにキャッシュされたユーザーの電話番号を更新します。ChangeUserPhoneNumber
— ユーザーの電話番号を更新します。DeleteUserPhoneNumber
— ユーザーの電話番号を削除します。UploadUserPicture
— ユーザーのアバターを変更します。DeleteProfilePicture
— ユーザーのアバターを削除します。
友達システムを使用すると、ユーザーがお互いを見つけたり、ソーシャルコネクションを設定したりすることができます。SDKは以下の機能をサポートしています:
- ニックネームで探す
- ソーシャルネットワークから友達のリストを取得する
- 友達リストを管理、招待状を送信、友達を追加と削除、ユーザーをブロックするなど
- ユーザーアカウントによる個人情報を管理する
友達システムを実装するには、アプリケーションにユーザーアカウントの機能を持たせる必要があります。このシステムでの作業方法は、ユーザーアカウントから以下のパラメータを使用します:
- ユーザーID
- アバター
- ニックネーム
友達システムが正常に動作するためには、ユーザーがニックネームを指定する必要があります。以下のニックネーム指定ロジックを実装してください:
- ログインとパスワードで登録した名前をニックネームとして使用してください。
- ソーシャル認証やプラットフォームアカウントでのニックネーム要求を実装してください。
SDKメソッド
Login & Account Systemアセットには、友達システムとを操作するための次の方法があります:
GetUserFriends
— ローカルにキャッシュされたユーザの友人データを更新します。Get user’s friends APIコールはSDKメソッドと一緒に使用されています。
UpdateUserFriends
— ユーザーのソーシャルコネクションのステータスを更新します。Update user’s friends APIコールはSDKメソッドと一緒に使用されています。ソーシャルコネクションの状態は、以下のアクションの影響を受けます:- 友達申請を送信またはキャンセルする
- 友達リクエストを承認または拒否する
- 友達リストからユーザーを削除する
- ユーザーのブロックを解除する
GetUserSocialFriends
— ソーシャルネットワークからユーザーの友達のローカルにキャッシュされたデータを更新します。Get social account friends APIコールはSDKメソッドと一緒に使用されています。
GetPublicInfo
— ユーザーの公開プロファイルからデータを取得します。Get user public profile APIコールはSDKメソッドと一緒に使用されます。
SearchUsers
— はニックネームでユーザーを検索します。Search users by nickname APIコールはSDKメソッドと一緒に使用されます。
LinkSocialProvider
— ユーザーアカウントとプレイヤーが認証のために使用するソーシャルネットワークをリンクしています。Link social network to user’s account APIコールはSDKメソッドと一緒に使用されます。
GetLinkedSocialProviders
— ユーザーのソーシャルネットワークのデータを更新します。Get linked networks APIコールはSDKメソッドと一緒に使用されます。
GetSocialNetworkAuthUrl
— ソーシャルネットワークとプレイヤーのアカウントをリンクするためのURLを取得します。Get URL to link social network to account APIコールはSDKメソッドと一緒に使用します。
ソーシャルネットワークの友達システムの実装
ユーザーがアプリケーション内でソーシャルネットワーク上の友達と対話できるようにするには、エクソラ側で友達データの保存を設定します:
- パブリッシャーアカウントに移動します。
- ログインブロックで開くをクリックして、ログインプロジェクトに移動します。
- ログインプロジェクトブロックで開きてセットアップするをクリックします。
- 一般設定 > 認証に移動します。
- ソーシャルネットワークからの友人を保存するトグルをオン>に切り替えます。
- 変更を保存します。
アプリケーション内のプレイヤーがソーシャルネットワークの友達を利用できるようにするには、以下のロジックをアプリケーションに実装します:
GetSocialNetworkAuthUrl
メソッドを使用して、ソーシャルネットワークをプレイヤーのアカウントにリンクします。Get URL to link social network to account APIコールはSDKメソッドと一緒に使用します。UpdateUserSocialFriends
メソッドを利用して友達リストを更新します。Update social account friends APIコールはSDKメソッドと一緒に使用します。GetUserSocialFriends
メソッドを利用して、リンクされたソーシャルネットワークから友達のリストを取得します。Get social account friends APIメソッドはSDKメソッドと一緒に使用します。
誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。