SNS 로그인, 외부 연동, 공유 | Appbox Android SDK 가이드
기기 기능
전화걸기
전화 앱에 번호를 입력한 상태로 엽니다. 고객센터 연결 버튼 등에 사용합니다.
dial(tel, callback)
호출 형태: 패턴 C(인자 있는 동작). 실행 중에 다시 호출하면 거절됩니다.
전화 다이얼로그를 오픈합니다.
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
tel | 필수 | 전화번호 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 성공 여부 (Boolean) |
자동으로 걸지 않으므로 CALL_PHONE 권한이 필요 없습니다. 발신은 사용자가 합니다. 성공 시 전화 앱이 앞으로 나오므로 연속 호출이 실패합니다 → 기기 기능 공통 규칙 개요의 함정 ②.
웹 브릿지에서는 전화걸기의 phone.dial입니다.
연락처 가져오기
getContacts(callback)
호출 형태: 패턴 E(Map 반환). 실행 중에 다시 호출하면 거절됩니다.
연락처 가져오기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | Map<String, String>: 선택한 연락처의 이름과 전화번호 |
| 오류 코드 | -1000: 사용자가 선택하지 않고 닫음 |
필요 권한: 없음. 시스템 선택 화면을 사용합니다.
웹 브릿지에서는 연락처 가져오기의 phone.getContacts입니다.
다른 앱 실행하기
openApp(androidScheme, googleplayUrl, callback)
호출 형태: 패턴 C(인자 있는 동작). 실행 중에 다시 호출하면 거절됩니다.
앱에서 다른 앱 호출
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
androidScheme | 필수 | 실행할 Android 앱의 scheme | - |
googleplayUrl | 필수 | 앱이 없을 때 이동할 Google Play URL | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 성공 여부 (Boolean) |
성공 시 다른 앱이 앞으로 나오므로 연속 호출이 실패합니다 → 기기 기능 공통 규칙 개요의 함정 ②.
웹 브릿지에서는 다른 앱 실행하기의 external.openApp입니다.
외부 페이지 열기
openBrowser(url, callback)
호출 형태: 패턴 C(인자 있는 동작). 실행 중에 다시 호출하면 거절됩니다.
앱 외부 페이지 열기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
url | 필수 | 외부 브라우저로 열 URL | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 성공 여부 (Boolean) |
| 오류 코드 | -8000: 브라우저 실행 실패 |
URL 정책이 적용됩니다 → 기기 기능 공통 규칙 개요의 인자 규칙. 성공 시 브라우저가 앞으로 나오므로 연속 호출이 실패합니다.
웹 브릿지에서는 외부 페이지 열기의 external.openBrowser입니다.
문자보내기
sendSMS(target, message, callback)
호출 형태: 패턴 C(인자 있는 동작). 실행 중에 다시 호출하면 거절됩니다.
문자 앱 실행하기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
target | 필수 | 받는 사람 전화번호 | - |
message | 필수 | 문자 본문 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 성공 여부 (Boolean) |
직접 발송하지 않습니다. 발송은 사용자가 합니다. 번호와 본문 형식은 검증하지 않습니다. 성공 시 문자 앱이 앞으로 나오므로 연속 호출이 실패합니다 → 기기 기능 공통 규칙 개요의 함정 ②.
웹 브릿지에서는 문자보내기의 phone.sendSMS입니다.
공유하기
share(message, callback)
호출 형태: 패턴 C(인자 있는 동작). 실행 중에 다시 호출하면 거절됩니다.
링크 또는 메시지 공유
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
message | 필수 | 공유할 텍스트 또는 URL | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 성공 여부 (Boolean) |
성공 후 앱이 백그라운드가 되므로 연속 호출이 실패합니다 → 기기 기능 공통 규칙 개요의 함정 ②.
웹 브릿지에서는 공유하기의 application.share입니다.