Android 대기실 상태바 설정

대기실 상태바 설정 가이드는 NetFUNNEL Android 에이전트에서 대기실(WebView)의 상태바 옵션에 대해 설명합니다.

---

1. statusBarStyle

statusBarStyle은 NetFUNNEL Android 에이전트에서 대기실(WebView) 표시 시 상태바 스타일 및 아이콘 색상을 제어하는 파라미터입니다.

parameter	type	설명
statusBarStyle	String	대기실의 상태바 옵션

1.1 기본값 (미설정 또는 null)

앱의 기본 테마를 따르며, FullScreen은 적용되지 않습니다.

기본값	설명
null	상태바 그대로 노출

1.2 옵션값

옵션값 설정 시 FullScreen 모드가 적용되며 상태바가 투명하게 처리됩니다.

옵션값	설명
auto	라이트 모드일 경우 아이콘은 검정색, 다크 모드일 경우 흰색으로 자동 설정
black	아이콘 색상을 항상 검정색으로 고정
white	아이콘 색상을 항상 흰색으로 고정

---

2. statusBarStyle 사용

statusBarStyle을 사용하려면, 초기화 함수 호출 시 아래와 같이 파라미터를 추가하여 사용할 수 있습니다.

Kotlin

SampleApplication.kt

import com.nf4.Netfunnel
import android.app.Application

class SampleApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        Netfunnel.initialize(
            clientId = "{CLIENT_ID}",
            statusBarStyle = "auto" // "auto", "black", or "white"
        )
    }
}

Java

SampleApplication.java

import com.nf4.Netfunnel;
import android.app.Application;

public class SampleApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        Netfunnel.INSTANCE.initialize(
            "{CLIENT_ID}",
            null,      // serverUrl
            null,      // errorUrl
            3000L,     // networkTimeout
            0,         // retryCount
            false,     // printLog
            false,     // errorBypass
            true,      // useNetfunnelTemplate
            null,      // userId
            false,     // useNetworkRecoveryMode
            null,      // healthCheckUrl
            "auto"     // statusBarStyle: "auto", "black", or "white"
        );
    }
}