본문으로 건너뛰기

SDK 커스터마이징

Test Solution SDK는 Host 앱의 디자인과 일관된 사용자 경험을 제공할 수 있도록 몇 가지 UI 커스터마이징 옵션을 지원합니다. startTest 함수에 파라미터를 추가하여 간단하게 SDK의 테마, 색상, 타이틀을 변경할 수 있습니다.

테마 모드 설정 (themeMode)

SDK UI의 전체적인 테마를 라이트 모드 또는 다크 모드로 설정할 수 있습니다. 사용자의 시스템 설정을 따르거나 Host 앱의 현재 테마에 맞게 지정할 수 있습니다.

  • 'light': 라이트 모드로 설정합니다.
  • 'dark': 다크 모드로 설정합니다.
  • 미지정 시: 사용자의 시스템 설정 값을 따릅니다.
라이트 모드다크 모드
라이트 모드다크 모드

예제 코드

Android (Kotlin)

// 다크 모드로 SDK 실행하기
val options = mapOf(
"goodsId" to "[GOODS_ID]",
"suid" to "[SUID]",
"language" to "[LANGUAGE]",
"themeMode" to "dark" // "light" 또는 "dark" 또는 "system"
)
channel.invokeMethod("startTest", options)

iOS (Swift)

// 다크 모드로 SDK 실행하기
let options: [String: Any] = [
"goodsId": "[GOODS_ID]",
"suid": "[SUID]",
"language": "[LANGUAGE]",
"themeMode": "dark" // "light" 또는 "dark" 또는 "system"
]
channel.invokeMethod("startTest", arguments: options)

메인 색상 변경 (themeColor)

SDK의 주요 UI 요소(예: 버튼, 유저 채팅 말풍선 등)에 적용될 메인 색상을 지정할 수 있습니다. Host 앱의 브랜드 컬러와 통일하여 일체감을 줄 수 있습니다.

  • 형식: 숫자형. 0xAARRGGBB (Alpha, Red, Green, Blue)를 사용합니다.
  • 예시: 0xFF00DDCC (불투명한 청록색)
  • 미지정 시: SDK에 설정된 기본 색상이 사용됩니다.
기본 테마 색상커스텀 색상 적용
기본 테마 색상커스텀 색상 적용

예제 코드

Android (Kotlin)

// 메인 색상을 0xFF7E57C2 (보라색 계열)로 변경하기
val options = mapOf(
"goodsId" to "[GOODS_ID]",
"suid" to "[SUID]",
"language" to "[LANGUAGE]",
"themeColor" to 0xFF7E57C2
)
channel.invokeMethod("startTest", options)

iOS (Swift)

// 메인 색상을 0xFF7E57C2 (보라색 계열)로 변경하기
let options: [String: Any] = [
"goodsId": "[GOODS_ID]",
"suid": "[SUID]",
"language": "[LANGUAGE]",
"themeColor": 0xFF7E57C2
]
channel.invokeMethod("startTest", arguments: options)

타이틀 텍스트 변경 (titleText)

SDK 화면 상단에 표시되는 타이틀 텍스트를 원하는 문구로 변경할 수 있습니다.

  • 미지정 시: 'Career Counseling' 와 같은 기본 타이틀이 표시됩니다.
기본 타이틀커스텀 타이틀
기본 타이틀커스텀 타이틀

예제 코드

Android (Kotlin)

// 타이틀을 '나의 성향 알아보기'로 변경하기
val options = mapOf(
"goodsId" to "[GOODS_ID]",
"suid" to "[SUID]",
"language" to "[LANGUAGE]",
"titleText" to "나의 성향 알아보기"
)
channel.invokeMethod("startTest", options)

iOS (Swift)

// 타이틀을 '나의 성향 알아보기'로 변경하기
let options: [String: Any] = [
"goodsId": "[GOODS_ID]",
"suid": "[SUID]",
"language": "[LANGUAGE]",
"titleText": "나의 성향 알아보기"
]
channel.invokeMethod("startTest", arguments: options)

✨ 종합 예제

모든 커스터마이징 옵션을 함께 사용하여 Host 앱에 최적화된 모습으로 SDK를 실행할 수 있습니다.

Android (Kotlin)

// 다크 모드, 브랜드 컬러, 커스텀 타이틀을 모두 적용
val options = mapOf(
"goodsId" to "[GOODS_ID]",
"suid" to "[SUID]",
"language" to "[LANGUAGE]",
"themeMode" to "dark",
"themeColor" to 0xFFFF8A65, // 오렌지 계열
"titleText" to "AI가 분석하는 나의 성격은?"
)
channel.invokeMethod("startTest", options)

iOS (Swift)

// 다크 모드, 브랜드 컬러, 커스텀 타이틀을 모두 적용
let options: [String: Any] = [
"goodsId": "[GOODS_ID]",
"suid": "[SUID]",
"language": "[LANGUAGE]",
"themeMode": "dark",
"themeColor": 0xFFFF8A65, // 오렌지 계열
"titleText": "AI가 분석하는 나의 성격은?"
]
channel.invokeMethod("startTest", arguments: options)