# Save Player Progress to Cloud

## Goal

Save player progress (level, score, settings) to iCloud or Google Play Games cloud storage for cross-device sync.

## Actions Required

| Action                   | Purpose                 |
| ------------------------ | ----------------------- |
| CloudServicesSetValue    | Save data to cloud      |
| CloudServicesSynchronize | Trigger sync with cloud |

## Variables Needed

* currentLevel (Int)
* totalScore (Int)
* playerName (String)

## Implementation Steps

### 1. State: SaveData

**Action:** CloudServicesSetValue (call multiple times for different keys)

* **Save Level:**
  * key: "player\_level"
  * value: currentLevel (Int)
* **Save Score:**
  * key: "total\_score"
  * value: totalScore (Int)
* **Save Name:**
  * key: "player\_name"
  * value: playerName (String)

**Transition:** Go to Synchronize

### 2. State: Synchronize

**Action:** CloudServicesSynchronize

* **Events:**
  * successEvent → ShowSaveSuccess
  * failureEvent → ShowSyncError

## Save Flow

```
SaveData
    ├─ SetValue("player_level", 10)
    ├─ SetValue("total_score", 5000)
    └─ SetValue("player_name", "Player1")
└─ Synchronize
    ├─ successEvent → ShowSaveSuccess
    └─ failureEvent → ShowSyncError
```

## Common Issues

* **Cloud Not Available**: User not signed into iCloud/Google account
* **Sync Delays**: Changes may take seconds to propagate
* **Data Conflicts**: Handle OnSavedDataChange for conflicts
* **Storage Limits**: iCloud limited to \~1MB per key

## Platform Differences

**iOS (iCloud):**

* Requires iCloud capability enabled
* User must be signed into iCloud
* Automatic sync when online

**Android (Google Play Games):**

* Saved Games API
* User must be signed into Google Play
* Manual sync trigger recommended

## Best Practices

1. **Save on Events**: Save after meaningful progress (level complete, achievement)
2. **Don't Over-Sync**: Batch changes, sync once per session or on pause
3. **Handle Conflicts**: Listen to OnSavedDataChange for remote updates
4. **Test Offline**: Verify data queues for sync when back online