Huvle API Document1. Noti-bar 설정1-1. Noti-bar On/Off1-2. Noti-bar 잠금 화면 설정1-3. Custom Noti-bar1-3-1. Noti-bar Icon 수정1-3-2. Noti-bar 문구 수정1-3-2. Noti-bar layout 설정1-3-4. Noti-bar Event 설정2. Huvle 브라우저2-1. 브라우저 연동 API3. Huvle 이용 동의 창 수정3-1. 이용 동의창 이미지 수정3-2. 이용 동의창 레이아웃 구조 변경 3-3. 이용 동의 창 출력여부 설정

Huvle API Document

1. Noti-bar 설정

1-1. Noti-bar On/Off

Huvle SDK는 앱사의 설정 메뉴에서 Huvle Noti-bar On/Off 기능을 개발 할 수 있도록 API를 제공하고 있습니다.

Noti-bar On API


public static void notiUpdate(Context context)

Noti-bar Off API


public static void notiCancel(Context context)

Noti-bar Status API


public static boolean isNotiBarState(Context context)

true : Noti-bar On (Default)

false : Noti-bar Off

설정 메뉴를 통해 Huvle Noti-bar On/Off 기능을 제공하고 싶다면 아래의 예제 코드와 같이 Huvle Noti-bar 상태 정보를 확인 후 On/Off 토글 기능을 구현하시면됩니다.

Example Code


x
...
    
boolean currentStatus = Sap_Func.isNotiBarState(this);
if(currentStatus) {
    Sap_Func.notiCancel(this);
} else {
    Sap_Func.notiUpdate(this);
}
...

1-2. Noti-bar 잠금 화면 설정

Huvle SDK의 Noti-bar 화면이 잠금화면에 노출/비노출 될지에 관한 상태 정보를 관리하는 API 정보입니다.

잠금 화면 설정 API


public static void setNotiBarLockScreen(Context context, boolean state)

잠금 화면 상태 정보 API


public static boolean isNotiBarLockScreen(Context context)

true : 잠금화면 노출 (Default)

false: 잠금화면 비노출

잠금화면에서 Huvle Noti-bar가 출력되지 않기를 원하실 경우에만 아래의 예제 코드와 같이 잠금화면 상태 정보를 false로 설정합니다.

Example Code


...
@Override
public void onResume() {
    super.onResume();
    if(checkPermission()) {
        //-- 잠금 화면 설정 여부 
        Sap_Func.setNotiBarLockScreen(this, false);
        //-- Huvle 연동 API
        Sap_act_main_launcher.initsapStart(this, "bynetwork", true, true);
    }
}
...

setNotiBarLockScreen( )메서드는 반드시 Huvle SDK 연동 API를 호출하기 전에 호출해주셔야 정상적으로 기능 동작합니다.

휴대폰 제조사에 따라 일부 단말에서는 위의 설정 정보가 정상적으로 구동되지 않을 수 있습니다.

1-3. Custom Noti-bar

Huvle SDK는 귀사의 Application에 최적화된 Noti-bar를 구성하기 위하여 Custom Noti-bar 기능을 제공하고 있습니다. 기본적인 Noti-bar의 구성은 아래의 그림과 같으며, 앱사에서 Custom Noti-bar 제작을 원할 경우 icon 수정, 문구 수정, Event 정보를 수정할 수 있습니다.

1-3-1. Noti-bar Icon 수정

Huvle SDK에서 사용되는 Noti-bar Icon의 경로는 아래와 같습니다.

상세 경로 : ../Stealthaddplatformbrowser_lib/src/main/res/drawable-xxhdpi

귀사의 앱에서 변경하고 싶은 Icon을 notibar_icon_1 ~ notibar_icon_5 와 같이 동일한 파일명으로 이미지 제작 후 파일 덮어쓰기를 합니다.

Noti-bar의 6번째 영역은 Huvle SDK의 고유 영역임으로 notibar_icon_6의 이미지는 변경하시면 안됩니다.

Example

예를 들어 notibar_icon_1 아이콘을 제작 후 아래의 그림과 같이 동일한 파일명으로 파일 덮어쓰기를 했을 경우 Noti-bar의 아이콘이 변경됩니다.

Ex ) 파일 덮어쓰기

EX ) 결과 화면

1-3-2. Noti-bar 문구 수정

