Skip to content

多语言最佳实践 ​

本文面向 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() 重新初始化;小游戏使用独立语言设置时,保留用户的选择。