獲取配音配置

說明

此接口僅適用於支持多配音的遊戲，用於根據當前 IP 獲取對應的配音配置；無此需求的遊戲可不接入此 API。

---

函數

- (void)gamedreamerGetVoiceConfigWithCompletion:(void (^)(NSString * _Nullable regionCode,
                                                          NSString * _Nullable voiceLanguage,
                                                          NSError * _Nullable error))completion;

---

參數

參數名	是否可為空（是/否）	說明
regionCode	是	成功時返回當前 IP 對應的地區代碼；失敗時為 nil。
voiceLanguage	是	成功時返回配音語言標識，可與 VoiceLanguageCantonese、VoiceLanguageMandarin 比對校驗；失敗時為 nil。
error	是	失敗時返回錯誤信息；成功時為 nil。

---

使用建議

• 請於登入成功後調用此接口。若尚未登入，SDK 將彈窗提示，且不會觸發 completion 回調。
• 若獲取配置失敗，建議調用方重試；若重試後仍失敗，請使用默認配音。
• 如需支持其他配音語言，請先聯絡技術人員確認。
• 成功獲取配音配置後，建議調用方緩存配置結果，後續無需重複調用此接口。

---

示例代碼

[GamedreamerManager.shareInstance gamedreamerGetVoiceConfigWithCompletion:^(NSString * _Nullable regionCode, NSString * _Nullable voiceLanguage, NSError * _Nullable error) {
    if (error) {
        NSLog(@"---獲取配音配置失敗：%@---", error);
        return;
    }

    if ([voiceLanguage isEqualToString:VoiceLanguageCantonese]) {
        NSLog(@"---使用粵語---");
    } else if ([voiceLanguage isEqualToString:VoiceLanguageMandarin]) {
        NSLog(@"---使用國語/普通話---");
    } else {
        NSLog(@"---如需支持其他配音語言，請聯絡技術人員確認---");
    }
}];