화면 구성, 팝업, 네비게이션 | Appbox Android SDK 가이드

기기 기능

이미지 뷰어

이미지 뷰어를 띄웁니다. 상품 상세 이미지나 갤러리처럼 여러 장을 확대, 스와이프로 보여줄 때 사용합니다.

imageViewerOpen(imageUrls, selectColor?, callback)

호출 형태: 패턴 D(선택 인자가 여러 개인 함수). 실행 중에 다시 호출하면 거절됩니다.

이미지 뷰어 오픈

AppBox.imageViewerOpen(imageUrls, selectColor, callback)

Kotlin
1 AppBox.imageViewerOpen(
2 imageUrls = listOf("https://example.com/1.jpg", "https://example.com/2.jpg"),
3 selectColor = "#FFFFFF"
4 ) { value, error ->
5 if (error != null) return@imageViewerOpen
6 Log.d("AppBox", value.toString())
7 }
1 AppBox.imageViewerOpen(
2 Arrays.asList("https://example.com/1.jpg", "https://example.com/2.jpg"),
3 "#FFFFFF", (value, error) -> {
4 if (error != null) return;
5 Log.d("AppBox", String.valueOf(value));
6 });

Request 항목 정의

Request 항목필수여부설명기본값
imageUrls필수표시할 이미지 URL 목록. 최소 한 개-
selectColor-선택된 이미지 테두리 색#FFFFFF


Response 항목 정의

Response 결과값
값성공 여부 (Boolean)
오류 코드-1004: URL 정책 위반 항목 발견: 앞에서부터 검사하다 위반 항목을 만나면 전체가 실패하며, error 메시지에 처음 위반한 항목의 인덱스가 담깁니다

웹 브릿지에서는 이미지 뷰어의 ui.imageViewerOpen입니다.

모달 페이지 오픈

하단 시트 형태의 WebView로 웹페이지를 엽니다. 화면 전환 없이 상세 안내나 폼 입력을 처리할 때 사용합니다.

modalPageOpen(openURL, callback)

호출 형태: 패턴 C(인자 있는 동작). 실행 중에 다시 호출하면 거절됩니다.

앱 내 새로운 페이지 열기

AppBox.modalPageOpen(openURL, callback)

Kotlin
1 AppBox.modalPageOpen(openURL = "https://appboxapp.com/notice") { value, error ->
2 if (error != null) return@modalPageOpen
3 Log.d("AppBox", value.toString())
4 }
1 AppBox.modalPageOpen("https://appboxapp.com/notice", (value, error) -> {
2 if (error != null) return;
3 Log.d("AppBox", String.valueOf(value));
4 });

Request 항목 정의

Request 항목필수여부설명기본값
openURL필수모달로 열 페이지 URL-


Response 항목 정의

Response 결과값
값성공 여부 (Boolean)


URL 정책이 적용됩니다 → 기기 기능 공통 규칙 개요의 인자 규칙.

웹 브릿지에서는 모달 페이지 오픈의 ui.modalPageOpen입니다.

PDF 뷰어

PDF 뷰어를 띄웁니다. 약관, 매뉴얼, 안내서 같은 PDF 자료를 앱 안에서 바로 보여줄 때 사용합니다.

pdfViewerOpen(pdfUrl, callback)

호출 형태: 패턴 C(인자 있는 동작). 실행 중에 다시 호출하면 거절됩니다.

PDF 뷰어로 문서 보기

AppBox.pdfViewerOpen(pdfUrl, callback)

Kotlin
1 AppBox.pdfViewerOpen(pdfUrl = "https://example.com/guide.pdf") { value, error ->
2 if (error != null) return@pdfViewerOpen
3 Log.d("AppBox", value.toString())
4 }
1 AppBox.pdfViewerOpen("https://example.com/guide.pdf", (value, error) -> {
2 if (error != null) return;
3 Log.d("AppBox", String.valueOf(value));
4 });

Request 항목 정의

Request 항목필수여부설명기본값
pdfUrl필수표시할 PDF의 URL-


Response 항목 정의

Response 결과값
값성공 여부 (Boolean)


URL 정책이 적용됩니다 → 기기 기능 공통 규칙 개요의 인자 규칙.

웹 브릿지에서는 PDF 뷰어의 ui.pdfViewerOpen입니다.

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