Noti-bar 하단에 출력되는 텍스트(문구) 정보를 수정하기 위해서는 string.xml 파일을 수정합니다.

Huvle Library는 영어, 한국어, 중국어, 베트남어, 일본어 를 지원합니다. Huvle Library의 res 폴더 하위의 values의 string.xml 파일을 수정합니다.

기본 설정 언어는 영어입니다.

Huvle Noti-bar와 관련된 item 속성 정보는 아래와 같이 noti_icon_1 ~ noti_icon_5 입니다.

각 item의 문구를 수정하였을 경우 Huvle Noti-bar의 문구가 변경됩니다.


...
<!-- Custom NotiBar -->
<string name="noti_icon_1">Call</string>
<string name="noti_icon_2">Camera</string>
<string name="noti_icon_3">Calculator</string>
<string name="noti_icon_4">Calendar</string>
<string name="noti_icon_5">Alarm</string>
...

Example

예를들어 Huvle Noti-bar의 첫번째 아이템의 문구를 변경하고 싶을 경우 아래와 같이 수정하시면됩니다.

EX ) string.xml 문구 수정


...
<!-- Call에서 Huvle App으로 문구 변경 -->
<string name="noti_icon_1">Huvle App</string>
<string name="noti_icon_2">Camera</string>
<string name="noti_icon_3">Calculator</string>
<string name="noti_icon_4">Calendar</string>
<string name="noti_icon_5">Alarm</string>
...

EX ) 결과 화면

Huvle Noti-bar의 문구를 변경하셨다면 Huvle SDK에서 제공하는 언어 정보인 영어, 한국어, 중국어, 베트남어, 일본어 파일 모두 수정해야 언어 설정에 따른 오류가 없을 수 있습니다.

문구를 변경하셨다면 반드시 모든 언어(영어, 한국어, 중국어, 베트남어, 일본어)의 stirng.xml 파일을 수정하십시오.

1-3-2. Noti-bar layout 설정

Huvle Noti-bar의 간격 및 배경화면에 대한 수정을 원하실 경우에는 lay_sap_act_noti.xml 파일을 수정하여 원하시는 형태의 Noti-bar 구성이 가능합니다.

상세 경로 : ../Stealthaddplatformbrowser_lib/src/main/res/layout/lay_sap_act_noti.xml

id 정보는 class 파일에서 참조하여 이벤트를 처리함으로 id 정보는 절대 변경하시면 안됩니다.

1-3-4. Noti-bar Event 설정

Sap_act_middle.class 파일은 Huvle Noti-bar의 이벤트 처리를 담당하는 class입니다.

Noti-bar에서 각 버튼을 선택하였을 경우 Sap_act_middle.class가 실행되며, 각 버튼 선택에 대한 구분자로 NT_001 ~ NT_005 값이 전달됩니다.

Huvle Noti-bar의 버튼을 Click 하였을 경우 Sap_act_middle.class에 정의된 startPackage( ) 메서드가 호출됩니다. switch 문의 메서드 정보를 수정하여 실행하고자 하는 Action 정보를 변경하실 수 있습니다.

startPackage( )

case NT_001 : Noti-Bar의 첫번째 아이콘 선택 시 실행되는 코드 위치

case NT_002 : Noti-Bar의 두번째 아이콘 선택 시 실행되는 코드 위치

case NT_003 : Noti-Bar의 세번째 아이콘 선택 시 실행되는 코드 위치

case NT_004 : Noti-Bar의 네번째 아이콘 선택 시 실행되는 코드 위치

case NT_005 : Noti-Bar의 다섯번째 아이콘 선택 시 실행되는 코드 위치


/**
    * Setting Custom Notification Bar
    * @param intent
    */
  
  private void startPackage(Intent intent) {
    try {
        if(intent!=null) {
            String NT_NUMBER = intent.getStringExtra(EXTRA_START_NUMBER);
            if(NT_NUMBER!=null && NT_NUMBER.isEmpty()==false) {
                switch (NT_NUMBER) {
                    //-- Custom
                    case NT_001:
                        startCustom(getPackageName(), "com.byappsoft.sap.browser.Sap_MainActivity");
                        break;
                    //-- Camera
                    case NT_002:
                        startCamera(this, NT_002);
                        break;
                    //-- Calendar
                    case NT_003:
                        startCalendar(this, NT_003);
                        break;
                    //-- Alarm
                    case NT_004:
                        startAlarm(this, NT_004);
                        break;
                    //-- Settings
                    case NT_005:
                        startSetting(this, NT_005);
                        break;
                    default:
                        clearMiddle(this);
                        break;
                }
            } else {
                clearMiddle(this);
            }
        } else {
            clearMiddle(this);
        }
    }catch (Exception e){
        clearMiddle(this);
    }
  }
  ...

