.png%3Falt%3Dmedia%26token%3D0ce2e20b-c393-4a72-93e6-d6a5212bd468)
.png%3Falt%3Dmedia%26token%3D0ce2e20b-c393-4a72-93e6-d6a5212bd468)
Javascript 연동 API 문서
WebView 모듈(웹뷰,푸시전용)을 제어할 수 있는 Javascript API
스윙투앱에서 제공하는 웹뷰와 푸시전용 프로토타입의 앱을 제어할 수 있는 javascript API 입니다.
공통적으로 아래의 js 파일을 include 하여 사용하시고 아래의 API 명세를 통해서
필요한 기능을 실행하시면 됩니다.
공통 js 파일 HTML 파일에 아래의 js 파일을 포함시켜주세요
<script src="https://pcdn2.swing2app.co.kr/swing_public_src/v3/2023_05_18_001/js/swing_app_on_web.js"></script>
웹뷰에서 이전 페이지로 이동 웹브라우저에서 뒤로가기 기능과 동일한 동작
1
swingWebViewPlugin.app.webview.back();
웹뷰에서 앞의 페이지로 이동 웹브라우저에서 앞으로가기 기능과 동일한 동작
1
swingWebViewPlugin.app.webview.forward();
웹뷰에서 스윙투앱에 셋팅된 홈 페이지(설정된 초기 페이지)로 이동하는 기능
1
swingWebViewPlugin.app.navigateToHome()
웹상에서 플랫폼 정보를 가져오기 위한 함수
1
if( swingWebViewPlugin.app.methods.getCurrentPlatform() == 'android' )
2
{
3
console.log('android');
4
}
5
else if( swingWebViewPlugin.app.methods.getCurrentPlatform() == 'ios' )
6
{
7
console.log('ios');
8
}
9
else
10
{
11
console.log('web browser');
12
}
앱의 버전및 기기의 H/W 그리고 S/W 정보를 가져오는 함수
1
// android
2
swingWebViewPlugin.app.methods.getAppVersion(function(value){
3
var appVersion = JSON.parse(value);
4
5
console.log('model : ' + appVersion.model);
6
console.log('sdk_version : ' + appVersion.sdk_version);
7
console.log('version_release : ' + appVersion.version_release);
8
console.log('manufacturer : ' + appVersion.manufacturer);
9
console.log('app_version : ' + appVersion.app_version);
10
console.log('radio_version : ' + appVersion.radio_version);
11
console.log('package_name : ' + appVersion.package_name);
12
});
13
14
// ios
15
swingWebViewPlugin.app.methods.getAppVersion(function(value){
16
var appVersion = JSON.parse(value);
17
18
console.log('model : ' + appVersion.model);
19
console.log('name : ' + appVersion.name);
20
console.log('systemVersion : ' + appVersion.systemVersion);
21
console.log('appVersion : ' + appVersion.appVersion);
22
console.log('bundleVersion : ' + appVersion.bundleVersion);
23
console.log('bundleID : ' + appVersion.bundleID);
24
});
실행중인 앱을 종료하는 명령어
1
swingWebViewPlugin.app.methods.doExitApp();
크롬 또는 사파리등 앱의 기본 브라우저로 특정 페이지를 열고 싶을때 아래의 함수를 이용할 수 있다.
1
swingWebViewPlugin.app.methods.doExternalOpen('https://www.swing2app.com');
안드로이드와 iOS 자체적으로 제공하는 앱 내장 브라우저를 이용해서 실행
크롬과 사파리등을 반드시 이용해야 하는 경우 아래의 코드를 통해서 앱 내부에서 크롬과 사파리를 호출 할 수 있다.
1
swingWebViewPlugin.app.methods.openBrowser('https://www.swing2app.com');
현재 웹 페이지를 공유하는 기능을 위한 아래의 코드를 실행
1
swingWebViewPlugin.app.methods.doShareCurrentPage();
지정한 URL을 공유하고자 할 경우 아래와 같이 코드를 실행
1
swingWebViewPlugin.app.methods.doShareWithUrl('https://www.swing2app.com');
어플리케이션에서 푸시 알람 설정에 대한 상태를 확인하는 기능
푸시가 비활성화 되었을 경우 OS 자체적으로 푸시가 Off 되었을 경우와
앱 자체적인 설정으로 Off 가 되었을경우를 확인할 수 있다.
1
swingWebViewPlugin.app.methods.isNotificationEnabled(function (result) {
2
if( result == '1' ) // 푸시를 발송 할 수 있는 상태
3
{
4
console.log('push active');
5
}
6
else if( result == 'off_on_system' ) // 시스템 설정에 의한 앱 푸시 비활성화
7
{
8
console.log('push inactive');
9
}
10
else if( result == 'off_on_app' ) // 앱 설 정에 의한 앱 푸시 비활성화
11
{
12
console.log('push inactive');
13
}
14
});
Ex:) 푸시 설정에 따라 Off 설정일 경우 활성화 권장을 위한 코드예제
1
swingWebViewPlugin.app.methods.isNotificationEnabled(function (result) {
2
if( result == '1' ) // 푸시를 발송 할 수 있는 상태
3
{
4
console.log('push active');
5
}
6
else if( result == 'off_on_system' ) // 시스템 설정에 의한 앱 푸시 비활성화
7
{
8
console.log('push inactive');
9
swingWebViewPlugin.app.methods.goToNotificationSetting("system"); // 시스템 설정 Open
10
}
11
else if( result == 'off_on_app' ) // 앱 설정에 의한 앱 푸시 비활성화
12
{
13
console.log('push inactive');
14
swingWebViewPlugin.app.methods.goToNotificationSetting("app"); // 앱 설정 Open
15
}
16
});
어플리케이션 또는 시스템의 알람설정을 이동할 수 있는 기능
(1) 어플리케이션 자체적인 알람 설정을 할 수 있는 화면으로 이동
swingWebViewPlugin.app.methods.goToNotificationSetting('app');
(2) 시스템(안드로이드, iOS) 자체적인 알람 설정을 할 수 있는 화면으로 이동
swingWebViewPlugin.app.methods.goToNotificationSetting('system');
앱의 Native Event 를 관리할 수 있는 명령어 입니다.
앱의 back 버튼의 종료 이벤트를 추가할 경우 back버튼을 인한 앱에서는 종료 기능이 동작하지 않습니다.
따라서 backExitEvent 추가할 경우 종료에 대한 처리를 callback 함수내에서 직접 구현해야 합니다.
swingWebViewPlugin.event.addEvent('backExitEvent' , function() {
// 앱 종료 Logic 직접 구현
})
웹사이트에서 직접 앱내의 애드몹 광고를 관리할 수 있는 명령어 입니다.
아래의 내용을 참고하셔서 광고들을 활용해보세요.
반드시 애드몹이 활성된 앱의 경우만 동작하는 명령어 입니다.
어플리케이션내에 애드몹 배너 광고를 노출시키는 명령
Parameter | 설명 | 값 예시 |
|---|---|---|
adId | 배너광고 단위 아이디 입력 | ca-app-pub-3940256099942544/6300978111 |
1
swingWebViewPlugin.app.admob.showBanner('ca-app-pub-3940256099942544/6300978111');
어플리케이션내에 애드몹 배너 광고를 종료시키는 명령
1
swingWebViewPlugin.app.admob.closeBanner();
어플리케이션내에 애드몹 전면 광고를 노출시키는 명령
Parameter | 설명 | 값 예시 |
|---|---|---|
adId | 전면광고 단위 아이디 입력 | ca-app-pub-3940256099942544/6300978111 |
1
swingWebViewPlugin.app.admob.showInterstitialAd('ca-app-pub-3940256099942544/6300978111');
Last modified 11d ago