接入文档
APP接入
SDK集成
ios
多语言支持
多语言支持
# 多语言支持

设置语种

SDK初始化接口initMGFaceIDLiveDetectManagerWithBizToken:language:networkHost:extraData:error:增加语种参数和调用集群参数,SDK根据传入的语种设置language ,根据调用集群参数调用相应集群的服务。

参数按照Language codes-ISO 639标准传入,语种参数详见附录【 ISO 639-1语言列表】,调用集群参数见附录E【host取值列表】。

多语言资源补齐

在资源包中提供中文和英文的文本、图片、音频等资源的模板。用户如果需要支持新的语言,按照给定的模板内容创建对应语言的各资源文件。SDK会根据用户传入的语种参数在对应的资源文件夹下读取资源(默认语言为中文)。

多语言资源补齐步骤如下:

(1)添加语言

 a. 在MGFaceIDLiveDetectLanguageConfig.h 中在枚举中添加新的语言类型,并设置该语言对应的枚举数字。

 b. 在bundle/languageconfiguration.plist 中添加新的语言Item,填写该Item的type(String类型)、enum(Number类型)和mask(String类型)。

 注:**Item**的**type**需与**MGFaceIDLiveDetectLanguageConfig.h**中的语言类型一致,**enum**的值需与**MGFaceIDLiveDetectLanguageConfig.h**中枚举数字一致。

(2)添加该语言的语音资源

 在bundle/audio 下新建以该语言mask值命名的文件夹, 并按规则在文件夹下添加语音资源。语音资源列表见附录B【语音资源列表】.

(3)添加该语言的图片资源

 在bundle/image 下新建以该语言mask值命名的文件夹,并按规则在文件夹下添加图片资源。图片资源列表见附录C【图片资源列表】.

(4)添加该语言的文本资源

 在bundle/text 下新建以该语言mask值命名的文件夹,并在此文件夹下新建MGFaceIDDetection.strings文件,在文件中修改相应文案内容。文本资源列表见附录D【文本资源列表】.

资源异常情况说明

\1. 如果用户指定了新的语言,但是没有添加对应的资源,直接在编译阶段触发断言崩溃,同时提示错误信息:没有找到对应的资源(注:该断言会同时在debug模式和release模式同时触发,请务必按照资源列表需求完整添加所有资源)。
\2. 如果用户添加了对应的资源,但是资源不符合模板中约定的规则。使用用户提供的资源直接显示,不提示信息。

该文档未解决您的疑问?查看常见问题