前言:本篇文章是有关于ssRender引擎1.5新版本中多语言功能的详细介绍,通过一个实际演示案例,来帮助大家更快速的了解并掌握ssRender引擎多语言的使用方法!
简介:ssRender支持多种语言,实现方式通过自带的多语言工具,使用方法简单且高效,多语言工具通过创建多个表格来存储不同语言的字符串。表格可以建立不同语言之间的对应关系,用户只需要根据自己的语言偏好和项目需求配置语言表就能快速地实现语言转译(切换)功能。
一:多语言功能使用方式
本小节将会介绍如何配置多语言
(一)语种的添加与删除
首先点击ssRender Editor工具端按钮区的多语言按钮
在弹出的翻译窗口中,点击添加语种,编辑语种的标识(如下图,想要增加中文,将中文标识记为"Chinese",也可以是"中文",甚至还可以是"Lan_CH",无硬性要求,与其他语言有区分度即可);之后点击确定按钮,即可新增语种。
注意:在工具端以某种方式更改了某文言对应的语种后,源文言将不再显示,默认替换为对应语种的文言。且新增的语种,以索引为0开始,按照新增顺序分配索引。
删除语种时,需要先选中将要删除的语种,点击"删除语种"按钮,在弹出的消息框中点击"确定"即可对语种进行删除。(注意:删除语种时,会默认保留源文言和一个自定义的语种存在(源文言不可删除);当自定义语种数目不支持删除时,会有额外的消息提醒)
(二)文言同步、导入功能
点击"翻译"窗口的"同步"按钮,在新弹出的"收集"窗口中点击"收集"按钮,就能自动搜索当前工程下的全部"Text"节点,将其源文言和路径进行显示,可以选中想要翻译(转译为其他语言)的文言,点击保存。
其中不同颜色的文言代表不同含义:
黑色:代表该文言已导入到多语言表中;
蓝色:代表该文言已被选中;
红色:代表该文言未被选中,且未导入多语言表。
保存成功后,在"翻译"界面中,点击"导入"按钮,即可将上一步骤中选中的文言添加成功。在该文言不同语种框中编辑对应转译后的文言即可。
(三)添加文言和删除文言
除了(二)中的导入功能,能够添加工程中已存在的Text文言之外;我们同样可以添加自定义文言的key和跟它不同语种所对应的翻译文言。
点击添加文言,编写原文言,以及其想要对应的不同语种的翻译文言,点击保存,结束添加。
删除同理
二:多语言的应用
本小节将会介绍如何应用我们在第一小节的配置好的多语言。
(一)设置语种 tr_setLanType:
第一小节中(一)部分,介绍过不同语种将会根据添加的先后顺序,进行索引值的index分配;我们可以通过Touch的click事件,或者PropertyChange事件,去调用tr_setLanType : 具体index值,实现语种的切换。
如下图,切换英文的按钮中的脚本表达式,设置语种index为0(如上图,英文排在第一位置,故索引为0)
切换中文的按钮同理,将英文索引值0改为中文索引值1;
即可实现如下效果:在点击按钮时,同步切换对应文言的语种。
我们同样也可以在PropertyChange中使用该脚本去改变文言的语种!
(二)获取文言tr_get : "string"
首先,我们在翻译窗口下点击添加文言
添加后保存,在工程文件里新建一个Text节点,将Text节点的Text属性添加绑定,脚本表达式中使用tr_get: 方法。绑定刚才新加的文言。如下图所示:
就能将刚才新建的文言与Text节点进行绑定,显示效果如下
并且能够根据tr_setLanType与其他文言一起试试转换;
注意:本文言并不是从工程文件中同步/收集/导入的,
而是自定义手动添加的key,大家可以在某一个 key 对应一个文言时且 key 值有一定规律时可参考
使用。比如根据不同的消息数,显示不同的信息(如下)
我们添加了三条文言,代表消息
根据消息的标识数字,获取对应的文言
最终我们可以通过控制WarnNum参数,快速地控制消息提示(如下图)
(三)字符串替换
此功能可以更改我们编辑好的文言,在中间穿插一些额外的值,如下图
在多语言表中的年月日前方需要有动态替换,就应用到了此功能
如上图,在需要动态替换处添加参数:关键字+数字,例如:+数字,
例如:1,$$2,…
在文言对应的Text节点的Text属性添加绑定表达式:tr_get获取文言,红色方框处设置动态替换
三个属性值自动循环增长
得到最终的显示效果:
注意:对应的中文文言处,添加了"\n",代表换行的意思。
小结:本篇文章详细介绍了ssRender引擎的多语言功能的使用方法,相比较而言,只需要在ssRender Editor工具端进行简单操作即可,不用编写复杂的代码或者配置繁琐的插件,学习使用起来还是很易于上手的!之后本人会分享更多有关ssRender引擎相关的内容,若大家感兴趣,还请持续关注哦!