Unity用SDK / ユーザー管理
 ドキュメントに戻る

Unity用SDK

  • 統合ガイド

  • デモプロジェクト

  • 認証

  • カタログ

  • 商品購入

  • 使用法

  • アプリケーションビルドガイド

  • トラブルシューティング

  • SDKバージョン1.0.0以降に移行する方法

  • ユーザー管理

    一般情報

    ユーザー管理ソリューションは、ログイン製品をベースにしています。ユーザーデータは、エクソラ、PlayFab、Firebase側、または独自のストレージに保存することができます。プロジェクトのストレージ設定は、ログインセクションのパブリッシャーアカウントで可能です。

    ユーザー属性

    属性を使用して、アプリケーションのユーザーに関する追加情報を管理できます。ユーザー属性は、キーと値のペアです。ゲームロジックやデータセキュリティの要件に応じて、アプリケーションのクライアント側またはサーバー側で属性の設定や編集を行うことができます。

    アトリビュートを使用して、以下のデータを保存することができます:

    • 名前とキャラクターの統計
    • ゲームの難易度
    • ボーナスを獲得するチャンス
    • ゲームキャラクターのキーパラメータ
    • ユーザーカテゴリ
    • その他

    ユーザー属性の扱い方

    この記事は役に立ちましたか?
    ありがとうございます!
    改善できることはありますか? メッセージ
    申し訳ありません
    この記事が参考にならなかった理由を説明してください。 メッセージ
    ご意見ありがとうございました!
    あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
    非表示

    ユーザーアカウントと友達システム

    ユーザーは、自分のユーザーアカウントで個人プロファイルデータと公開プロファイルデータを構成できます。

    友達システムにより、ユーザーはお互いを見つけ、社会的なつながりをセットアップすることができます。友達システムを実装するには、アプリケーションにユーザーアカウント機能を持たせる必要があります。

    この記事は役に立ちましたか?
    ありがとうございます!
    改善できることはありますか? メッセージ
    申し訳ありません
    この記事が参考にならなかった理由を説明してください。 メッセージ
    ご意見ありがとうございました!
    あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
    非表示

    クロスプラットフォームでのアカウントリンク

    異なるプラットフォームのプレーヤーのアカウントをメインアカウントにリンクすることにより、次の機能を実装できます:

    • 異なるプラットフォームでのプレーヤーの自動識別
    • 異なるプラットフォームで単一のクロスプラットフォームインベントリを管理する

    この記事は役に立ちましたか?
    ありがとうございます!
    改善できることはありますか? メッセージ
    申し訳ありません
    この記事が参考にならなかった理由を説明してください。 メッセージ
    ご意見ありがとうございました!
    あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
    非表示

    ハウツー

    高度な設定については、ハウツーをご覧ください。

    ユーザー属性の扱い方

    属性を使用して、アプリケーションのユーザーに関する追加情報を管理することができます。ユーザー属性は、キーと値のペアです。SDKは、以下のタイプの属性をサポートしています:

    • ユーザーが使用可能な属性。このタイプの属性の値は、ユーザーによって入力されるか、クライアント側のゲーム内ロジックに従って指定されます。例:名前やキャラクターの属性、ゲームの難易度など。

    • 読み出し専用の属性。このタイプの属性の値は、アプリケーションのサーバー側で入力して編集します。あまり変更する必要のないゲームキャラクターのステータスやユーザーのパラメータの設定に使用することをお勧めします。例:ボーナス獲得のチャンス、ゲームキャラクターキーパラメータ、ユーザーのカテゴリなどに使用します。

    ユーザー属性を管理するには、以下のSDKメソッドを使用します:

    • GetUserAttributes — ユーザー属性のリストを取得します。
    • UpdateUserAttributes — ユーザー属性の値を更新します。
    • RemoveUserAttributes — 指定されたIDのユーザー属性を削除すると、サーバー側で変更が行われます。

    読み出し専用属性を使用する場合は、サーバートークンまたはパブリッシャーアカウントトークンを使用して認証を行うことができます。

    パブリッシャーアカウントトークンを取得するには

    1. パブリッシャーアカウントを入力します。
    2. ブラウザの開発者ツールを使って、クッキーファイルの表示ページに移動します。
    3. pa-v4-tokenパラメーターから値をコピーしてAuthorizationヘッダーに貼り付けます。

    この記事は役に立ちましたか?
    ありがとうございます!
    改善できることはありますか? メッセージ
    申し訳ありません
    この記事が参考にならなかった理由を説明してください。 メッセージ
    ご意見ありがとうございました!
    あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
    非表示

    アプリケーションでユーザーアカウントを使用する方法

    ユーザーは、ユーザーアカウントから以下のデータを設定することができます:

    • 公開されたプロフィールデータ:
      • アバター
      • ニックネーム

    • 個人ユーザーデータ:
      • 名前と苗字
      • 誕生日
      • 性別
      • 電話番号
      • メール

    お知らせ
    追加のユーザーパラメータを設定したり、ゲームキャラクターのパラメータを設定したりするには、ユーザー属性を使用する方法についての説明書を使用してください。アプリケーションに友達システムが実装されている場合は、ユーザーアカウントにフレンドリスト管理機能を追加することができます。

    APIコールを使ってユーザーアカウントを管理することができます。SDKには以下のメソッドが実装されています:

    • GetUserInfo — ユーザーデータを更新します。

    お知らせ
    ユーザーは生年月日を一度だけ設定することができます。入力された値は後から変更できません。

    • UpdateUserInfo — 指定されたユーザーデータを変更します。
    • GetUserPhoneNumber — ユーザーの電話番号を更新します。
    • UpdateUserPhoneNumber — ユーザーの電話番号を更新します。
    • DeleteUserPhoneNumber — ユーザーの電話番号を削除します。
    • UploadUserPicture — ユーザーのアバターを変更します。
    • DeleteUserPicture — ユーザーのアバターを削除します。

    この記事は役に立ちましたか?
    ありがとうございます!
    改善できることはありますか? メッセージ
    申し訳ありません
    この記事が参考にならなかった理由を説明してください。 メッセージ
    ご意見ありがとうございました!
    あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
    非表示

    アプリで友達システムを使う方法

    友達システムを使用すると、ユーザーがお互いを見つけたり、ソーシャルコネクションを設定したりすることができます。SDKは以下の機能をサポートしています:

    • ニックネームで探す
    • ソーシャルネットワークから友達のリストを取得する
    • 友達リストを管理、招待状を送信、友達を追加と削除、ユーザーをブロックするなど
    • ユーザーアカウントによる個人情報を管理する

    友達システムを実装するには、アプリケーションにユーザーアカウントの機能を持たせる必要があります。このシステムでの作業方法は、ユーザーアカウントから以下のパラメータを使用します:

    • ユーザーID
    • アバター
    • ニックネーム

    友達システムが正常に動作するためには、ユーザーがニックネームを指定する必要があります。以下のニックネーム指定ロジックを実装してください:

    • ログインとパスワードで登録した名前をニックネームとして使用してください。
    • ソーシャル認証やプラットフォームアカウントでのニックネーム要求を実装してください。

    SDKメソッド

    SDKには、フレンドシステムとの連携方法として、以下の方法があります:

    • GetUserFriends — ローカルにキャッシュされたユーザーフレンドデータを更新します。

    • UpdateUserSocialFriends — ユーザーのソーシャルコネクションのステータスを更新します。ソーシャルコネクションのステータスは、以下の動作によって影響を受けます:
      • 友達申請の送信と取り消し
      • 友達申請の受諾と拒否
      • 友達リストからユーザーの削除
      • ユーザーのブロックまたはブロック解除

    • GetUserSocialFriends — ユーザーの友人のデータをソーシャルネットワークから更新します。

    • GetPublicInfo — ユーザーの公開プロフィールからデータを取得します。

    • SearchUsers — ニックネームでユーザーを検索します。

    • LinkSocialProvider — ユーザーアカウントと、プレイヤーが認証に使用するソーシャルネットワークをリンクします。

    • GetLinkedSocialProviders — ソーシャルネットワークにリンクされたリストを取得します。

    ソーシャルネットワークの友達システムの実装

    ユーザーがアプリケーション内でソーシャルネットワーク上の友達と対話できるようにするには、エクソラ側で友達データの保存を設定します:

    1. パブリッシャーアカウントに移動します。
    2. ログインブロックで開くをクリックして、ログインプロジェクトに移動します。
    3. ログインプロジェクトブロックで開きてセットアップするをクリックします。
    4. 一般設定 > 認証に移動します。
    5. ソーシャルネットワークからの友人を保存するトグルをオン>に切り替えます。
    6. 変更を保存します。

    ソーシャルネットワークの友達をアプリケーション内のプレーヤーが利用できるようにするには、以下のロジックをアプリケーションに実装します:

    1. GetSocialNetworkAuthUrlを使用してソーシャルネットワークをプレイヤーのアカウントにリンクします。
    2. UpdateUserSocialFriendsを使用して友達リストを更新します。
    3. GetUserSocialFriendsを使用してリンクされたソーシャルネットワークの友達リストを取得します。

    この記事は役に立ちましたか?
    ありがとうございます!
    改善できることはありますか? メッセージ
    申し訳ありません
    この記事が参考にならなかった理由を説明してください。 メッセージ
    ご意見ありがとうございました!
    あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
    非表示
    最終更新日: 2022年4月28日

    誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。

    問題を報告する
    当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
    フォローアップ用のメールをご提供してください
    ご意見ありがとうございました!