IAchievementLibraryProgressCapability · LaunchBox Contributors

IAchievementLibraryProgressCapability14.1

public interface IAchievementLibraryProgressCapability

Supplies account-wide game progress without downloading every achievement definition.

Methods

GetLibraryProgressAsyncRetrieves game summaries for exactly the requested account and modes; never substitutes another context.

GetLibraryProgressAsync

Task<IReadOnlyList<AchievementProgress>> GetLibraryProgressAsync(
    IReadOnlyCollection<AchievementProgressContext> contexts,
    CancellationToken cancellationToken
)

Retrieves game summaries for exactly the requested account and modes; never substitutes another context.

contexts: A nonempty collection of captured contexts for one account with distinct modes, including any execution connection handles.

cancellationToken: Cancels retrieval.

Returns

Progress for the complete library in the requested contexts, with at most one entry per game and context. Providers must throw on partial pagination, unavailable or unsupported contexts, or account changes so hosts retain saved values. An empty result confirms an empty library; it must not represent failure. Summary-only entries supply counts with no individual observations and set AchievementProgress.IsSnapshotComplete to false; library coverage is independent of per-game detail coverage.