시스템 바 외관 설정 | 화면과 WebView | Appbox Android SDK 가이드

시스템 바 외관 설정

관리 화면의 상태바와 하단 내비게이션 바 배경색, 글자, 아이콘 밝기를 설정합니다. 관리 화면의 시스템 바를 서비스 테마에 맞출 때 호출합니다.

시스템 바 외관 설정

AppBox.setSystemBarAppearance(backgroundHex, style)

Kotlin
1 // 어두운 배경 + 자동 판정
2 AppBox.setSystemBarAppearance(backgroundHex = "#1F124C")
3
4 // 밝은 배경 + 어두운 글자
5 AppBox.setSystemBarAppearance("#FFFFFF", AppBoxSystemBarStyle.Dark)
6
7 // 배경은 유지하고 글자만 밝게
8 AppBox.setSystemBarAppearance(null, AppBoxSystemBarStyle.Light)
1 // 어두운 배경 + 자동 판정
2 AppBox.setSystemBarAppearance("#1F124C");
3
4 // 밝은 배경 + 어두운 글자
5 AppBox.setSystemBarAppearance("#FFFFFF", AppBoxSystemBarStyle.Dark);
6
7 // 배경은 유지하고 글자만 밝게
8 AppBox.setSystemBarAppearance(null, AppBoxSystemBarStyle.Light);

Request 항목 정의

Request 항목필수여부설명기본값
backgroundHex-#RRGGBB 또는 #AARRGGBB. 앞의 #은 생략 가능. null이면 배경을 변경하지 않음null
style-AppBoxSystemBarStyle. Auto, Light, Dark. 글자, 아이콘 기준Auto


style은 글자, 아이콘 기준입니다. 어두운 배경 → Light(흰 글자), 밝은 배경 → Dark(검은 글자). Auto는 배경색 밝기로 자동 결정합니다. backgroundHex = null은 "배경을 변경하지 않음"이며 style만 적용됩니다. 반환값, 콜백이 없으며 오류 전달이 없습니다. 관리 화면에만 적용되고, start 후 호출하면 표시 중인 화면에 즉시 반영됩니다.

잘못된 색상값을 전달하면 호출 전체가 무시됩니다. 배경색과 style 모두 이전 값을 유지합니다. 3자리 색상값과 색상 이름은 사용할 수 없습니다.

www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.