多语言

强制指定语言

当需要在应用内提供语言切换入口、不跟随系统语言时，使用 setLanguage() 强制指定：

// 强制切换到英文（不再跟随系统语言）
PlayerLocale.setLanguage("en");

// 强制切换回中文
PlayerLocale.setLanguage("zh");

调用 setLanguage() 后，当前 Activity 会自动重建以使新语言生效。

新增语言支持

当需要新增 AliPlayerKit 尚未内置的语言（如日语、韩语）时，使用 Android 标准资源机制。新增后同样支持自动跟随系统语言。

1. 在应用模块中创建对应的资源目录。

   your-app/src/main/res/
   ├── values/strings.xml          ← 中文（默认）
   ├── values-en/strings.xml       ← 英文
   ├── values-ja/strings.xml       ← 新增：日语
   └── values-ko/strings.xml       ← 新增：韩语

2. 复制默认 values/strings.xml 并翻译全部条目。

   <!-- res/values-ko/strings.xml --><?xml version="1.0" encoding="utf-8"?><resources><string name="setting_item_speed">재생 속도</string><string name="setting_item_quality">화질</string><string name="setting_item_loop">반복 재생</string><string name="setting_item_mute">음소거</string><string name="player_brightness">밝기</string><string name="player_volume">볼륨</string><!-- ... 翻译所有条目 ... --></resources>

3. 使新语言生效。

   • 自动跟随系统：用户将系统语言设为韩语后，播放器文案自动切换，无需调用任何 API。

   • 强制指定：如需在应用内手动切换，调用 PlayerLocale.setLanguage("ko")。

监听语言变更

通过监听器感知语言切换，可用于刷新自定义 UI 或记录日志：

// 创建监听器
PlayerLocale.OnLanguageChangedListener listener = (oldLanguage, newLanguage) -> {
    Log.i(TAG, "Language changed: " + oldLanguage + " → " + newLanguage);
    // 刷新自定义 UI
    refreshMyCustomUI();
};

// 注册监听器
PlayerLocale.addOnLanguageChangedListener(listener);

// 不再需要时移除（如 Activity onDestroy）
PlayerLocale.removeOnLanguageChangedListener(listener);

文案查找机制

PlayerLocale.get() 通过 Android 标准资源机制获取当前语言对应的文案：

• 如果存在当前语言对应的 values-xx/strings.xml，则返回该文件中的翻译。

• 如果当前语言没有对应的资源目录，则回退到默认语言（中文 values/strings.xml）。

线程安全

语言切换机制

setLanguage() 内部使用 AppCompatDelegate.setApplicationLocales() 实现：

• Android 13+：系统原生支持 per-app language，无需特殊处理。

• Android 12 及以下：通过 createConfigurationContext 创建带正确 locale 的 Context。

• 调用后会触发当前 Activity 重建，UI 自动刷新。

版本兼容

选择合适的方案

注意事项

示例功能

运行示例

在 Demo App 中选择Locale示例查看效果。