开发平台:Unity 2019版本以上
编程平台:Visual Studio 2019
编程语言:C#

一、什么是PlayerPrefs?


描述:在游戏会话之间存储玩家偏好。值得注意的是,PlayerPrefs 仅适用于配置与存储小体量的本地数据。若期望存储体量大的数据,应建议考虑 Json \ XML \ CSV \ TXT \ SQL 等数据文件。而非使用 PlayerPrefs !!!

二、各平台下的数据存储位置


  • Windows平台:HKCU\Software\[公司名称]\[产品名称]下注册表内
  • Linux平台:~/.config/unity3d/[公司名称]/[产品名称] 下注册表内
  • Windows应用商店程序:%userprofile%\AppData\Local\Packages\[产品包 ID]>\LocalState\playerprefs.dat
  • Windows Phone 8:应用程序的本地文件夹中
  • Android平台:/data/data/pkg-name/shared_prefs/pkg-name.xml
  • WebGL平台:浏览器的 IndexedDB API
  • iOS平台:/Library/Preferences/[Bundle ID].plist

三、静态函数方法


通用

  • DeleteAll():删除偏好中的所有键和值
  • DeleteKey():删除偏好中指定的键与其对应的值
  • HasKey():检查偏好设置中是否存储Key
  • Save():将修改的偏好存入磁盘中

关于 Get 系列
  一般情况下,只需 Get + 数据类型 获取匹配的键值即可,对于用法上有例如 GetSting(string key, string defaultValue) 的用法,意为如果没有 key 的值,返回一个默认值作为该 key 的值存储至本地注册表中。其效果等价于以下

public void Example() { 
	PlayerPrefs.SetString("Examlpe Key", "Hello PlayerPrefs");  
	var thisSTR = PlayerPrefs.GetString("Example Key") 
}
  • GetFloat():返回偏好设置中与key键对应的Float数据类型的值
  • GetInt():返回偏好设置中与key键对应的Int数据类型的值
  • GetString():返回偏好设置中与key键对应的String数据类型的值

关于 Set 系列

  • SetFloat():在偏好中,设置key键对应的Float数据类型的值
  • SetInt():在偏好中,设置key键对应的Int数据类型的值
  • SetString():在偏好中,设置key键对应的String数据类型的值

四、应用示例


  • PlayerPrefs适用于游戏的数据存储
    例如《愤怒的小鸟》存储玩家每局的最高分数,《俄罗斯方块》记录榜上前十的分数。
  • 记录用户的偏好设置
    例如 操控灵敏度,音量大小等

P1:一场游戏结束了,我们的数据有 玩家信息/玩家分数。

string playerName = "Mr.Doc";  //玩家名称
int t = 1008611;  //玩家游戏分数

P2:我们需要对数据进行存储,以便于下次重启游戏后,数据不会被重置。

  • 特别注意:每次建立键值时应注意使用PlayerPrefs.HasKey("键名")来判断是否已存在键值对象,否则新键值会覆盖原键值对象。
PlayerPrefs.SetString("Player01", playerName);
PlayerPrefs.SetInt("Goual", t);

P3:我们再次打开分数排行榜时,排行榜需要获取历史的最高纪录。

string name = PlayerPrefs.GetString("Player");
float goal = PlayerPrefs.GetInt("Goal");

P4:将这些值赋予至Text组件上即呈现结果。


  补充说明:对于排行榜多个历史纪录的排行,可选择Dictionary<键,值>对存储的键与值进行存储。进行快速排序获取前5名或更多。超出显示的部分可选择删除,或者Dictionary<键,值>只用于存储前几个最大,每次新数据产生,对立面的值进行比较,替换或挤出最低纪录。