보이스 설정 가져오기

설명

이 API는 여러 보이스를 지원하는 게임에만 적용되며, 현재 IP를 기준으로 해당 보이스 설정을 가져옵니다. 이 기능이 필요하지 않은 게임은 이 API를 연동하지 않아도 됩니다.

---

함수

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

---

파라미터

파라미터	Nullable 여부(예/아니요)	설명
regionCode	예	성공 시 현재 IP에 해당하는 지역 코드를 반환하며, 실패 시 nil입니다.
voiceLanguage	예	성공 시 보이스 언어 식별자를 반환합니다. VoiceLanguageCantonese 또는 VoiceLanguageMandarin과 비교하여 검증할 수 있으며, 실패 시 nil입니다.
error	예	실패 시 오류 정보를 반환하며, 성공 시 nil입니다.

---

사용 권장 사항

• 로그인 성공 후 이 API를 호출하세요. 아직 로그인하지 않은 경우 SDK가 팝업을 표시하며 completion 콜백을 트리거하지 않습니다.
• 설정 가져오기에 실패하면 호출 측에서 재시도하는 것을 권장합니다. 재시도 후에도 실패하면 기본 보이스를 사용하세요.
• 다른 보이스 언어를 지원해야 하는 경우 먼저 기술 지원 담당자에게 문의하여 확인하세요.
• 보이스 설정을 성공적으로 가져온 후에는 호출 측에서 결과를 캐시하고 이 API를 반복해서 호출할 필요가 없습니다.

---

예시 코드

[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(@"---다른 보이스 언어 지원이 필요한 경우 기술 지원 담당자에게 문의하세요---");
    }
}];