앱 SNS 소셜 로그인 연동 | 카카오·네이버·구글·애플

SNS 로그인•외부연동•공유

Google SNS 로그인

웹 페이지에서 Google SNS 로그인이 필요한 경우 해당 브릿지를 호출하여 로그인하세요.
Google 계정을 이용한 간편 로그인 기능입니다.

Google SNS 로그인 연동

AppboxSDK.application.googleSnsLogin()

Javascript
1 // 구글 로그인
2 AppboxSDK.application.googleSnsLogin( ( err, data ) => {
3 if (err) {
4 console.error( "구글 로그인 실패:", "code:", err.code, "message:", err.message );
5 } else {
6 console.log( "구글 로그인 완료:", , data.result, data.result.uid );
7 }
8 });

Response 항목 정의

Response 결과값
result displayName 사용자 표시 이름(닉네임/이름)
uid 사용자 고유 식별자 문자열
photoURL 프로필 이미지 URL
email 사용자 이메일
token Firebase ID 토큰

로그인 후 리턴값을 받아서 웹페이지에서 로그인 유지를 처리하여야 합니다.






Apple SNS 로그인

웹 페이지에서 Apple SNS 로그인이 필요한 경우 해당 브릿지를 호출하여 로그인하세요.
Apple 계정을 이용한 간편 로그인 기능입니다.

Apple SNS 로그인 연동

AppboxSDK.application.appleSnsLogin()

Javascript
1 // 애플 로그인
2 AppboxSDK.application.appleSnsLogin( ( err, data ) => {
3 if (err) {
4 console.error( "애플 로그인 실패:", "code:", err.code, "message:", err.message );
5 } else {
6 console.log( "애플 로그인 완료:", , data.result, data.result.uid );
7 }
8 });

Response 항목 정의

Response 결과값
result displayName 사용자 표시 이름(닉네임/이름)
uid 사용자 고유 식별자 문자열
photoURL 프로필 이미지 URL
email 사용자 이메일
token Firebase ID 토큰

로그인 후 리턴값을 받아서 웹페이지에서 로그인 유지를 처리하여야 합니다.






Kakao SNS 로그인

웹 페이지에서 Kakao SNS 로그인이 필요한 경우 해당 브릿지를 호출하여 로그인하세요.
Kakao 계정을 이용한 간편 로그인 기능입니다.

Kakao SNS 로그인 연동

AppboxSDK.application.kakaoSnsLogin()

Javascript
1 // 카카오 로그인
2 AppboxSDK.application.kakaoSnsLogin( ( err, data ) => {
3 if (err) {
4 console.error( "카카오 로그인 실패:", "code:", err.code, "message:", err.message );
5 } else {
6 console.log( "카카오 로그인 완료:", , data.result, data.result.uid );
7 }
8 });

Response 항목 정의

Response 결과값
result displayName 사용자 표시 이름(닉네임/이름)
uid 사용자 고유 식별자 문자열
photoURL 프로필 이미지 URL
email 사용자 이메일
accessToken SNS OAuth 액세스 토큰
refreshToken SNS OAuth 리프레시 토큰

로그인 후 리턴값을 받아서 웹페이지에서 로그인 유지를 처리하여야 합니다.











SNS 로그아웃

앱에 연동된 SNS 로그인 세션을 로그아웃 처리할 수 있습니다.
AppBoxSnsLoginSDK가 연동되어 있는 경우 구글, 애플, 카카오, 네이버 SNS 세션 로그아웃을 처리합니다.

SNS 로그아웃하기

AppboxSDK.application.snsLogout()

Javascript
1 // SNS 로그아웃
2 AppboxSDK.application.snsLogout( (err, data) => {
3 if (err) {
4 console.error( "SNS 로그아웃 실패:", "code:", err.code, "message:", err.message );
5 } else {
6 console.log( "SNS 로그아웃 결과 :", data.result );
7 }
8 });

Request 항목 정의

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


Response 항목 정의

Response 결과값
data.result 로그아웃 처리 여부 (true | false)
err.code 에러코드
err.message 에러 메시지

AppBoxSnsLoginSDK 연동이 필요합니다. 활성 SNS 세션이 있었고 로그아웃이 처리되면 true, 활성 세션이 없으면 false를 반환합니다.






외부 페이지 열기

외부 브라우저로 웹페이지를 열어볼 수 있습니다.
크롬, 사파리 등의 외부 브라우저를 통해 웹페이지를 열어서 다른 웹페이지 등을 탐색할 수 있도록 제공합니다.

앱 외부 페이지 열기

AppboxSDK.external.openBrowser(...)

