Skip to content

iCloudKeyValueStore

FengYan枫炎 edited this page Jun 30, 2025 · 4 revisions

iCloudKeyValueStore

iCloudKeyValueStore 是一个基于 iCloud 的键值存储服务,可以用来存储一些简单的键值对数据,这些数据会自动同步到 iCloud 上,可以在多个设备之间共享。

配置

  1. 在Xcode中打开项目,选择项目的target,点击“Signing & Capabilities”选项卡,点击“+ Capability”按钮,选择“iCloud”。
  2. 勾选“Key-value storage”选项。

建议在Unity中编写脚本以在打包Xcode时自动配置

方法

void Initialize()

初始化iCloudKeyValueStore,不需要显式调用,当调用类中的其他方法时会自动初始化。

bool IsICloudAvailable()

判断当前设备iCloud是否可用

  • 返回值:是否可用

bool ContainsKey(string key)

判断当前iCloud是否包含键

  • key – 要判断的key
  • 返回值:是否包含键

bool DeleteKey(string key)

删除Key

  • key – 要删除的key
  • 返回值:是否删除成功

bool Synchronize()

强制同步iCloud云存档至Apple服务器

  • 返回值:是否同步成功
  • 注意:iCloudKeyValueStore会自动同步数据,不需要手动调用此方法

bool ClearICloudSave()

清除iCloud存档

  • 返回值:是否清除成功

string GetString(string key, string defaultValue)

从iCloud读取String值

  • key – 要读取的key
  • defaultValue – 默认值
  • 返回值:读取到的值

bool SetString(string key, string value)

保存String值到iCloud

  • key – 要保存的key
  • value – 要保存的值
  • 返回值:是否保存成功

int GetInt(string key, int defaultValue)

从iCloud读取Int值

  • key – 要读取的key
  • defaultValue – 默认值
  • 返回值:读取到的值

bool SetInt(string key, int value)

保存Int值到iCloud

  • key – 要保存的key
  • value – 要保存的值
  • 返回值:是否保存成功

float GetFloat(string key, float defaultValue)

从iCloud读取Float值

  • key – 要读取的key
  • defaultValue – 默认值
  • 返回值:读取到的值

bool SetFloat(string key, float value)

保存Float值到iCloud

  • key – 要保存的key
  • value – 要保存的值
  • 返回值:是否保存成功

bool GetBool(string key, bool defaultValue)

从iCloud读取Bool值

  • key – 要读取的key
  • defaultValue – 默认值
  • 返回值:读取到的值

bool SetBool(string key, bool value)

保存Bool值到iCloud

  • key – 要保存的key
  • value – 要保存的值
  • 返回值:是否保存成功
Clone this wiki locally