Huvle Noti-bar의 아이콘(버튼)을 Click 했을 경우 귀사가 실행하고 싶은 Action 정보를 재 정의하십시오.

6번째 아이콘은 허블 브라우저를 실행하기 위한 고유 영역임으로 수정이 불가능합니다.

2. Huvle 브라우저

2-1. 브라우저 연동 API

Sap_MainActivity.class파일은 Huvle 브라우저를 실행하기 위한 Main Activity 정보입니다.

귀사의 앱에서 Huvle 브라우저를 실행하고 싶으시다면 Intent 정보를 생성하여 Sap_MainActivity.class 를 실행하면 됩니다.

Example Code


x
...
    
Intent intent = new Intent(MainActivity.this, Sap_MainActivity.class);
intent.putExtra("search_keyword", "https://www.google.com/");
intent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
startActivity(intent);
...

Huvle 브라우저를 실행하여 특정 URL을 로드하고 싶을 경우에는 intent 정보에 search_keyword 정보를 포함하여 Intent를 전달해야합니다.

바이펫 앱과 같이 Application 내부에 Huvle 브라우저 바로가기 아이콘을 제작하여 배치할 경우 광고 노출에 유리할 수 있습니다.

UI 작업은 고객사의 Application에 맞게 자체 제작하셔야합니다.

3. Huvle 이용 동의 창 수정

3-1. 이용 동의창 이미지 수정

Huvle SDK는 기본적으로 영어, 한국어, 중국어, 베트남어, 일본어를 지원함으로 총 5장의 이미지 파일이 있으며, 이용 동의창 이미지의 상세 경로는 아래와 같습니다.

상세 경로

../Stealthaddplatformbrowser_lib/src/main/res/drawable-xxhdpi

파일 명

영어 파일 명 : res_sap_notiba_img_en.png

한국어 파일 명 : res_sap_notiba_img_ko.png

중국어 파일 명 : res_sap_notiba_img_cn.png

베트남어 파일 명 : res_sap_notiba_img_vi.png

일본어 파일 명 : res_sap_notiba_img_ja.png

귀사의 Application에 맞게 각 언어별 이용 동의창 Icon을 제작 후 아래의 그림과 같이 파일 덮어쓰기를 하시면됩니다.

3-2. 이용 동의창 레이아웃 구조 변경

lay_sap_act_pop.xml 파일은 허블 이용 동의 창 Dialog에서 사용하는 xml 파일입니다.

이용 동의창 레이아웃 구조를 변경하고 싶을 경우 lay_sap_act_pop.xml 파일을 수정하시면 되겠습니다.

상세 경로 : ../Stealthaddplatformbrowser_lib/src/main/res/layout/llay_sap_act_pop.xml

3-3. 이용 동의 창 출력여부 설정

Huvle SDK 연동을 위해 호출하는 Sap_act_main_laucher.class 는 앱사에서 소스 수정 가능하도록 Open Source 형태로 제공하고 있기 때문에 귀사에서 원하는 형태로 소스 변경이 가능합니다.

최초 이용 동의창 출력 API


public static void isNotibarPopState(Context context)

최초 사용자에게 이용 동의 창이 출력된적이 있는지 확인하기 위한 메서드는 Sap_Fun.isNotibarPopState( ) 메서드 이며, 이용 동의 창이 출력된적이 없을 경우에만 Dialog를 생성하여 이용 동의 창을 출력합니다.

만약 귀사의 Application에서 이용 동의창 출력 없이 Huvle API를 직접 실행하고 싶으시다면 Dialog 생성과 관련된 코드를 주석처리 후 아래의 예제 소스코드와 같이 Sap_act_main.class의 initSapstartapp 메서드를 직접 호출하시면 됩니다.

Example Code


...
    
Sap_act_main.initSapStartapp(context, sAgkey, Sap_Func.isNotiBarState(context), URLSEARCH);
...

반드시 Sap_act_main.initSapStartapp( ) 메서드를 호출해야합니다.