接入文档
FaceID基础版
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. 如果用户添加了对应的资源,但是资源不符合模板中约定的规则。使用用户提供的资源直接显示,不提示信息。

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