자주 묻는 질문 (FAQ)

Test Solution SDK를 연동하고 사용하시면서 발생할 수 있는 주요 질문과 답변을 모았습니다. 문제가 해결되지 않는 경우, 트러블슈팅 가이드를 확인하거나 담당자에게 문의해 주세요.

---

연동 및 실행 관련

Q. SDK 실행 후 화면이 검게/하얗게만 나오고 아무것도 표시되지 않아요.

A. 가장 일반적인 초기화 문제입니다. 아래 사항들을 순서대로 확인해 보세요.

1. 필수 파라미터 확인: startTest 함수에 전달하는 goodsId, suid, language 값이 유효한지, 오타는 없는지 확인해 주세요. 해당 값들은 비어있지 않아야 합니다.
2. 인터넷 권한 확인: SDK는 서버와 통신하여 문항을 가져옵니다. Host 앱의 AndroidManifest.xml(Android) 또는 Info.plist(iOS)에 인터넷 사용 권한이 올바르게 설정되어 있는지 확인하세요.
3. 로그 확인: startTest 시 enableHostLogging: true 옵션을 추가하고, onLog 콜백을 통해 SDK 내부 로그를 확인해 보세요. 초기화 실패와 관련된 에러 로그가 수신될 수 있습니다.
4. 네이티브 설정 확인: Android 설정 및 iOS 설정 문서에 따라 네이티브 프로젝트 설정이 올바르게 완료되었는지 다시 한번 확인해 주세요.

Q. onResult 콜백이 전혀 호출되지 않아요.

A. 이 콜백은 주로 사용자와 상호작용이 발생했을때 호출됩니다. 다음 사항들을 참고해 주세요.

• 테스트 미완료: 사용자가 중간에 앱을 강제 종료하거나 이탈한 경우에는 콜백이 호출되지 않을 수 있습니다.
• 콜백 핸들러 등록 확인: Host 앱에서 onResult 이벤트를 수신하는 리스너(Listener) 또는 핸들러(Handler)가 올바르게 등록되었는지 확인해 주세요. 코드 예제는 콜백 처리하기 문서를 참고하세요.
• 에러 발생: 테스트 진행 중 네트워크 문제 등 예외적인 오류가 발생하면 콜백이 호출되지 않을 수 있습니다. onLog를 통해 에러 상황을 모니터링하는 것을 권장합니다.

Q. enableHostLogging: true로 설정했는데 Host 앱에서 로그가 보이지 않아요.

A. enableHostLogging 옵션은 SDK의 로그를 Host 앱의 onLog 콜백으로 전달하는 기능입니다. Android의 Logcat이나 iOS의 Console에 직접 출력하는 것이 아닙니다. onLog 콜백을 수신하여 Host 앱의 자체 로깅 시스템에 출력하도록 구현해야 합니다.

// Android (Kotlin) 예시
channel.setMethodCallHandler { call, result ->
    when (call.method) {
        // ...
        "onLog" -> {
            val logMap = call.arguments as? Map<String, Any>
            Log.d("TestSolutionSDK_LOG", "$logMap") // 디버그 로그 출력
        }
        // ...
    }
}

---

기능 및 데이터 관련

Q. 테스트 결과를 SDK에서 직접 받을 수 있나요?

A. 아니요, 불가능합니다.

Test Solution 의 정책상, 분석된 성격 유형 결과는 보안 및 사용자 경험의 일관성을 위해 SDK 를 통해 Host 앱으로 직접 전달되지 않습니다. 결과는 저희 시스템에서 취합 후, 사전에 정의된 방식(예: 사용자 이메일 발송)에 따라 별도로 전달됩니다.

onResult 콜백은 테스트가 **'완료'**되었다는 상태와 customData 같은 Passthrough 데이터만을 전달하는 용도로 사용됩니다.

Q. 특정 질문을 건너뛰거나, 질문 순서를 바꿀 수 있나요?

A. 아니요, 불가능합니다.

Test Solution 의 문항과 순서는 정확한 검사 결과를 위해 표준화된 로직에 따라 설계되었습니다. 따라서 Host 앱에서 임의로 문항 순서를 변경하거나 특정 문항을 건너뛰는 기능은 지원하지 않습니다.

---

커스터마이징 관련

Q. 테마 색상(themeColor)을 변경했는데 적용되지 않습니다.

A. 색상 값의 형식을 확인해 주세요. themeColor는 반드시 0xAARRGGBB (Alpha, Red, Green, Blue) 또는 0xRRGGBB (Red, Green, Blue) 형식의 숫자형이어야 합니다.

• 올바른 형식: 0xFF00DDCC, 0xFF00CC (O)
• 잘못된 형식: "#00DDCC" (X - 글자형이 아닙니다), 0xFBVZQT (X - 올바르지 않은 색상 값)

Q. 라이트/다크 모드가 시스템 설정과 다르게 동작합니다.

A. themeMode 파라미터를 사용하여 SDK의 테마를 직접 제어할 수 있습니다.

• 'light': 항상 라이트 모드로 동작합니다.
• 'dark': 항상 다크 모드로 동작합니다.
• 파라미터 미설정 시: 시스템(OS)의 테마 설정을 따라갑니다.

만약 Host 앱의 자체 테마 설정과 동기화하고 싶다면, Host 앱의 현재 테마 상태에 따라 themeMode 값을 동적으로 설정하여 startTest를 호출해야 합니다.