Javascript
1 // 외부 브라우저 열기
2 AppboxSDK.external.openBrowser(
3 { url: "https://www.appboxapp.com" },
4 (err, data) => {
5 if (err) {
6 console.error( "외부 브라우저 열기 실패:", "code:", err.code, "message:", err.message );
7 } else {
8 console.log( "외부 브라우저 열기 OK:", data.result );
9 }
10 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
url 필수 외부로 오픈 할 URL


Response 항목 정의

Response 결과값
data.result 성공 여부 (true | false)





다른 앱 실행하기

앱 안에서 버튼이나 메뉴를 눌렀을 때, 기기에 설치된 다른 앱을 바로 열 수 있는 기능입니다.
사용자가 별도로 홈 화면으로 나가거나 앱을 찾을 필요 없이, 원하는 앱으로 곧바로 이동할 수 있습니다.

앱에서 다른 앱 호출

AppboxSDK.external.openApp(...)

Javascript
1 // 다른 앱 실행하기
2 AppboxSDK.external.openApp(
3 {
4 android_scheme: "kakaolink://send",
5 ios_scheme: "kakaolink://send",
6 googleplay_url: "https://play.google.com/store/apps/details?id=com.kakao.talk",
7 appstore_url: "https://apps.apple.com/app/id362057947"
8 }, (err, data) => {
9 if (err) {
10 console.error( "다른 앱 실행 실패:", "code:", err.code, "message:", err.message );
11 } else {
12 console.log( "다른 앱 실행 OK:", data.result );
13 }
14 });

Request 항목 정의

Request 항목 필수여부 설명 기본값
android_scheme 필수 오픈 할 Android 앱의 스키마명
ios_scheme 필수 오픈 할 iOS 앱의 스키마명
googleplay_url 필수 해당 앱의 구글플레이 URL
appstore_url 필수 해당 앱의 앱스토어 URL
android_scheme 필수 오픈 할 Android 앱의 스키마명


Response 항목 정의

Response 결과값
data.result 성공 여부 (true | false)

iOS는 프로젝트 내의 설정이 필요합니다. Info.plist > Information PropertyList밑에 LSApplicationQueriesSchemes의 하위항목으로 호출할 앱 이름(uri scheme)을 입력하여야 합니다.







공유하기

앱 화면에서 보고 있는 콘텐츠를 카카오톡, 문자, 이메일, SNS 등 다른 앱으로 바로 공유할 수 있는 기능입니다.
사용자는 버튼 한 번으로 원하는 채널을 선택해 링크나 메시지를 손쉽게 전달할 수 있습니다.

링크 또는 메시지 공유

AppboxSDK.application.share(...)

Javascript
1 // 공유하기 (텍스트/URL 공유)
2 const msg = "공유 텍스트입니다.";
3 AppboxSDK.application.share(
4 { message: msg }, (err, data) => {
5 if (err) {
6 console.error( "공유 실패:", "code:", err.code, "message:", err.message );
7 } else {
8 console.log( "공유 성공:", data.result );
9 }
10 });

Request 항목 정의

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


Response 항목 정의

Response 결과값
data.result 성공 여부 (true | false)





연락처 가져오기

사용자의 시스템 연락처 선택 화면을 열고, 선택한 단일 연락처 정보를 가져올 수 있습니다.
연락처 선택은 iOS 시스템 picker 화면을 사용하며, 사용자가 직접 선택한 연락처의 이름과 전화번호를 웹으로 전달합니다.

연락처 가져오기

AppboxSDK.phone.getContacts()

Javascript
1 // 연락처 가져오기
2 AppboxSDK.phone.getContacts( (err, data) => {
3 if (err) {
4 console.error( "연락처 선택 실패:", "code:", err.code, "message:", err.message );
5 } else {
6 console.log( "연락처 이름 :", data.name );
7 console.log( "전화번호 :", data.phone );
8 }
9 });

Request 항목 정의

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


Response 항목 정의

Response 결과값
data.name 선택한 연락처 이름
data.phone 선택한 연락처 전화번호
err.code 에러코드 ( -1000 : 사용자가 닫음)
err.message 에러 메시지

전화번호가 있는 연락처만 선택할 수 있습니다. 별도 NSContactsUsageDescription 권한 문구는 필요하지 않습니다.






문자보내기

수신인 번호, 문자내용을 입력하여 자동으로 문자 앱을 실행합니다.
SMS 앱을 실행해 지정된 번호와 메시지로 문자를 보낼 수 있습니다.

문자 앱 실행하기

AppboxSDK.phone.sendSMS(...)

Javascript
1 // SMS 문자앱 오픈
2 AppboxSDK.phone.sendSMS(
3 {
4 target: "01012345678",
5 message: "안녕하세요! 앱에서 보냅니다."
6 }, (err, data) => {
7 if (err) {
8 console.error( "SMS 실행 실패:", "code:", err.code, "message:", err.message );
9 } else {
10 console.log( "SMS 실행 OK:", data.result );
11 }
12 });

Request 항목 정의

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


Response 항목 정의

Response 결과값
data.result 성공 여부 (true | false)





전화걸기

전화 앱을 실행하여 지정된 번호로 통화 연결을 제공합니다.

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

AppboxSDK.phone.dial(...)

Javascript
1 // 전화걸기
2 AppboxSDK.phone.dial( { tel: "010-1234-5678" }, (err, data) => {
3 if (err) {
4 console.error( "전화 다이얼 실패:", "code:", err.code, "message:", err.message );
5 } else {
6 console.log( "전화 다이얼 실행 OK:", data.result );
7 }
8 });

Request 항목 정의

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


Response 항목 정의

Response 결과값
data.result 성공 여부 (true | false)














앱 데모체험
지금 웹사이트 주소를 입력하고
데모 앱을 체험해 보세요!
앱으로 바꾸고 싶은 당신의 웹사이트 주소를 입력해 보세요. 즉각 체험할 수 있는 데모 앱을 받을 수 있습니다.

QR 코드
QR 코드를 찍고 앱으로 바뀐
웹사이트를 지금 바로 확인해 보세요!
www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.