@apps-in-toss/web-bridge 0.0.39 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/built/bridge.d.ts +33 -0
- package/built/bridge.js +1 -0
- package/{build → built}/closeView.d.ts +1 -1
- package/{build → built}/contactsViral.d.ts +5 -4
- package/{build → built}/fetchContacts.d.ts +20 -22
- package/{build → built}/generateHapticFeedback.d.ts +2 -2
- package/{build → built}/getCurrentLocation.d.ts +5 -17
- package/{build → built}/getLocale.d.ts +1 -1
- package/{build → built}/getNetworkStatus.d.ts +1 -1
- package/{build → built}/getPlatformOS.d.ts +1 -1
- package/{build → built}/getSchemeUri.d.ts +1 -1
- package/built/index.cjs +680 -0
- package/built/index.d.cts +657 -0
- package/{build → built}/index.d.ts +8 -8
- package/{build → built}/index.js +4 -4
- package/built/onVisibilityChangedByTransparentServiceWeb.d.ts +21 -0
- package/{build → built}/openURL.d.ts +1 -1
- package/{build → built}/setIosSwipeGestureEnabled.d.ts +1 -1
- package/{build → built}/setScreenAwakeMode.d.ts +2 -2
- package/{build → built}/setSecureScreen.d.ts +1 -1
- package/{build → built}/share.d.ts +1 -1
- package/{build → built}/startUpdateLocation.d.ts +5 -11
- package/built/types.d.ts +110 -0
- package/package.json +21 -15
- package/build/bridge.d.ts +0 -31
- package/build/bridge.js +0 -1
- /package/{build → built}/appLogin.d.ts +0 -0
- /package/{build → built}/checkoutPayment.d.ts +0 -0
- /package/{build → built}/eventLog.d.ts +0 -0
- /package/{build → built}/fetchAlbumPhotos.d.ts +0 -0
- /package/{build → built}/getClipboardText.d.ts +0 -0
- /package/{build → built}/getDeviceId.d.ts +0 -0
- /package/{build → built}/getGameCenterGameProfile.d.ts +0 -0
- /package/{build → built}/getOperationalEnvironment.d.ts +0 -0
- /package/{build → built}/getTossAppVersion.d.ts +0 -0
- /package/{build → built}/getTossShareLink.d.ts +0 -0
- /package/{build → built}/openCamera.d.ts +0 -0
- /package/{build → built}/openGameCenterLeaderboard.d.ts +0 -0
- /package/{build → built}/saveBase64Data.d.ts +0 -0
- /package/{build → built}/setClipboardText.d.ts +0 -0
- /package/{build → built}/setDeviceOrientation.d.ts +0 -0
- /package/{build → built}/submitGameCenterLeaderBoardScore.d.ts +0 -0
package/built/index.cjs
ADDED
|
@@ -0,0 +1,680 @@
|
|
|
1
|
+
export * from './bridge.js';
|
|
2
|
+
"use strict";
|
|
3
|
+
var __defProp = Object.defineProperty;
|
|
4
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
5
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
6
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
7
|
+
var __export = (target, all) => {
|
|
8
|
+
for (var name in all)
|
|
9
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
10
|
+
};
|
|
11
|
+
var __copyProps = (to, from, except, desc) => {
|
|
12
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
13
|
+
for (let key of __getOwnPropNames(from))
|
|
14
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
15
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
16
|
+
}
|
|
17
|
+
return to;
|
|
18
|
+
};
|
|
19
|
+
var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
|
|
20
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
21
|
+
|
|
22
|
+
// src/index.ts
|
|
23
|
+
var index_exports = {};
|
|
24
|
+
__export(index_exports, {
|
|
25
|
+
GoogleAdMob: () => GoogleAdMob,
|
|
26
|
+
IAP: () => IAP,
|
|
27
|
+
Storage: () => Storage,
|
|
28
|
+
appsInTossEvent: () => appsInTossEvent,
|
|
29
|
+
env: () => env,
|
|
30
|
+
getAppsInTossGlobals: () => getAppsInTossGlobals,
|
|
31
|
+
getSafeAreaInsets: () => getSafeAreaInsets,
|
|
32
|
+
graniteEvent: () => graniteEvent,
|
|
33
|
+
isMinVersionSupported: () => isMinVersionSupported,
|
|
34
|
+
partner: () => partner,
|
|
35
|
+
tdsEvent: () => tdsEvent
|
|
36
|
+
});
|
|
37
|
+
module.exports = __toCommonJS(index_exports);
|
|
38
|
+
__reExport(index_exports, require("@apps-in-toss/bridge-core"), module.exports);
|
|
39
|
+
|
|
40
|
+
// src/storage.ts
|
|
41
|
+
var import_bridge_core = require("@apps-in-toss/bridge-core");
|
|
42
|
+
var Storage = {
|
|
43
|
+
/**
|
|
44
|
+
* @public
|
|
45
|
+
* @category 저장소
|
|
46
|
+
* @name getItem
|
|
47
|
+
* @description 모바일 앱의 로컬 저장소에서 문자열 데이터를 가져와요. 주로 앱이 종료되었다가 다시 시작해도 데이터가 유지되어야 하는 경우에 사용해요.
|
|
48
|
+
* @param {string} key - 가져올 아이템의 키를 입력해요.
|
|
49
|
+
* @returns {Promise<string | null>} 지정한 키에 저장된 문자열 값을 반환해요. 값이 없으면 `null`을 반환해요.
|
|
50
|
+
* @example
|
|
51
|
+
*
|
|
52
|
+
* ### `my-key`에 저장된 아이템 가져오기
|
|
53
|
+
* ```ts
|
|
54
|
+
* const value = await Storage.getItem('my-key');
|
|
55
|
+
* console.log(value); // 'value'
|
|
56
|
+
* ```
|
|
57
|
+
*/
|
|
58
|
+
getItem: (0, import_bridge_core.createAsyncBridge)("getStorageItem"),
|
|
59
|
+
/**
|
|
60
|
+
* @public
|
|
61
|
+
* @category 저장소
|
|
62
|
+
* @name setItem
|
|
63
|
+
* @description 모바일 앱의 로컬 저장소에 문자열 데이터를 저장해요. 주로 앱이 종료되었다가 다시 시작해도 데이터가 유지되어야 하는 경우에 사용해요.
|
|
64
|
+
* @param {string} key - 저장할 아이템의 키를 입력해요.
|
|
65
|
+
* @param {string} value - 저장할 아이템의 값을 입력해요.
|
|
66
|
+
* @returns {Promise<void>} 아이템을 성공적으로 저장하면 아무 값도 반환하지 않아요.
|
|
67
|
+
* @example
|
|
68
|
+
*
|
|
69
|
+
* ### `my-key`에 아이템 저장하기
|
|
70
|
+
* ```ts
|
|
71
|
+
* import { Storage } from '@apps-in-toss/framework';
|
|
72
|
+
*
|
|
73
|
+
* await Storage.setItem('my-key', 'value');
|
|
74
|
+
* ```
|
|
75
|
+
*/
|
|
76
|
+
setItem: (0, import_bridge_core.createAsyncBridge)("setStorageItem"),
|
|
77
|
+
/**
|
|
78
|
+
* @public
|
|
79
|
+
* @category 저장소
|
|
80
|
+
* @name removeItem
|
|
81
|
+
* @description 모바일 앱의 로컬 저장소에서 특정 키에 해당하는 아이템을 삭제해요.
|
|
82
|
+
* @param {string} key - 삭제할 아이템의 키를 입력해요.
|
|
83
|
+
* @returns {Promise<void>} 아이템을 삭제하면 아무 값도 반환하지 않아요.
|
|
84
|
+
* @example
|
|
85
|
+
*
|
|
86
|
+
* ### `my-key`에 저장된 아이템 삭제하기
|
|
87
|
+
* ```ts
|
|
88
|
+
* import { Storage } from '@apps-in-toss/framework';
|
|
89
|
+
*
|
|
90
|
+
* await Storage.removeItem('my-key');
|
|
91
|
+
* ```
|
|
92
|
+
*/
|
|
93
|
+
removeItem: (0, import_bridge_core.createAsyncBridge)("removeStorageItem"),
|
|
94
|
+
/**
|
|
95
|
+
* @public
|
|
96
|
+
* @category 저장소
|
|
97
|
+
* @name clearItems
|
|
98
|
+
* @description 모바일 앱의 로컬 저장소의 모든 아이템을 삭제해요.
|
|
99
|
+
* @returns {Promise<void>} 아이템을 삭제하면 아무 값도 반환하지 않고 저장소가 초기화돼요.
|
|
100
|
+
* @example
|
|
101
|
+
*
|
|
102
|
+
* ### 저장소 초기화하기
|
|
103
|
+
* ```ts
|
|
104
|
+
* import { Storage } from '@apps-in-toss/framework';
|
|
105
|
+
*
|
|
106
|
+
* await Storage.clearItems();
|
|
107
|
+
* ```
|
|
108
|
+
*/
|
|
109
|
+
clearItems: (0, import_bridge_core.createAsyncBridge)("clearItems")
|
|
110
|
+
};
|
|
111
|
+
|
|
112
|
+
// src/iap.ts
|
|
113
|
+
var import_bridge_core2 = require("@apps-in-toss/bridge-core");
|
|
114
|
+
var IAP = {
|
|
115
|
+
/**
|
|
116
|
+
* @public
|
|
117
|
+
* @category 인앱결제
|
|
118
|
+
* @name iapCreateOneTimePurchaseOrder
|
|
119
|
+
* @description
|
|
120
|
+
* 특정 인앱결제 주문서 페이지로 이동해요. 사용자가 상품 구매 버튼을 누르는 상황 등에 사용할 수 있어요. 사용자의 결제는 이동한 페이지에서 진행돼요. 만약 결제 중에 에러가 발생하면 에러 유형에 따라 에러 페이지로 이동해요.
|
|
121
|
+
* @param {IapCreateOneTimePurchaseOrderOptions} params - 인앱결제를 생성할 때 필요한 정보예요.
|
|
122
|
+
* @param {string} params.productId - 주문할 상품의 ID예요.
|
|
123
|
+
* @returns {Promise<IapCreateOneTimePurchaseOrderResult | undefined>} 결제에 성공하면 결제 결과 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 인앱결제를 실행할 수 없어서 `undefined`를 반환해요.
|
|
124
|
+
*
|
|
125
|
+
* @throw {code: "INVALID_PRODUCT_ID"} - 유효하지 않은 상품 ID이거나, 해당 상품이 존재하지 않을 때 발생해요.
|
|
126
|
+
* @throw {code: "PAYMENT_PENDING"} - 사용자가 요청한 결제가 아직 승인을 기다리고 있을 때 발생해요.
|
|
127
|
+
* @throw {code: "NETWORK_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
|
|
128
|
+
* @throw {code: "INVALID_USER_ENVIRONMENT"} - 특정 기기, 계정 또는 설정 환경에서 구매할 수 없는 상품일 때 발생해요.
|
|
129
|
+
* @throw {code: "ITEM_ALREADY_OWNED"} - 사용자가 이미 구매한 상품을 다시 구매하려고 할 때 발생해요.
|
|
130
|
+
* @throw {code: "APP_MARKET_VERIFICATION_FAILED"} - 사용자가 결제를 완료했지만, 앱스토어에서 사용자 정보 검증에 실패했을 때 발생해요. 사용자가 앱스토어에 문의해서 환불을 요청해야해요.
|
|
131
|
+
* @throw {code: "TOSS_SERVER_VERIFICATION_FAILED"} - 사용자가 결제를 완료했지만, 서버 전송에 실패해서 결제 정보를 저장할 수 없을 때 발생해요.
|
|
132
|
+
* @throw {code: "INTERNAL_ERROR"} - 서버 내부 문제로 요청을 처리할 수 없을 때 발생해요.
|
|
133
|
+
* @throw {code: "KOREAN_ACCOUNT_ONLY"} - iOS 환경에서 사용자의 계정이 한국 계정이 아닐 때 발생해요.
|
|
134
|
+
* @throw {code: "USER_CANCELED"} - 사용자가 결제를 완료하지 않고 주문서 페이지를 이탈했을 때 발생해요.
|
|
135
|
+
*/
|
|
136
|
+
createOneTimePurchaseOrder: (0, import_bridge_core2.createAsyncBridge)(
|
|
137
|
+
"iapCreateOneTimePurchaseOrder"
|
|
138
|
+
),
|
|
139
|
+
/**
|
|
140
|
+
* @public
|
|
141
|
+
* @category 인앱결제
|
|
142
|
+
* @name iapGetProductItemList
|
|
143
|
+
* @description 인앱결제로 구매할 수 있는 상품 목록을 가져와요. 상품 목록 화면에 진입할 때 호출해요.
|
|
144
|
+
* @returns {Promise<{ products: IapProductListItem[] } | undefined>} 상품 목록을 포함한 객체를 반환해요. 앱 버전이 최소 지원 버전(안드로이드 5.219.0, iOS 5.219.0)보다 낮으면 `undefined`를 반환해요.
|
|
145
|
+
*/
|
|
146
|
+
getProductItemList: (0, import_bridge_core2.createAsyncBridge)("iapGetProductItemList")
|
|
147
|
+
};
|
|
148
|
+
|
|
149
|
+
// src/getSafeAreaInsets.ts
|
|
150
|
+
var import_bridge_core3 = require("@apps-in-toss/bridge-core");
|
|
151
|
+
var getSafeAreaBottom = (0, import_bridge_core3.createConstantBridge)("getSafeAreaBottom");
|
|
152
|
+
var getSafeAreaTop = (0, import_bridge_core3.createConstantBridge)("getSafeAreaTop");
|
|
153
|
+
function getSafeAreaInsets() {
|
|
154
|
+
return { top: getSafeAreaTop(), bottom: getSafeAreaBottom() };
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
// src/googleAdMob.ts
|
|
158
|
+
var import_bridge_core4 = require("@apps-in-toss/bridge-core");
|
|
159
|
+
var GoogleAdMob = {
|
|
160
|
+
/**
|
|
161
|
+
* @public
|
|
162
|
+
* @category 광고
|
|
163
|
+
* @name loadAdMobInterstitialAd
|
|
164
|
+
* @description 앱 화면 전체를 덮는 전면 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
|
|
165
|
+
* @param {LoadAdMobInterstitialAdParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
|
|
166
|
+
* @param {LoadAdMobInterstitialAdOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
|
|
167
|
+
* @param {string} params.options.adUnitId 광고 단위 ID예요. 발급받은 전면 광고용 ID를 입력해요.
|
|
168
|
+
* @param {(event: LoadAdMobInterstitialAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobInterstitialAdEvent](/react-native/reference/framework/광고/LoadAdMobInterstitialAdEvent.html)를 참고하세요.
|
|
169
|
+
* @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
|
|
170
|
+
* @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
|
|
171
|
+
*
|
|
172
|
+
* @example
|
|
173
|
+
* ### 뷰 진입 시 전면광고 불러오기
|
|
174
|
+
* ```tsx
|
|
175
|
+
* import { GoogleAdMob } from '@apps-in-toss/framework';
|
|
176
|
+
* import { useEffect } from 'react';
|
|
177
|
+
* import { View, Text } from 'react-native';
|
|
178
|
+
*
|
|
179
|
+
* const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
|
|
180
|
+
*
|
|
181
|
+
* function Page() {
|
|
182
|
+
* useEffect(() => {
|
|
183
|
+
* if (GoogleAdMob.loadAdMobInterstitialAd.isSupported() !== true) {
|
|
184
|
+
* return;
|
|
185
|
+
* }
|
|
186
|
+
*
|
|
187
|
+
* const cleanup = GoogleAdMob.loadAdMobInterstitialAd({
|
|
188
|
+
* options: {
|
|
189
|
+
* adUnitId: AD_UNIT_ID,
|
|
190
|
+
* },
|
|
191
|
+
* onEvent: (event) => {
|
|
192
|
+
* switch (event.type) {
|
|
193
|
+
* case 'loaded':
|
|
194
|
+
* console.log('광고 로드 성공', event.data);
|
|
195
|
+
* break;
|
|
196
|
+
*
|
|
197
|
+
* case 'clicked':
|
|
198
|
+
* console.log('광고 클릭');
|
|
199
|
+
* break;
|
|
200
|
+
*
|
|
201
|
+
* case 'dismissed':
|
|
202
|
+
* console.log('광고 닫힘');
|
|
203
|
+
* break;
|
|
204
|
+
*
|
|
205
|
+
* case 'failedToShow':
|
|
206
|
+
* console.log('광고 보여주기 실패');
|
|
207
|
+
* break;
|
|
208
|
+
*
|
|
209
|
+
* case 'impression':
|
|
210
|
+
* console.log('광고 노출');
|
|
211
|
+
* break;
|
|
212
|
+
*
|
|
213
|
+
* case 'show':
|
|
214
|
+
* console.log('광고 컨텐츠 보여졌음');
|
|
215
|
+
* break;
|
|
216
|
+
* }
|
|
217
|
+
* },
|
|
218
|
+
* onError: (error) => {
|
|
219
|
+
* console.error('광고 불러오기 실패', error);
|
|
220
|
+
* },
|
|
221
|
+
* });
|
|
222
|
+
*
|
|
223
|
+
* return cleanup;
|
|
224
|
+
* }, []);
|
|
225
|
+
*
|
|
226
|
+
* return (
|
|
227
|
+
* <View>
|
|
228
|
+
* <Text>Page</Text>
|
|
229
|
+
* </View>
|
|
230
|
+
* );
|
|
231
|
+
* }
|
|
232
|
+
* ```
|
|
233
|
+
*/
|
|
234
|
+
loadAdMobInterstitialAd: Object.assign(
|
|
235
|
+
(0, import_bridge_core4.createEventBridge)("loadAdMobInterstitialAd"),
|
|
236
|
+
{
|
|
237
|
+
isSupported: (0, import_bridge_core4.createConstantBridge)("loadAdMobInterstitialAd_isSupported")
|
|
238
|
+
}
|
|
239
|
+
),
|
|
240
|
+
/**
|
|
241
|
+
* @public
|
|
242
|
+
* @category 광고
|
|
243
|
+
* @name showAdMobInterstitialAd
|
|
244
|
+
* @description 앱 화면 전체를 덮는 전면 광고를 사용자에게 노출해요. 이 함수는 `loadAdMobInterstitialAd` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
|
|
245
|
+
* @param {ShowAdMobInterstitialAdParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 ID와과 광고의 동작에 대한 콜백을 설정할 수 있어요.
|
|
246
|
+
* @param {ShowAdMobInterstitialAdOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
|
|
247
|
+
* @param {string} params.options.adUnitId 광고 단위 ID예요. `loadAdMobInterstitialAd` 로 불러온 전면 광고용 ID를 입력해요.
|
|
248
|
+
* @param {(event: ShowAdMobInterstitialAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobInterstitialAdEvent](/react-native/reference/framework/광고/ShowAdMobInterstitialAdEvent.html)를 참고하세요.
|
|
249
|
+
* @param {(reason: unknown) => void} [params.onError] 광고를 노출하지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
|
|
250
|
+
* @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
|
|
251
|
+
*
|
|
252
|
+
* @example
|
|
253
|
+
* ### 버튼 눌러 불러온 전면 광고 보여주기
|
|
254
|
+
* ```tsx
|
|
255
|
+
* import { GoogleAdMob } from '@apps-in-toss/framework';
|
|
256
|
+
* import { View, Text, Button } from 'react-native';
|
|
257
|
+
*
|
|
258
|
+
* const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
|
|
259
|
+
*
|
|
260
|
+
* function Page() {
|
|
261
|
+
* const handlePress = () => {
|
|
262
|
+
* if (GoogleAdMob.showAdMobInterstitialAd.isSupported() !== true) {
|
|
263
|
+
* return;
|
|
264
|
+
* }
|
|
265
|
+
*
|
|
266
|
+
* GoogleAdMob.showAdMobInterstitialAd({
|
|
267
|
+
* options: {
|
|
268
|
+
* adUnitId: AD_UNIT_ID,
|
|
269
|
+
* },
|
|
270
|
+
* onEvent: (event) => {
|
|
271
|
+
* switch (event.type) {
|
|
272
|
+
* case 'requested':
|
|
273
|
+
* console.log('광고 보여주기 요청 완료');
|
|
274
|
+
* break;
|
|
275
|
+
* }
|
|
276
|
+
* },
|
|
277
|
+
* onError: (error) => {
|
|
278
|
+
* console.error('광고 보여주기 실패', error);
|
|
279
|
+
* },
|
|
280
|
+
* });
|
|
281
|
+
* }
|
|
282
|
+
*
|
|
283
|
+
* return (
|
|
284
|
+
* <Button onPress={handlePress} title="광고 보기" />
|
|
285
|
+
* );
|
|
286
|
+
* }
|
|
287
|
+
* ```
|
|
288
|
+
*/
|
|
289
|
+
showAdMobInterstitialAd: Object.assign(
|
|
290
|
+
(0, import_bridge_core4.createEventBridge)("showAdMobInterstitialAd"),
|
|
291
|
+
{
|
|
292
|
+
isSupported: (0, import_bridge_core4.createConstantBridge)("showAdMobInterstitialAd_isSupported")
|
|
293
|
+
}
|
|
294
|
+
),
|
|
295
|
+
/**
|
|
296
|
+
* @public
|
|
297
|
+
* @category 광고
|
|
298
|
+
* @name loadAdMobRewardedAd
|
|
299
|
+
* @description 사용자가 광고를 끝까지 시청하면 리워드를 제공할 수 있는 보상형 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
|
|
300
|
+
* @param {LoadAdMobRewardedAdParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
|
|
301
|
+
* @param {LoadAdMobRewardedAdOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
|
|
302
|
+
* @param {string} params.options.adUnitId 광고 단위 ID예요. 발급받은 보상형 광고용 ID를 입력해요.
|
|
303
|
+
* @param {(event: LoadAdMobRewardedAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobRewardedAdEvent](/react-native/reference/framework/광고/LoadAdMobRewardedAdEvent.html)를 참고하세요.
|
|
304
|
+
* @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
|
|
305
|
+
* @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
|
|
306
|
+
*
|
|
307
|
+
* @example
|
|
308
|
+
* ### 뷰 진입 시 보상형 광고 불러오기
|
|
309
|
+
* ```tsx
|
|
310
|
+
* import { GoogleAdMob } from '@apps-in-toss/framework';
|
|
311
|
+
* import { useEffect } from 'react';
|
|
312
|
+
* import { View, Text } from 'react-native';
|
|
313
|
+
*
|
|
314
|
+
* const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
|
|
315
|
+
*
|
|
316
|
+
* function Page() {
|
|
317
|
+
* useEffect(() => {
|
|
318
|
+
* if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
|
|
319
|
+
* return;
|
|
320
|
+
* }
|
|
321
|
+
*
|
|
322
|
+
* const cleanup = GoogleAdMob.loadAdMobRewardedAd({
|
|
323
|
+
* options: {
|
|
324
|
+
* adUnitId: AD_UNIT_ID,
|
|
325
|
+
* },
|
|
326
|
+
* onEvent: (event) => {
|
|
327
|
+
* switch (event.type) {
|
|
328
|
+
* case 'loaded':
|
|
329
|
+
* console.log('광고 로드 성공', event.data);
|
|
330
|
+
* break;
|
|
331
|
+
*
|
|
332
|
+
* case 'clicked':
|
|
333
|
+
* console.log('광고 클릭');
|
|
334
|
+
* break;
|
|
335
|
+
*
|
|
336
|
+
* case 'dismissed':
|
|
337
|
+
* console.log('광고 닫힘');
|
|
338
|
+
* break;
|
|
339
|
+
*
|
|
340
|
+
* case 'failedToShow':
|
|
341
|
+
* console.log('광고 보여주기 실패');
|
|
342
|
+
* break;
|
|
343
|
+
*
|
|
344
|
+
* case 'impression':
|
|
345
|
+
* console.log('광고 노출');
|
|
346
|
+
* break;
|
|
347
|
+
*
|
|
348
|
+
* case 'show':
|
|
349
|
+
* console.log('광고 컨텐츠 보여졌음');
|
|
350
|
+
* break;
|
|
351
|
+
*
|
|
352
|
+
* case 'userEarnedReward':
|
|
353
|
+
* console.log('사용자가 광고 시청을 완료했음');
|
|
354
|
+
* break;
|
|
355
|
+
* }
|
|
356
|
+
* },
|
|
357
|
+
* onError: (error) => {
|
|
358
|
+
* console.error('광고 불러오기 실패', error);
|
|
359
|
+
* },
|
|
360
|
+
* });
|
|
361
|
+
*
|
|
362
|
+
* return cleanup;
|
|
363
|
+
* }, []);
|
|
364
|
+
*
|
|
365
|
+
* return (
|
|
366
|
+
* <View>
|
|
367
|
+
* <Text>Page</Text>
|
|
368
|
+
* </View>
|
|
369
|
+
* );
|
|
370
|
+
* }
|
|
371
|
+
* ```
|
|
372
|
+
*/
|
|
373
|
+
loadAdMobRewardedAd: Object.assign(
|
|
374
|
+
(0, import_bridge_core4.createEventBridge)("loadAdMobRewardedAd"),
|
|
375
|
+
{
|
|
376
|
+
isSupported: (0, import_bridge_core4.createConstantBridge)("loadAdMobRewardedAd_isSupported")
|
|
377
|
+
}
|
|
378
|
+
),
|
|
379
|
+
/**
|
|
380
|
+
* @public
|
|
381
|
+
* @category 광고
|
|
382
|
+
* @name showAdMobRewardedAd
|
|
383
|
+
* @description 사용자가 광고를 끝까지 보면 리워드를 받을 수 있도록, 보상형 광고를 화면에 보여줘요. 이 함수는 `loadAdMobRewardedAd` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
|
|
384
|
+
* @param {ShowAdMobRewardedAdParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
|
|
385
|
+
* @param {ShowAdMobRewardedAdOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
|
|
386
|
+
* @param {string} params.options.adUnitId 광고 단위 ID예요. `loadAdMobRewardedAd` 로 불러온 보상형 광고용 ID를 입력해요.
|
|
387
|
+
* @param {(event: ShowAdMobRewardedAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobRewardedAdEvent](/react-native/reference/framework/광고/ShowAdMobRewardedAdEvent.html)를 참고하세요.
|
|
388
|
+
* @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
|
|
389
|
+
* @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
|
|
390
|
+
*
|
|
391
|
+
* @example
|
|
392
|
+
* ### 버튼 눌러 불러온 보상형 광고 보여주기
|
|
393
|
+
* ```tsx
|
|
394
|
+
* import { GoogleAdMob } from '@apps-in-toss/framework';
|
|
395
|
+
* import { View, Text, Button } from 'react-native';
|
|
396
|
+
*
|
|
397
|
+
* const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
|
|
398
|
+
*
|
|
399
|
+
* function Page() {
|
|
400
|
+
* const handlePress = () => {
|
|
401
|
+
* if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
|
|
402
|
+
* return;
|
|
403
|
+
* }
|
|
404
|
+
*
|
|
405
|
+
* GoogleAdMob.showAdMobRewardedAd({
|
|
406
|
+
* options: {
|
|
407
|
+
* adUnitId: AD_UNIT_ID,
|
|
408
|
+
* },
|
|
409
|
+
* onEvent: (event) => {
|
|
410
|
+
* switch (event.type) {
|
|
411
|
+
* case 'requested':
|
|
412
|
+
* console.log('광고 보여주기 요청 완료');
|
|
413
|
+
* break;
|
|
414
|
+
* }
|
|
415
|
+
* },
|
|
416
|
+
* onError: (error) => {
|
|
417
|
+
* console.error('광고 보여주기 실패', error);
|
|
418
|
+
* },
|
|
419
|
+
* });
|
|
420
|
+
* }
|
|
421
|
+
*
|
|
422
|
+
* return (
|
|
423
|
+
* <Button onPress={handlePress} title="광고 보기" />
|
|
424
|
+
* );
|
|
425
|
+
* }
|
|
426
|
+
* ```
|
|
427
|
+
*/
|
|
428
|
+
showAdMobRewardedAd: Object.assign(
|
|
429
|
+
(0, import_bridge_core4.createEventBridge)("showAdMobRewardedAd"),
|
|
430
|
+
{
|
|
431
|
+
isSupported: (0, import_bridge_core4.createConstantBridge)("showAdMobRewardedAd_isSupported")
|
|
432
|
+
}
|
|
433
|
+
)
|
|
434
|
+
};
|
|
435
|
+
|
|
436
|
+
// src/graniteEvent.ts
|
|
437
|
+
var import_bridge_core5 = require("@apps-in-toss/bridge-core");
|
|
438
|
+
var graniteEvent = {
|
|
439
|
+
addEventListener: (event, {
|
|
440
|
+
onEvent,
|
|
441
|
+
onError,
|
|
442
|
+
options
|
|
443
|
+
}) => (0, import_bridge_core5.createEventBridge)(event)({
|
|
444
|
+
onEvent,
|
|
445
|
+
onError: onError ?? (() => {
|
|
446
|
+
}),
|
|
447
|
+
options
|
|
448
|
+
})
|
|
449
|
+
};
|
|
450
|
+
|
|
451
|
+
// src/isMinVersionSupported.ts
|
|
452
|
+
var import_bridge_core6 = require("@apps-in-toss/bridge-core");
|
|
453
|
+
|
|
454
|
+
// src/utils/compareVersion.ts
|
|
455
|
+
var SEMVER_REGEX = /^[v^~<>=]*?(\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+)(?:\.([x*]|\d+))?(?:-([\da-z\\-]+(?:\.[\da-z\\-]+)*))?(?:\+[\da-z\\-]+(?:\.[\da-z\\-]+)*)?)?)?$/i;
|
|
456
|
+
var isWildcard = (val) => ["*", "x", "X"].includes(val);
|
|
457
|
+
var tryParse = (val) => {
|
|
458
|
+
const num = parseInt(val, 10);
|
|
459
|
+
return isNaN(num) ? val : num;
|
|
460
|
+
};
|
|
461
|
+
var coerceTypes = (a, b) => {
|
|
462
|
+
return typeof a === typeof b ? [a, b] : [String(a), String(b)];
|
|
463
|
+
};
|
|
464
|
+
var compareValues = (a, b) => {
|
|
465
|
+
if (isWildcard(a) || isWildcard(b)) {
|
|
466
|
+
return 0;
|
|
467
|
+
}
|
|
468
|
+
const [aVal, bVal] = coerceTypes(tryParse(a), tryParse(b));
|
|
469
|
+
if (aVal > bVal) {
|
|
470
|
+
return 1;
|
|
471
|
+
}
|
|
472
|
+
if (aVal < bVal) {
|
|
473
|
+
return -1;
|
|
474
|
+
}
|
|
475
|
+
return 0;
|
|
476
|
+
};
|
|
477
|
+
var parseVersion = (version) => {
|
|
478
|
+
if (typeof version !== "string") {
|
|
479
|
+
throw new TypeError("Invalid argument: expected a string");
|
|
480
|
+
}
|
|
481
|
+
const match = version.match(SEMVER_REGEX);
|
|
482
|
+
if (!match) {
|
|
483
|
+
throw new Error(`Invalid semver: '${version}'`);
|
|
484
|
+
}
|
|
485
|
+
const [, major, minor, patch, build, preRelease] = match;
|
|
486
|
+
return [major, minor, patch, build, preRelease];
|
|
487
|
+
};
|
|
488
|
+
var compareSegments = (a, b) => {
|
|
489
|
+
const maxLength = Math.max(a.length, b.length);
|
|
490
|
+
for (let i = 0; i < maxLength; i++) {
|
|
491
|
+
const segA = a[i] ?? "0";
|
|
492
|
+
const segB = b[i] ?? "0";
|
|
493
|
+
const result = compareValues(segA, segB);
|
|
494
|
+
if (result !== 0) {
|
|
495
|
+
return result;
|
|
496
|
+
}
|
|
497
|
+
}
|
|
498
|
+
return 0;
|
|
499
|
+
};
|
|
500
|
+
var compareVersions = (v1, v2) => {
|
|
501
|
+
const seg1 = parseVersion(v1);
|
|
502
|
+
const seg2 = parseVersion(v2);
|
|
503
|
+
const preRelease1 = seg1.pop();
|
|
504
|
+
const preRelease2 = seg2.pop();
|
|
505
|
+
const mainCompare = compareSegments(seg1, seg2);
|
|
506
|
+
if (mainCompare !== 0) {
|
|
507
|
+
return mainCompare;
|
|
508
|
+
}
|
|
509
|
+
if (preRelease1 && preRelease2) {
|
|
510
|
+
return compareSegments(preRelease1.split("."), preRelease2.split("."));
|
|
511
|
+
}
|
|
512
|
+
if (preRelease1) {
|
|
513
|
+
return -1;
|
|
514
|
+
}
|
|
515
|
+
if (preRelease2) {
|
|
516
|
+
return 1;
|
|
517
|
+
}
|
|
518
|
+
return 0;
|
|
519
|
+
};
|
|
520
|
+
|
|
521
|
+
// src/isMinVersionSupported.ts
|
|
522
|
+
function isMinVersionSupported(minVersions) {
|
|
523
|
+
const operationalEnvironment = (0, import_bridge_core6.createConstantBridge)("getOperationalEnvironment")();
|
|
524
|
+
if (operationalEnvironment === "sandbox") {
|
|
525
|
+
return true;
|
|
526
|
+
}
|
|
527
|
+
const currentVersion = (0, import_bridge_core6.createConstantBridge)("getTossAppVersion")();
|
|
528
|
+
const isIOS = (0, import_bridge_core6.createConstantBridge)("getPlatformOS")() === "ios";
|
|
529
|
+
const minVersion = isIOS ? minVersions.ios : minVersions.android;
|
|
530
|
+
if (minVersion === void 0) {
|
|
531
|
+
return false;
|
|
532
|
+
}
|
|
533
|
+
if (minVersion === "always") {
|
|
534
|
+
return true;
|
|
535
|
+
}
|
|
536
|
+
if (minVersion === "never") {
|
|
537
|
+
return false;
|
|
538
|
+
}
|
|
539
|
+
return compareVersions(currentVersion, minVersion) >= 0;
|
|
540
|
+
}
|
|
541
|
+
|
|
542
|
+
// src/appsInTossEvent.ts
|
|
543
|
+
var import_bridge_core7 = require("@apps-in-toss/bridge-core");
|
|
544
|
+
var appsInTossEvent = {
|
|
545
|
+
addEventListener: (event, {
|
|
546
|
+
onEvent,
|
|
547
|
+
onError,
|
|
548
|
+
options
|
|
549
|
+
}) => (0, import_bridge_core7.createEventBridge)(event)({
|
|
550
|
+
onEvent,
|
|
551
|
+
onError: onError ?? (() => {
|
|
552
|
+
}),
|
|
553
|
+
options
|
|
554
|
+
})
|
|
555
|
+
};
|
|
556
|
+
|
|
557
|
+
// src/env.ts
|
|
558
|
+
var import_bridge_core8 = require("@apps-in-toss/bridge-core");
|
|
559
|
+
var env = {
|
|
560
|
+
getDeploymentId: (0, import_bridge_core8.createConstantBridge)("getDeploymentId")
|
|
561
|
+
};
|
|
562
|
+
|
|
563
|
+
// src/global.ts
|
|
564
|
+
var import_bridge_core9 = require("@apps-in-toss/bridge-core");
|
|
565
|
+
var deploymentId = (0, import_bridge_core9.createConstantBridge)("deploymentId");
|
|
566
|
+
var brandDisplayName = (0, import_bridge_core9.createConstantBridge)("brandDisplayName");
|
|
567
|
+
var brandIcon = (0, import_bridge_core9.createConstantBridge)("brandIcon");
|
|
568
|
+
var brandPrimaryColor = (0, import_bridge_core9.createConstantBridge)("brandPrimaryColor");
|
|
569
|
+
var brandBridgeColorMode = (0, import_bridge_core9.createConstantBridge)("brandBridgeColorMode");
|
|
570
|
+
var getAppsInTossGlobals = () => {
|
|
571
|
+
return {
|
|
572
|
+
deploymentId: deploymentId(),
|
|
573
|
+
brandDisplayName: brandDisplayName(),
|
|
574
|
+
brandIcon: brandIcon(),
|
|
575
|
+
brandPrimaryColor: brandPrimaryColor(),
|
|
576
|
+
brandBridgeColorMode: brandBridgeColorMode()
|
|
577
|
+
};
|
|
578
|
+
};
|
|
579
|
+
|
|
580
|
+
// src/tdsEvent.ts
|
|
581
|
+
var import_bridge_core10 = require("@apps-in-toss/bridge-core");
|
|
582
|
+
var tdsEvent = {
|
|
583
|
+
/**
|
|
584
|
+
* @public
|
|
585
|
+
* @category TDS
|
|
586
|
+
* @name addEventListener
|
|
587
|
+
* @description 이벤트를 추가해요.
|
|
588
|
+
* @param {string} event 이벤트 이름예요.
|
|
589
|
+
* @param {TdsEvent[K]['onEvent']} onEvent 이벤트 핸들러예요.
|
|
590
|
+
* @param {TdsEvent[K]['onError']} onError 이벤트 에러 핸들러예요.
|
|
591
|
+
* @param {TdsEvent[K]['options']} options 이벤트 옵션예요.
|
|
592
|
+
* @returns {void} 이벤트를 추가했을 때 아무 값도 반환하지 않아요.
|
|
593
|
+
* @example
|
|
594
|
+
* ### 네비게이션 악세서리 이벤트 추가하기
|
|
595
|
+
* ```tsx
|
|
596
|
+
* import { tdsEvent } from '@apps-in-toss/framework';
|
|
597
|
+
*
|
|
598
|
+
* tdsEvent.addEventListener('navigationAccessoryEvent', {
|
|
599
|
+
* onEvent: ({ id }) => {
|
|
600
|
+
* if(id === 'heart') {
|
|
601
|
+
* router.push('/heart');
|
|
602
|
+
* }
|
|
603
|
+
* },
|
|
604
|
+
* });
|
|
605
|
+
* ```
|
|
606
|
+
*/
|
|
607
|
+
addEventListener: (event, {
|
|
608
|
+
onEvent,
|
|
609
|
+
onError,
|
|
610
|
+
options
|
|
611
|
+
}) => (0, import_bridge_core10.createEventBridge)(event)({
|
|
612
|
+
onEvent,
|
|
613
|
+
onError: onError ?? (() => {
|
|
614
|
+
}),
|
|
615
|
+
options
|
|
616
|
+
})
|
|
617
|
+
};
|
|
618
|
+
|
|
619
|
+
// src/partner.ts
|
|
620
|
+
var import_bridge_core11 = require("@apps-in-toss/bridge-core");
|
|
621
|
+
var partner = {
|
|
622
|
+
/**
|
|
623
|
+
* @public
|
|
624
|
+
* @category 파트너
|
|
625
|
+
* @name addAccessoryButton
|
|
626
|
+
* @description 상단 네비게이션의 악세서리 버튼을 추가해요. callback에 대한 정의는 `tdsEvent.addEventListener("navigationAccessoryEvent", callback)`를 참고해주세요.
|
|
627
|
+
* @param {AddAccessoryButtonOptions} options - 악세서리 버튼의 고유 ID예요.
|
|
628
|
+
* @returns {void} 악세서리 버튼을 추가했을 때 아무 값도 반환하지 않아요.
|
|
629
|
+
* @example
|
|
630
|
+
* ```tsx
|
|
631
|
+
* import { partner } from '@apps-in-toss/framework';
|
|
632
|
+
*
|
|
633
|
+
* partner.addAccessoryButton({
|
|
634
|
+
* id: 'heart',
|
|
635
|
+
* type: 'icon',
|
|
636
|
+
* name: 'icon-heart-mono',
|
|
637
|
+
* alt: '하트',
|
|
638
|
+
* });
|
|
639
|
+
*
|
|
640
|
+
* partner.addAccessoryButton({
|
|
641
|
+
* id: ['heart', 'heart2'],
|
|
642
|
+
* type: 'icon-double',
|
|
643
|
+
* leftIconName: 'icon-heart-mono',
|
|
644
|
+
* leftIconAlt: '하트',
|
|
645
|
+
* rightIconName: 'icon-heart-mono',
|
|
646
|
+
* rightIconAlt: '하트',
|
|
647
|
+
* });
|
|
648
|
+
* ```
|
|
649
|
+
*/
|
|
650
|
+
addAccessoryButton: (0, import_bridge_core11.createAsyncBridge)("addAccessoryButton"),
|
|
651
|
+
/**
|
|
652
|
+
* @public
|
|
653
|
+
* @category 파트너
|
|
654
|
+
* @name removeAccessoryButton
|
|
655
|
+
* @description 상단 네비게이션의 악세서리 버튼을 제거해요.
|
|
656
|
+
* @returns {void} 악세서리 버튼을 제거했을 때 아무 값도 반환하지 않아요.
|
|
657
|
+
* @example
|
|
658
|
+
* ```tsx
|
|
659
|
+
* import { partner } from '@apps-in-toss/framework';
|
|
660
|
+
*
|
|
661
|
+
* partner.removeAccessoryButton();
|
|
662
|
+
* ```
|
|
663
|
+
*/
|
|
664
|
+
removeAccessoryButton: (0, import_bridge_core11.createAsyncBridge)("removeAccessoryButton")
|
|
665
|
+
};
|
|
666
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
667
|
+
0 && (module.exports = {
|
|
668
|
+
GoogleAdMob,
|
|
669
|
+
IAP,
|
|
670
|
+
Storage,
|
|
671
|
+
appsInTossEvent,
|
|
672
|
+
env,
|
|
673
|
+
getAppsInTossGlobals,
|
|
674
|
+
getSafeAreaInsets,
|
|
675
|
+
graniteEvent,
|
|
676
|
+
isMinVersionSupported,
|
|
677
|
+
partner,
|
|
678
|
+
tdsEvent,
|
|
679
|
+
...require("@apps-in-toss/bridge-core")
|
|
680
|
+
});
|