> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PartyManager::CreateLocalUser

> ネットワーキングとチャットの操作を実行するときにローカル プレイヤーを表すために使用されるローカル ユーザー オブジェクトを作成します。

ネットワーキングとチャットの操作を実行するときにローカル プレイヤーを表すために使用されるローカル ユーザー オブジェクトを作成します。

## 構文

```cpp theme={null}
PartyError CreateLocalUser(  
    PartyString entityId,  
    PartyString titlePlayerEntityToken,  
    PartyLocalUser** localUser  
)  
```

### パラメーター

**`entityId`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)

ローカル ユーザーに関連付ける PlayFab エンティティ ID。

**`titlePlayerEntityToken`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)

ローカル ユーザーに関連付ける PlayFab エンティティ トークン。

**`localUser`**   [PartyLocalUser\*\*](/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser)\
*ライブラリによって割り当てられる出力*

出力するローカル ユーザー オブジェクト。

### 戻り値

PartyError

ローカル ユーザーの作成が成功した場合は `c_partyErrorSuccess`、それ以外の場合はエラー コード。エラー コードの人間が判読可能な形式は、[GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage) から取得できます。

## 解説

このメソッドは `entityId` として PlayFab エンティティ ID を、`titlePlayerEntityToken` として PlayFab エンティティ トークンを受け取ります。`entityId` の長さが `c_maxEntityIdStringLength` 以下であること以外に、これらの値に対する同期的な検証は行われません。ライブラリが、ネットワークの作成、ネットワークへの認証、音声テキスト変換の実行など、ユーザー認証や承認が必要な操作を実行するときに、Party サービスは、トークンが有効であり、有効期限が切れておらず、提供されたエンティティ ID に関連付けられており、その操作の実行を承認されていることを検証します。これらの条件が満たされていない場合、操作は失敗します。<br /><br /> PlayFab エンティティ ID とエンティティ トークンは、PlayFab ログイン操作の出力から取得でき、このメソッドへの入力として提供できます。PlayFab エンティティ ID は、`title_player_account` 型である必要があります。これは、ほとんどの開発者にとって、最も伝統的な意味での "プレイヤー" を表します。他のサポートされているエンティティ タイプを表すユーザーを作成するには、代わりに [CreateLocalUserWithEntityType()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype) を使用してください。   <br /><br /> 提供される `entityId` と `titlePlayerEntityToken` は、[Initialize()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize) に渡されたのと同じ Title ID を使用して取得されている必要があります。   <br /><br /> Party ライブラリは、[CreateNewNetwork()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork) や [PartyNetwork::AuthenticateLocalUser()](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser) のように、ローカル ユーザーの認証や承認が必要な後続の操作で使用するために、提供された PlayFab エンティティ トークンのコピーを作成します。この呼び出しに提供されたトークンが有効期限切れであるか、それ以外の場合に無効な場合、有効なトークンが必要な操作は失敗します。新しい有効なトークンは、[PartyLocalUser::UpdateEntityToken()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/methods/partylocaluser_updateentitytoken) を呼び出すことによって Party ライブラリに提供できます。   <br /><br /> このメソッドと PartyLocalUser::UpdateEntityToken() に提供されるエンティティ トークンの有効期限を監視するのは呼び出し元の責任です。トークンが有効期限に近づいているか、有効期限を過ぎた場合、PlayFab ログイン操作を実行して新しいトークンを取得し、PartyLocalUser::UpdateEntityToken() を呼び出して Party ライブラリに提供する必要があります。以前に提供したトークンが有効期間の半分に達したときに、新しいトークンを取得することをお勧めします。低電力状態に入る可能性があるプラットフォームや、アプリケーションが長時間実行を一時停止する可能性のあるプラットフォームでは、トークンの更新が期限切れになる前にできなくなる可能性があるため、実行が再開されたときにトークンの有効期限を確認する必要があります。   <br /><br /> 任意の時点で同時に存在できる PartyLocalUser オブジェクトは `c_maxLocalUsersPerDeviceCount` 個までです。別のローカル ユーザーを作成することでその制限を超える場合、このメソッドは同期的に失敗します。   <br /><br /> 正常に戻ると、このメソッドは、新しいユーザーを配列に同期的に追加するので、[GetLocalUsers()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getlocalusers) によって以前に返された配列のメモリを無効にします。[StartProcessingStateChanges()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges) も配列のメモリを無効にします。返される `localUser` オブジェクトは、[PartyDestroyLocalUserCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partydestroylocalusercompletedstatechange) が生成され、そのオブジェクトを参照するすべての状態変化が [FinishProcessingStateChanges()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_finishprocessingstatechanges) に返されるまで有効です。

## 要件

**ヘッダー:** Party.h

## 関連項目

[PartyManager](/services/playfab/multiplayer/networking/reference/classes/PartyManager/partymanager)\
[PartyDestroyLocalUserCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partydestroylocalusercompletedstatechange)\
[PartyManager::Initialize](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize)\
[PartyManager::GetLocalUsers](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getlocalusers)\
[PartyManager::CreateLocalUserWithEntityType](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype)\
[PartyManager::DestroyLocalUser](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_destroylocaluser)\
[PartyManager::CreateNewNetwork](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork)\
[PartyNetwork::AuthenticateLocalUser](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser)\
[PartyNetwork::RemoveLocalUser](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_removelocaluser)\
[PartyNetwork::CreateInvitation](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_createinvitation)\
[PartyNetwork::RevokeInvitation](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_revokeinvitation)\
[PartyNetwork::CreateEndpoint](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_createendpoint)\
[PartyLocalUser::UpdateEntityToken](/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/methods/partylocaluser_updateentitytoken)\
[PartyLocalDevice::CreateChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol)


## Related topics

- [PartyManager::CreateLocalUserWithEntityType](/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md)
- [PartyManager::GetLocalUsers](/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getlocalusers.md)
- [PartyLocalUser](/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser.md)
- [PartyManager::Initialize](/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md)
- [PartyLocalUser::UpdateEntityToken](/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/methods/partylocaluser_updateentitytoken.md)