Skip to main content
指定されたタグをプレイヤー プロファイルに追加します。タグの名前空間は、タグのソースに基づいて自動的に生成されます。

構文

パラメーター

titleEntityHandle PFEntityHandle PFAuthenticationGetEntityWithSecretKeyAsync を使用して取得したタイトル エンティティの PFEntityHandle。 request PFSegmentsAddPlayerTagRequest* 値が設定されたリクエスト オブジェクト。 async XAsyncBlock*
Inout
非同期操作用の XAsyncBlock。

戻り値

型: HRESULT この API 操作の結果コード。

解説

この API は Win32、Linux、macOS で利用できます。この API は player_tag_added イベントをトリガーし、指定した TagName と PlayFabID を持つタグを対応するプレイヤー プロファイルに追加します。TagName はセグメンテーションに使用でき、256 文字までに制限されています。また、タイトルが保持できるタグの数にも制限があります。ServerGetPlayerTagsAsync、ServerRemovePlayerTagAsync も参照してください。XAsyncGetStatus を呼び出して操作のステータスを取得してください。サービス呼び出しが失敗した場合、非同期の結果は E_PF_PLAYER_TAG_COUNT_LIMIT_EXCEEDED またはグローバルな PlayFab サービス エラーのいずれかになります。エラー処理の詳細については、ドキュメント ページ「Handling PlayFab Errors」を参照してください。

要件

ヘッダー: PFSegments.h

関連項目

PFSegments のメンバー
最終更新日 2026年8月13日