SNS 로그인, 외부 연동, 공유 | Appbox Android SDK 가이드

기기 기능

전화걸기

전화 앱에 번호를 입력한 상태로 엽니다. 고객센터 연결 버튼 등에 사용합니다.

dial(tel, callback)

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

전화 다이얼로그를 오픈합니다.

AppBox.dial(tel, callback)

Kotlin
1 AppBox.dial(tel = "01012345678") { value, error ->
2 if (error != null) return@dial
3 Log.d("AppBox", value.toString())
4 }
1 AppBox.dial("01012345678", (value, error) -> {
2 if (error != null) return;
3 Log.d("AppBox", String.valueOf(value));
4 });

Request 항목 정의

Request 항목필수여부설명기본값
tel필수전화번호-


Response 항목 정의

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


자동으로 걸지 않으므로 CALL_PHONE 권한이 필요 없습니다. 발신은 사용자가 합니다. 성공 시 전화 앱이 앞으로 나오므로 연속 호출이 실패합니다 → 기기 기능 공통 규칙 개요의 함정 ②.

웹 브릿지에서는 전화걸기의 phone.dial입니다.

연락처 가져오기

시스템 연락처 선택 화면을 띄우고 사용자가 선택한 항목을 돌려줍니다. 추천인 입력, 초대 기능 등에 사용합니다.

getContacts(callback)

호출 형태: 패턴 E(Map 반환). 실행 중에 다시 호출하면 거절됩니다.

연락처 가져오기

AppBox.getContacts(callback)

Kotlin
1 AppBox.getContacts { value, error ->
2 if (error != null) return@getContacts
3 Log.d("AppBox", value.toString())
4 }
1 AppBox.getContacts((value, error) -> {
2 if (error != null) return;
3 Log.d("AppBox", String.valueOf(value));
4 });

Request 항목 정의

Request 항목필수여부설명기본값
--별도 요청 항목 없음-


Response 항목 정의

Response 결과값
값Map<String, String>: 선택한 연락처의 이름과 전화번호
오류 코드-1000: 사용자가 선택하지 않고 닫음


필요 권한: 없음. 시스템 선택 화면을 사용합니다.

웹 브릿지에서는 연락처 가져오기의 phone.getContacts입니다.

다른 앱 실행하기

다른 앱을 실행합니다. 설치돼 있지 않으면 Google Play로 이동시킵니다.

openApp(androidScheme, googleplayUrl, callback)

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

앱에서 다른 앱 호출

AppBox.openApp(androidScheme, googleplayUrl, callback)

Kotlin
1 AppBox.openApp(
2 androidScheme = "instagram://",
3 googleplayUrl = "https://play.google.com/store/apps/details?id=com.instagram.android"
4 ) { value, error ->
5 if (error != null) return@openApp
6 Log.d("AppBox", value.toString())
7 }
1 AppBox.openApp("instagram://",
2 "https://play.google.com/store/apps/details?id=com.instagram.android",
3 (value, error) -> {
4 if (error != null) return;
5 Log.d("AppBox", String.valueOf(value));
6 });

Request 항목 정의

Request 항목필수여부설명기본값
androidScheme필수실행할 Android 앱의 scheme-
googleplayUrl필수앱이 없을 때 이동할 Google Play URL-


Response 항목 정의

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


성공 시 다른 앱이 앞으로 나오므로 연속 호출이 실패합니다 → 기기 기능 공통 규칙 개요의 함정 ②.

웹 브릿지에서는 다른 앱 실행하기의 external.openApp입니다.

외부 페이지 열기

외부 브라우저로 URL을 엽니다. 앱 밖에서 열어야 하는 페이지(결제 완료 페이지, 외부 서비스 등)에 사용합니다.

openBrowser(url, callback)

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

앱 외부 페이지 열기

AppBox.openBrowser(url, callback)

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

Request 항목 정의

Request 항목필수여부설명기본값
url필수외부 브라우저로 열 URL-


Response 항목 정의

Response 결과값
값성공 여부 (Boolean)
오류 코드-8000: 브라우저 실행 실패


URL 정책이 적용됩니다 → 기기 기능 공통 규칙 개요의 인자 규칙. 성공 시 브라우저가 앞으로 나오므로 연속 호출이 실패합니다.

웹 브릿지에서는 외부 페이지 열기의 external.openBrowser입니다.

문자보내기

문자 앱을 수신자, 본문이 채워진 상태로 엽니다. 초대 문자, 공유 문자 작성에 사용합니다.

sendSMS(target, message, callback)

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

문자 앱 실행하기

AppBox.sendSMS(target, message, callback)

Kotlin
1 AppBox.sendSMS(target = "01012345678", message = "안녕하세요! 앱에서 보냅니다.") { value, error ->
2 if (error != null) return@sendSMS
3 Log.d("AppBox", value.toString())
4 }
1 AppBox.sendSMS("01012345678", "안녕하세요! 앱에서 보냅니다.", (value, error) -> {
2 if (error != null) return;
3 Log.d("AppBox", String.valueOf(value));
4 });

Request 항목 정의

Request 항목필수여부설명기본값
target필수받는 사람 전화번호-
message필수문자 본문-


Response 항목 정의

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


직접 발송하지 않습니다. 발송은 사용자가 합니다. 번호와 본문 형식은 검증하지 않습니다. 성공 시 문자 앱이 앞으로 나오므로 연속 호출이 실패합니다 → 기기 기능 공통 규칙 개요의 함정 ②.

웹 브릿지에서는 문자보내기의 phone.sendSMS입니다.

공유하기

시스템 공유 시트를 띄웁니다. 콘텐츠 링크나 초대 메시지를 다른 앱으로 전달할 때 사용합니다.

share(message, callback)

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

링크 또는 메시지 공유

AppBox.share(message, callback)

Kotlin
1 AppBox.share(message = "공유 텍스트입니다.") { value, error ->
2 if (error != null) return@share
3 Log.d("AppBox", value.toString())
4 }
1 AppBox.share("공유 텍스트입니다.", (value, error) -> {
2 if (error != null) return;
3 Log.d("AppBox", String.valueOf(value));
4 });

Request 항목 정의

Request 항목필수여부설명기본값
message필수공유할 텍스트 또는 URL-


Response 항목 정의

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


성공 후 앱이 백그라운드가 되므로 연속 호출이 실패합니다 → 기기 기능 공통 규칙 개요의 함정 ②.

웹 브릿지에서는 공유하기의 application.share입니다.

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