多语言最佳实践
本文面向 App 接入方。小游戏侧的语言适配见小游戏多语言最佳实践。
1. 确定当前语言
优先使用用户在 App 内选择的语言;选择“跟随系统”时,使用 App 支持的系统语言。语言码使用 BCP 47 标签,例如 zh-CN、en-US。
App 自有加载页、菜单、弹窗等 UI,以及游戏信息查询、游戏启动和 getAppBaseInfo 回调,使用同一个当前语言。Android、iOS 保持一致。
2. 向小游戏提供语言
在已注册的 SUDOPWrappedClient(Android)或 SUDOPWrappedClientDelegate(iOS)中实现 getAppBaseInfo。SDK 调用该同步回调时,App 填入当前语言并保留其他已有字段。
以下以 zh-CN 为例,接入时替换为 App 当前语言。
Android:
java
@Override
public void getAppBaseInfo(JSONObject appInfo) {
try {
appInfo.put("language", "zh-CN");
} catch (JSONException e) {
throw new IllegalStateException(e);
}
}iOS:
objectivec
- (NSDictionary *)getAppBaseInfo {
return @{ @"language": @"zh-CN" };
}3. 配置游戏信息与加载页语言
查询游戏信息或启动游戏时,通过 language 参数指定当前 App 语言。以下使用已有的游戏 ID 和回调对象。
Android:
java
String language = "zh-CN";
SUDOP.getGameInformation(gameId, language, informationListener);
SUDOP.startGame(gameId, language, startListener);iOS:
objectivec
NSString *language = @"zh-CN";
[SUDOP getGameInformationWithGameID:gameID language:language completion:informationCompletion];
[SUDOP startGame:gameID
language:language
didGameViewCreated:viewCreated
didGameHandleCreated:handleCreated
progress:progress
completion:startCompletion];getAppBaseInfo 回调与启动接口的语言参数需要分别设置。App 展示游戏名、简介、图标、协议链接等多语言内容时,按语言键读取对应内容;缺失或为空时,读取 default 对应的默认内容。
4. 切换 App 语言
更新 getAppBaseInfo 回调使用的语言值,刷新 App UI 和相关展示缓存,并在后续查询、启动游戏时传入新语言。
与 CP 约定运行中小游戏的刷新时机,由 CP 刷新界面或调用 sud.restart() 重新初始化;小游戏使用独立语言设置时,保留用户的选择。
