$res - 资源管理器#

• 更新时间:2025-12-13 11:58:46

资源管理器

针对脚本引擎设计的资源管理器，方便存储和读取资源，支持跨线程访问，在对于一些大型项目中，可以起到非常好的维护效果。

创建(名称)#

创建一个资源对象

• 参数 : 名称 {字符串} 应用名称,决定了资源文件存放的位置

• 返回 : {AgRes} 资源对象

• 版本 : 1.6.9

定义 资源 = $资源.创建("我的资源");

设置(名称, 数据)#

设置一个资源

• 参数 : 名称 {字符串} 资源名称

• 参数 : 数据 {object} 资源数据,就是js对象,可以直接把js对象存入进来,用的时候打点调用即可

• 版本 : 1.6.9

//(1)创建资源对象(指定名称)
定义 资源 = $资源.创建("我的资源");
//(2)添加资源
资源.设置("名字","张三");

获取(名称)#

获取资源

• 参数 : 名称 {字符串} 资源名称

• 返回 : {object} 资源数据

• 版本 : 1.6.9

//(1)创建资源对象(指定名称)
定义 资源 = $资源.创建("我的资源");
//(2)添加资源
资源.设置("名字","张三");
//(3)获取资源
日志(资源.获取("名字"));

获取(名称, 默认值)#

获取资源

• 参数 : 名称 {字符串} 资源名称

• 参数 : 默认值 {字符串} 默认值

• 返回 : {字符串} 资源值

• 版本 : 1.6.9

//如果本身就不存在数据，就会返回默认值
定义 数据 = $资源.获取("姓名","张三");

获取(名称, 默认值)#

获取资源

• 参数 : 名称 {字符串} 资源名称

• 参数 : 默认值 {小数} 默认值

• 返回 : {小数} 资源值

• 版本 : 1.6.9

//如果本身就不存在数据，就会返回默认值
定义 数据 = $资源.获取("派",3.14);

获取(名称, 默认值)#

获取资源

• 参数 : 名称 {字符串} 资源名称

• 参数 : 默认值 {整数} 默认值

• 返回 : {整数} 资源值

• 版本 : 1.6.9

//如果本身就不存在数据，就会返回默认值
定义 数据 = $资源.获取("年龄",18);

获取(名称, 默认值)#

获取资源

• 参数 : 名称 {字符串} 资源名称

• 参数 : 默认值 {布尔值} 默认值

• 返回 : {布尔值} 资源值

• 版本 : 1.6.9

//如果本身就不存在数据，就会返回默认值
定义 是个男孩 = $资源.获取("性别",真);
如果(是个男孩){
    日志("我是男孩");
}

加载(路径)#

加载本地资源到内部存储中

本质上就是把sdcard下的资源文件拷贝到内部存储中

• 参数 : 路径 {字符串} 本地资源路径,可以是相对路径,但前提是文件必须要存在

• 返回 : {布尔值} 是否加载成功

• 版本 : 1.6.9

//先准备数据名称
定义 资源 = $资源.创建("我的资源");
//加载数据到应用内部存储空间中(导入时不会添加.res后缀名,所以要写全文件名)
资源.加载("/数据.res");//sdcard/当前项目/数据.res
//看看数据
日志(资源.查看());

罗列()#

列出所有资源名称

• 返回 : {字符串列表} 资源名称列表

• 版本 : 1.6.9

//(1)创建资源对象(指定名称)
定义 资源 = $资源.创建("我的资源");
//(2)查询所有资源名称
定义 资源列表 = 资源.罗列();
日志(资源列表);

查看()#

查看当前资源内容

本质上是将存储的js对象转换成格式化美化后的json字符串

• 返回 : {string} 资源内容

• 版本 : 1.6.9

//(1)加载资源对象(指定名称)
定义 资源 = $资源.创建("我的资源");
//(2)获得资源内容
定义 内容 = 资源.查看();
提示("资源内容", 内容);

下载(保存路径)#

导出资源

本质上是将内部存储的数据拷贝到指定路径下

• 参数 : 保存路径 {字符串} 导出路径,可以使用相对路径,文件可以不存在,如果文件存在,则会覆盖

• 返回 : {字符串} 导出路径

• 版本 : 1.6.9

//先准备一点数据
定义 资源 = $资源.创建("我的资源");
资源.设置("人", {
    姓名: "张三",
    年龄: 16
});
//下载资源到当前项目的文件夹下(会自动添加.res后缀名)
资源.下载("/数据");//sdcard/当前项目/数据.res