> For the complete documentation index, see [llms.txt](https://assetstore.essentialkit.voxelbusters.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://assetstore.essentialkit.voxelbusters.com/features/task-services/playmaker.md).

# PlayMaker

Use Task Services to get a short background execution window when your app is being suspended (ex: user presses Home). This is best for quick critical work (save state, finish a small upload, cleanup).

## Actions (4)

* `TaskServicesStartTaskAndAllowInBackground`: Start background allowance and get a `taskId` (also exposes an optional quota-expiry event).
* `TaskServicesCancelTask`: End the allowance when your work is done.
* `TaskServicesGetError`: Read cached error details after a start failure event.
* `TaskServicesCancelTaskGetError`: Read cached error details after a cancel failure event.

## Key pattern

1. Start: `TaskServicesStartTaskAndAllowInBackground` → store `taskId`.
2. Do work in the next state(s).
3. End: `TaskServicesCancelTask` (pass `taskId`, or leave empty to use `TaskServicesUtils.LastTaskId`).

## Notes

* iOS background time is limited (often around \~30 seconds). Keep work short and always handle quota expiry.
* Use `quotaWillExpireEvent` (on `TaskServicesStartTaskAndAllowInBackground`) as a Global Transition if you need an emergency “save minimal” path.

## Use cases

Start here: `use-cases/README.md`