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

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

전화걸기

전화 앱으로 발신합니다.

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

AppBox.shared.dial(tel:completion:)

Swift
1 AppBox.shared.dial(tel: "01012345678") { value, error in
2 guard error == nil else { return }
3 print(value)
4 }
1 [AppBox.shared dialWithTel:@"01012345678" completion:^(BOOL value, NSError *error) {
2 if (error) { return; }
3 NSLog(@"%d", value);
4 }];

Request 항목 정의

Request 항목필수여부설명기본값
tel필수전화번호-
completion필수결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다-

Response 항목 정의

Response 결과값
값Bool
오류실패 원인. NSError


화면 불필요. 전화 앱을 엽니다. iOS는 통화 시작 전 확인을 거칩니다

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

연락처 가져오기

연락처 선택 화면을 띄우고 선택한 항목을 돌려줍니다.

연락처 가져오기

AppBox.shared.getContacts(completion:)

Swift
1 AppBox.shared.getContacts { value, error in
2 guard error == nil else { return }
3 print(value)
4 }
1 [AppBox.shared getContactsWithCompletion:^(NSDictionary *value, NSError *error) {
2 if (error) { return; }
3 NSLog(@"%@", value);
4 }];

Request 항목 정의

Request 항목필수여부설명기본값
completion필수결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다-

Response 항목 정의

Response 결과값
값[String: Any]?
오류실패 원인. NSError


화면 필요. NSContactsUsageDescription이 필요 없습니다. OS의 연락처 선택 화면을 띄우는 방식이라 앱이 주소록을 읽지 않습니다

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

다른 앱 실행하기

다른 앱을 실행합니다.

앱에서 다른 앱 호출

AppBox.shared.openApp(iosScheme:appstoreUrl:completion:)

Swift
1 AppBox.shared.openApp(iosScheme: "instagram://", appstoreUrl: "https://apps.apple.com/kr/app/id389801252") { value, error in
2 guard error == nil else { return }
3 print(value)
4 }
1 [AppBox.shared openAppWithIosScheme:@"instagram://" appstoreUrl:@"https://apps.apple.com/kr/app/id389801252" completion:^(BOOL value, NSError *error) {
2 if (error) { return; }
3 NSLog(@"%d", value);
4 }];

Request 항목 정의

Request 항목필수여부설명기본값
iosScheme필수실행할 iOS 앱의 scheme-
appstoreUrl필수앱이 없을 때 이동할 App Store URL-
completion필수결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다-

Response 항목 정의

Response 결과값
값Bool
오류실패 원인. NSError


화면 불필요. 인자 이름이 iosScheme입니다(Android는 androidScheme). 앱이 없으면 App Store로 보냅니다

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

외부 페이지 열기

외부 브라우저로 URL을 엽니다.

앱 외부 페이지 열기

AppBox.shared.openBrowser(url:completion:)

Swift
1 AppBox.shared.openBrowser(url: "https://appboxapp.com") { value, error in
2 guard error == nil else { return }
3 print(value)
4 }
1 [AppBox.shared openBrowserWithUrl:@"https://appboxapp.com" completion:^(BOOL value, NSError *error) {
2 if (error) { return; }
3 NSLog(@"%d", value);
4 }];

Request 항목 정의

Request 항목필수여부설명기본값
url필수외부 브라우저로 열 URL-
completion필수결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다-

Response 항목 정의

Response 결과값
값Bool
오류실패 원인. NSError


화면 불필요. http/https만 허용합니다. 위반 시 -1004

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

문자보내기

문자 메시지 작성 화면을 엽니다.

문자 앱 실행하기

AppBox.shared.sendSMS(target:message:completion:)

Swift
1 AppBox.shared.sendSMS(target: "01012345678", message: "저장했습니다") { value, error in
2 guard error == nil else { return }
3 print(value)
4 }
1 [AppBox.shared sendSMSWithTarget:@"01012345678" message:@"저장했습니다" completion:^(BOOL value, NSError *error) {
2 if (error) { return; }
3 NSLog(@"%d", value);
4 }];

Request 항목 정의

Request 항목필수여부설명기본값
target필수받는 사람 전화번호-
message필수문자 본문-
completion필수결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다-

Response 항목 정의

Response 결과값
값Bool
오류실패 원인. NSError


화면 불필요. 메시지 앱을 채워서 엽니다. 직접 발송하지 않습니다

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

SNS 로그아웃

연결된 모든 SNS 세션을 로그아웃합니다.

SNS 로그아웃하기

AppBox.shared.snsLogout(completion:)

Swift
1 AppBox.shared.snsLogout { success, error in
2 guard error == nil else { return }
3 print(success)
4 }
1 [AppBox.shared snsLogoutWithCompletion:^(BOOL success, NSError *error) {
2 if (error != nil) { return; }
3 NSLog(@"%d", success);
4 }];

Request 항목 정의

Request 항목필수여부설명기본값
completion필수결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다-

Response 항목 정의

Response 결과값
값Bool. 활성 세션이 없었으면 false
오류실패 원인. NSError


화면 필요. 모든 제공자를 한 번에 로그아웃합니다. 제공자를 지정해 로그아웃하려면 로그아웃을 사용합니다

웹 브릿지에서는 application.snsLogout입니다.

공유하기

시스템 공유 시트를 띄웁니다.

링크 또는 메시지 공유

AppBox.shared.share(message:completion:)

Swift
1 AppBox.shared.share(message: "저장했습니다") { value, error in
2 guard error == nil else { return }
3 print(value)
4 }
1 [AppBox.shared shareWithMessage:@"저장했습니다" completion:^(BOOL value, NSError *error) {
2 if (error) { return; }
3 NSLog(@"%d", value);
4 }];

Request 항목 정의

Request 항목필수여부설명기본값
message필수공유할 텍스트 또는 URL-
completion필수결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다-

Response 항목 정의

Response 결과값
값Bool
오류실패 원인. NSError


화면 필요. OS 공유 시트를 띄웁니다

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

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