# Cross-Platform Identity Integration Guide

`CrossPlatformIdentityService` gives multiplayer systems one internal player ID
that can link Steam, PlayStation, Xbox, and Epic accounts. Platform-specific
usernames stay attached to their platform account, while the game shows a single
cross-platform display name.

## Core flow

1. Create the internal identity with `createIdentity()`.
2. Start an account link session with `startAccountLink()`.
3. Complete ownership verification with `completeAccountLink()`.
4. Store progression centrally with `saveProgression()`.
5. Verify platform ownership with `recordEntitlement()` and
   `verifyEntitlement()`.

The service accepts a `PlatformOwnershipVerifier`, so production integrations
can bind OAuth, platform SDK tokens, or backend ownership checks without
changing gameplay code.

## Merge and unlink

`mergeAccounts()` combines progression, inventory, achievements, linked
accounts, and ban records. `MergeConflictPolicy.MANUAL_REVIEW` leaves conflicts
for support staff instead of mutating either account.

`unlinkPlatformAccount()` removes a platform link while preserving central
progression and all remaining linked accounts.

## Social systems

- `listUnifiedFriends()` combines friends from every linked platform account.
- `createParty()`, `inviteToParty()`, and `acceptPartyInvite()` model
  cross-platform parties and lobbies.
- `createVoiceChannel()` returns a central voice-channel descriptor for parties
  that include players from platforms with incompatible native voice systems.
- `createMatchmakingTicket()` supports crossplay or platform-filtered tickets.

## Safety and compliance

Ban records live on the internal player identity, so bans apply across every
linked platform. Privacy tools support account export and deletion requests;
deletion removes platform index mappings and marks the identity as deleted.

## UI and admin models

The package does not render UI directly. It exposes render models:

- `createAccountLinkingFlowModel()` for account-linking screens.
- `createAdminModel()` for support dashboards covering linked accounts, bans,
  privacy requests, and merge/split actions.
