@apps-in-toss/framework 0.0.22 → 0.0.24
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/dist/index.cjs +686 -165
- package/dist/index.d.cts +664 -343
- package/dist/index.d.ts +664 -343
- package/dist/index.js +653 -137
- package/package.json +10 -8
- package/src/async-bridges.ts +1 -1
package/dist/index.d.cts
CHANGED
|
@@ -1,12 +1,23 @@
|
|
|
1
|
+
import * as react from 'react';
|
|
1
2
|
import { ComponentType, PropsWithChildren } from 'react';
|
|
2
|
-
import { InitialProps, BedrockProps } from 'react-native-bedrock';
|
|
3
|
-
import { EmitterSubscription } from 'react-native';
|
|
4
3
|
import * as react_jsx_runtime from 'react/jsx-runtime';
|
|
4
|
+
import * as _apps_in_toss_analytics from '@apps-in-toss/analytics';
|
|
5
|
+
export * from '@apps-in-toss/analytics';
|
|
6
|
+
import { InitialProps, BedrockProps, BedrockEventDefinition, BedrockEvent } from 'react-native-bedrock';
|
|
7
|
+
import { EmitterSubscription } from 'react-native';
|
|
5
8
|
import { PartnerWebViewScreenProps, ExternalWebViewScreenProps } from '@toss-design-system/react-native';
|
|
6
9
|
import { WebViewProps as WebViewProps$1 } from '@react-native-bedrock/native/react-native-webview';
|
|
7
10
|
|
|
8
|
-
|
|
9
|
-
|
|
11
|
+
interface AppsInTossProps {
|
|
12
|
+
context: BedrockProps['context'];
|
|
13
|
+
analytics?: {
|
|
14
|
+
/**
|
|
15
|
+
* 분석 로그 출력 여부를 설정해요. 기본값은 `__DEV__` 예요.
|
|
16
|
+
*/
|
|
17
|
+
debug?: boolean;
|
|
18
|
+
};
|
|
19
|
+
}
|
|
20
|
+
declare function registerApp(container: ComponentType<PropsWithChildren<InitialProps>>, { context, analytics }: AppsInTossProps): (initialProps: InitialProps) => JSX.Element;
|
|
10
21
|
|
|
11
22
|
declare const AppsInToss: {
|
|
12
23
|
registerApp: typeof registerApp;
|
|
@@ -116,7 +127,7 @@ interface ImageResponse {
|
|
|
116
127
|
dataUri: string;
|
|
117
128
|
}
|
|
118
129
|
|
|
119
|
-
interface StartUpdateLocationOptions {
|
|
130
|
+
interface StartUpdateLocationOptions$1 {
|
|
120
131
|
/**
|
|
121
132
|
* 위치 정확도를 설정해요.
|
|
122
133
|
*/
|
|
@@ -204,397 +215,552 @@ interface UpdateLocationEventEmitter extends EventEmitterSchema<'updateLocation'
|
|
|
204
215
|
declare function startUpdateLocation(eventParams: {
|
|
205
216
|
onEvent: (response: Location) => void;
|
|
206
217
|
onError: (error: unknown) => void;
|
|
207
|
-
options: StartUpdateLocationOptions;
|
|
218
|
+
options: StartUpdateLocationOptions$1;
|
|
208
219
|
}): () => void;
|
|
209
220
|
|
|
210
221
|
/**
|
|
211
222
|
* @public
|
|
212
|
-
* @category
|
|
213
|
-
* @name
|
|
214
|
-
* @description
|
|
215
|
-
* @
|
|
216
|
-
*
|
|
217
|
-
*
|
|
218
|
-
*
|
|
219
|
-
*
|
|
220
|
-
*
|
|
221
|
-
*
|
|
222
|
-
*
|
|
223
|
-
*
|
|
224
|
-
*
|
|
225
|
-
*
|
|
223
|
+
* @category 광고
|
|
224
|
+
* @name AdMobFullScreenEvent
|
|
225
|
+
* @description 앱 화면을 덮는 광고(예: 전면 광고, 보상형 광고)를 사용하는 경우에 발생하는 이벤트 타입이에요.
|
|
226
|
+
* @example
|
|
227
|
+
* ### 광고 이벤트 처리하기
|
|
228
|
+
* ```ts
|
|
229
|
+
* function handleEvent(event: AdMobFullScreenEvent) {
|
|
230
|
+
* switch (event.type) {
|
|
231
|
+
* case 'clicked':
|
|
232
|
+
* console.log('광고가 클릭됐어요.');
|
|
233
|
+
* break;
|
|
234
|
+
*
|
|
235
|
+
* case 'dismissed':
|
|
236
|
+
* console.log('광고가 닫혔어요.');
|
|
237
|
+
* break;
|
|
238
|
+
*
|
|
239
|
+
* case 'failedToShow':
|
|
240
|
+
* console.log('광고가 보여지지 않았어요.');
|
|
241
|
+
* break;
|
|
242
|
+
*
|
|
243
|
+
* case 'impression':
|
|
244
|
+
* console.log('광고가 노출됐어요.');
|
|
245
|
+
* break;
|
|
246
|
+
*
|
|
247
|
+
* case 'show':
|
|
248
|
+
* console.log('광고가 보여졌어요.');
|
|
249
|
+
* break;
|
|
250
|
+
* }
|
|
251
|
+
* }
|
|
252
|
+
* ```
|
|
226
253
|
*/
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
254
|
+
type AdMobFullScreenEvent = AdClicked | AdDismissed | AdFailedToShow | AdImpression | AdShow;
|
|
255
|
+
type AdClicked = {
|
|
256
|
+
type: 'clicked';
|
|
257
|
+
};
|
|
258
|
+
type AdDismissed = {
|
|
259
|
+
type: 'dismissed';
|
|
260
|
+
};
|
|
261
|
+
type AdFailedToShow = {
|
|
262
|
+
type: 'failedToShow';
|
|
263
|
+
};
|
|
264
|
+
type AdImpression = {
|
|
265
|
+
type: 'impression';
|
|
266
|
+
};
|
|
267
|
+
type AdShow = {
|
|
268
|
+
type: 'show';
|
|
269
|
+
};
|
|
270
|
+
interface AdMobHandlerParams<Options = void, Event = AdMobFullScreenEvent> {
|
|
271
|
+
options: Options;
|
|
272
|
+
onEvent: (event: Event) => void;
|
|
273
|
+
onError: (error: unknown) => void;
|
|
274
|
+
}
|
|
275
|
+
/**
|
|
276
|
+
* @public
|
|
277
|
+
* @category 광고
|
|
278
|
+
* @name ResponseInfo
|
|
279
|
+
* @description 광고 로드 응답 정보를 담고 있는 객체예요.
|
|
280
|
+
* @property {Array<AdNetworkResponseInfo>} adNetworkInfoArray 광고 네트워크 응답 정보 배열예요.
|
|
281
|
+
* @property {AdNetworkResponseInfo | null} loadedAdNetworkInfo 로드된 광고 네트워크 응답 정보예요.
|
|
282
|
+
* @property {string | null} responseId 광고 응답 ID예요.
|
|
283
|
+
*/
|
|
284
|
+
interface ResponseInfo {
|
|
285
|
+
adNetworkInfoArray: Array<AdNetworkResponseInfo>;
|
|
286
|
+
loadedAdNetworkInfo: AdNetworkResponseInfo | null;
|
|
287
|
+
responseId: string | null;
|
|
288
|
+
}
|
|
289
|
+
/**
|
|
290
|
+
* @public
|
|
291
|
+
* @category 광고
|
|
292
|
+
* @name AdNetworkResponseInfo
|
|
293
|
+
* @description 광고 네트워크 응답 정보를 담고 있는 객체예요.
|
|
294
|
+
* @property {string} adSourceId 광고 소스 ID예요.
|
|
295
|
+
* @property {string} adSourceName 광고 소스 이름이예요.
|
|
296
|
+
* @property {string} adSourceInstanceId 광고 소스 인스턴스 ID예요.
|
|
297
|
+
* @property {string} adSourceInstanceName 광고 소스 인스턴스 이름이예요.
|
|
298
|
+
* @property {string | null} adNetworkClassName 광고 네트워크 클래스 이름이예요.
|
|
299
|
+
*/
|
|
300
|
+
interface AdNetworkResponseInfo {
|
|
301
|
+
adSourceId: string;
|
|
302
|
+
adSourceName: string;
|
|
303
|
+
adSourceInstanceId: string;
|
|
304
|
+
adSourceInstanceName: string;
|
|
305
|
+
adNetworkClassName: string | null;
|
|
306
|
+
}
|
|
307
|
+
/**
|
|
308
|
+
* @public
|
|
309
|
+
* @category 광고
|
|
310
|
+
* @name InterstitialAd
|
|
311
|
+
* @description 전면 광고의 ID와 응답 정보를 담고 있는 객체예요. 광고를 로드한 뒤, 관련 정보를 확인할 때 유용해요.
|
|
312
|
+
* @property {string} adUnitId 광고 ID예요.
|
|
313
|
+
* @property {ResponseInfo} responseInfo 광고 로드 응답 정보예요. 자세한 내용은 [ResponseInfo](/react-native/reference/framework/광고/ResponseInfo.html)를 참고하세요.
|
|
314
|
+
*/
|
|
315
|
+
interface InterstitialAd {
|
|
316
|
+
adUnitId: string;
|
|
317
|
+
responseInfo: ResponseInfo;
|
|
318
|
+
}
|
|
319
|
+
/**
|
|
320
|
+
* @public
|
|
321
|
+
* @category 광고
|
|
322
|
+
* @name RewardedAd
|
|
323
|
+
* @description 보상형 광고의 ID와 응답 정보를 담고 있는 객체예요. 광고를 로드한 뒤, 관련 정보를 확인할 때 유용해요.
|
|
324
|
+
* @property {string} adUnitId 광고 ID예요.
|
|
325
|
+
* @property {ResponseInfo} responseInfo 광고 로드 응답 정보예요. 자세한 내용은 [ResponseInfo](/react-native/reference/framework/광고/ResponseInfo.html)를 참고하세요.
|
|
326
|
+
*/
|
|
327
|
+
interface RewardedAd {
|
|
328
|
+
adUnitId: string;
|
|
329
|
+
responseInfo: ResponseInfo;
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
interface LoadAdMobInterstitialAdOptions {
|
|
276
333
|
/**
|
|
277
|
-
*
|
|
278
|
-
*
|
|
279
|
-
* - 'USE': 사용(기본값)
|
|
280
|
-
* - 'NO_USE': 할부 미사용
|
|
334
|
+
* 광고 단위 ID
|
|
281
335
|
*/
|
|
282
|
-
|
|
336
|
+
adUnitId: string;
|
|
283
337
|
}
|
|
284
338
|
/**
|
|
285
339
|
* @public
|
|
286
|
-
* @category
|
|
287
|
-
* @name
|
|
288
|
-
* @description
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
* @
|
|
296
|
-
* @
|
|
297
|
-
* @
|
|
298
|
-
* @
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
* @
|
|
340
|
+
* @category 광고
|
|
341
|
+
* @name LoadAdMobInterstitialAdEvent
|
|
342
|
+
* @description 전면 광고를 불러오는 함수에서 발생하는 이벤트 타입이에요. `loaded` 이벤트가 발생하면 광고를 성공적으로 불러온 거예요. 이때 [InterstitialAd](/react-native/reference/framework/광고/InterstitialAd.html) 객체가 함께 반환돼요.
|
|
343
|
+
*/
|
|
344
|
+
type LoadAdMobInterstitialAdEvent = AdMobFullScreenEvent | {
|
|
345
|
+
type: 'loaded';
|
|
346
|
+
data: InterstitialAd;
|
|
347
|
+
};
|
|
348
|
+
/**
|
|
349
|
+
* @public
|
|
350
|
+
* @category 광고
|
|
351
|
+
* @name LoadAdMobInterstitialAdParams
|
|
352
|
+
* @description 전면 광고를 불러오는 함수에 필요한 옵션 객체예요.
|
|
353
|
+
*/
|
|
354
|
+
type LoadAdMobInterstitialAdParams = AdMobHandlerParams<LoadAdMobInterstitialAdOptions, LoadAdMobInterstitialAdEvent>;
|
|
355
|
+
/**
|
|
356
|
+
* @public
|
|
357
|
+
* @category 광고
|
|
358
|
+
* @name loadAdMobInterstitialAd
|
|
359
|
+
* @description 앱 화면 전체를 덮는 전면 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
|
|
360
|
+
* @param {LoadAdMobInterstitialAdParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
|
|
361
|
+
* @param {LoadAdMobInterstitialAdOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
|
|
362
|
+
* @param {string} params.options.adUnitId 광고 단위 ID예요. 발급받은 전면 광고용 ID를 입력해요.
|
|
363
|
+
* @param {(event: LoadAdMobInterstitialAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobInterstitialAdEvent](/react-native/reference/framework/광고/LoadAdMobInterstitialAdEvent.html)를 참고하세요.
|
|
364
|
+
* @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
|
|
365
|
+
* @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
|
|
303
366
|
*
|
|
304
367
|
* @example
|
|
305
|
-
* ###
|
|
306
|
-
*
|
|
368
|
+
* ### 뷰 진입 시 전면광고 불러오기
|
|
307
369
|
* ```tsx
|
|
308
|
-
* import {
|
|
370
|
+
* import { GoogleAdMob } from '@apps-in-toss/framework';
|
|
371
|
+
* import { useEffect } from 'react';
|
|
372
|
+
* import { View, Text } from 'react-native';
|
|
309
373
|
*
|
|
310
|
-
*
|
|
311
|
-
*
|
|
312
|
-
*
|
|
313
|
-
*
|
|
314
|
-
*
|
|
315
|
-
*
|
|
316
|
-
*
|
|
317
|
-
*
|
|
318
|
-
*
|
|
319
|
-
*
|
|
320
|
-
*
|
|
374
|
+
* const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
|
|
375
|
+
*
|
|
376
|
+
* function Page() {
|
|
377
|
+
* useEffect(() => {
|
|
378
|
+
* if (GoogleAdMob.loadAdMobInterstitialAd.isSupported() !== true) {
|
|
379
|
+
* return;
|
|
380
|
+
* }
|
|
381
|
+
*
|
|
382
|
+
* const cleanup = GoogleAdMob.loadAdMobInterstitialAd({
|
|
383
|
+
* options: {
|
|
384
|
+
* adUnitId: AD_UNIT_ID,
|
|
385
|
+
* },
|
|
386
|
+
* onEvent: (event) => {
|
|
387
|
+
* switch (event.type) {
|
|
388
|
+
* case 'loaded':
|
|
389
|
+
* console.log('광고 로드 성공', event.data);
|
|
390
|
+
* break;
|
|
391
|
+
*
|
|
392
|
+
* case 'clicked':
|
|
393
|
+
* console.log('광고 클릭');
|
|
394
|
+
* break;
|
|
395
|
+
*
|
|
396
|
+
* case 'dismissed':
|
|
397
|
+
* console.log('광고 닫힘');
|
|
398
|
+
* break;
|
|
399
|
+
*
|
|
400
|
+
* case 'failedToShow':
|
|
401
|
+
* console.log('광고 보여주기 실패');
|
|
402
|
+
* break;
|
|
403
|
+
*
|
|
404
|
+
* case 'impression':
|
|
405
|
+
* console.log('광고 노출');
|
|
406
|
+
* break;
|
|
407
|
+
*
|
|
408
|
+
* case 'show':
|
|
409
|
+
* console.log('광고 컨텐츠 보여졌음');
|
|
410
|
+
* break;
|
|
411
|
+
* }
|
|
412
|
+
* },
|
|
413
|
+
* onError: (error) => {
|
|
414
|
+
* console.error('광고 불러오기 실패', error);
|
|
415
|
+
* },
|
|
321
416
|
* });
|
|
322
417
|
*
|
|
323
|
-
*
|
|
324
|
-
* }
|
|
325
|
-
*
|
|
326
|
-
*
|
|
418
|
+
* return cleanup;
|
|
419
|
+
* }, []);
|
|
420
|
+
*
|
|
421
|
+
* return (
|
|
422
|
+
* <View>
|
|
423
|
+
* <Text>Page</Text>
|
|
424
|
+
* </View>
|
|
425
|
+
* );
|
|
327
426
|
* }
|
|
328
427
|
* ```
|
|
329
428
|
*/
|
|
330
|
-
declare function
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
429
|
+
declare function loadAdMobInterstitialAd(params: LoadAdMobInterstitialAdParams): () => void;
|
|
430
|
+
declare namespace loadAdMobInterstitialAd {
|
|
431
|
+
var isSupported: () => boolean;
|
|
432
|
+
}
|
|
433
|
+
interface ShowAdMobInterstitialAdOptions {
|
|
434
|
+
/**
|
|
435
|
+
* 광고 단위 ID
|
|
436
|
+
*/
|
|
437
|
+
adUnitId: string;
|
|
438
|
+
}
|
|
334
439
|
/**
|
|
335
440
|
* @public
|
|
336
|
-
* @category
|
|
337
|
-
* @name
|
|
338
|
-
* @description
|
|
339
|
-
|
|
340
|
-
|
|
441
|
+
* @category 광고
|
|
442
|
+
* @name ShowAdMobInterstitialAdEvent
|
|
443
|
+
* @description 전면 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
|
|
444
|
+
*/
|
|
445
|
+
type ShowAdMobInterstitialAdEvent = {
|
|
446
|
+
type: 'requested';
|
|
447
|
+
};
|
|
448
|
+
/**
|
|
449
|
+
* @public
|
|
450
|
+
* @category 광고
|
|
451
|
+
* @name ShowAdMobInterstitialAdParams
|
|
452
|
+
* @description 불러온 전면 광고를 보여주는 함수에 필요한 옵션 객체예요.
|
|
453
|
+
*/
|
|
454
|
+
type ShowAdMobInterstitialAdParams = AdMobHandlerParams<ShowAdMobInterstitialAdOptions, ShowAdMobInterstitialAdEvent>;
|
|
455
|
+
/**
|
|
456
|
+
* @public
|
|
457
|
+
* @category 광고
|
|
458
|
+
* @name showAdMobInterstitialAd
|
|
459
|
+
* @description 앱 화면 전체를 덮는 전면 광고를 사용자에게 노출해요. 이 함수는 `loadAdMobInterstitialAd` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
|
|
460
|
+
* @param {ShowAdMobInterstitialAdParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 ID와과 광고의 동작에 대한 콜백을 설정할 수 있어요.
|
|
461
|
+
* @param {ShowAdMobInterstitialAdOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
|
|
462
|
+
* @param {string} params.options.adUnitId 광고 단위 ID예요. `loadAdMobInterstitialAd` 로 불러온 전면 광고용 ID를 입력해요.
|
|
463
|
+
* @param {(event: ShowAdMobInterstitialAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobInterstitialAdEvent](/react-native/reference/framework/광고/ShowAdMobInterstitialAdEvent.html)를 참고하세요.
|
|
464
|
+
* @param {(reason: unknown) => void} [params.onError] 광고를 노출하지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
|
|
465
|
+
* @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
|
|
466
|
+
*
|
|
467
|
+
* @example
|
|
468
|
+
* ### 버튼 눌러 불러온 전면 광고 보여주기
|
|
469
|
+
* ```tsx
|
|
470
|
+
* import { GoogleAdMob } from '@apps-in-toss/framework';
|
|
471
|
+
* import { View, Button } from 'react-native';
|
|
472
|
+
*
|
|
473
|
+
* const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
|
|
474
|
+
*
|
|
475
|
+
* function Page() {
|
|
476
|
+
* const handlePress = () => {
|
|
477
|
+
* if (GoogleAdMob.showAdMobInterstitialAd.isSupported() !== true) {
|
|
478
|
+
* return;
|
|
479
|
+
* }
|
|
480
|
+
*
|
|
481
|
+
* GoogleAdMob.showAdMobInterstitialAd({
|
|
482
|
+
* options: {
|
|
483
|
+
* adUnitId: AD_UNIT_ID,
|
|
484
|
+
* },
|
|
485
|
+
* onEvent: (event) => {
|
|
486
|
+
* switch (event.type) {
|
|
487
|
+
* case 'requested':
|
|
488
|
+
* console.log('광고 보여주기 요청 완료');
|
|
489
|
+
* break;
|
|
490
|
+
* }
|
|
491
|
+
* },
|
|
492
|
+
* onError: (error) => {
|
|
493
|
+
* console.error('광고 보여주기 실패', error);
|
|
494
|
+
* },
|
|
495
|
+
* });
|
|
496
|
+
* }
|
|
497
|
+
*
|
|
498
|
+
* return (
|
|
499
|
+
* <Button onPress={handlePress} title="광고 보기" />
|
|
500
|
+
* );
|
|
501
|
+
* }
|
|
502
|
+
* ```
|
|
341
503
|
*/
|
|
342
|
-
|
|
504
|
+
declare function showAdMobInterstitialAd(params: ShowAdMobInterstitialAdParams): () => void;
|
|
505
|
+
declare namespace showAdMobInterstitialAd {
|
|
506
|
+
var isSupported: () => boolean;
|
|
507
|
+
}
|
|
508
|
+
interface LoadAdMobRewardedAdOptions {
|
|
343
509
|
/**
|
|
344
|
-
*
|
|
510
|
+
* 광고 단위 ID
|
|
345
511
|
*/
|
|
346
|
-
|
|
512
|
+
adUnitId: string;
|
|
513
|
+
}
|
|
514
|
+
/**
|
|
515
|
+
* @public
|
|
516
|
+
* @category 광고
|
|
517
|
+
* @name LoadAdMobInterstitialAdEvent
|
|
518
|
+
* @description 보상형 광고를 불러오는 함수에서 발생하는 이벤트 타입이에요. `loaded` 이벤트가 발생하면 광고를 성공적으로 불러온 거예요. 이때 [RewardedAd](/react-native/reference/framework/광고/RewardedAd.html) 객체가 함께 반환돼요. `userEarnedReward` 이벤트는 사용자가 광고를 끝까지 시청해, 보상 조건을 충족했을 때 발생해요.
|
|
519
|
+
*/
|
|
520
|
+
type LoadAdMobRewardedAdEvent = AdMobFullScreenEvent | {
|
|
521
|
+
type: 'loaded';
|
|
522
|
+
data: RewardedAd;
|
|
523
|
+
} | {
|
|
524
|
+
type: 'userEarnedReward';
|
|
525
|
+
};
|
|
526
|
+
/**
|
|
527
|
+
* @public
|
|
528
|
+
* @category 광고
|
|
529
|
+
* @name LoadAdMobRewardedAdParams
|
|
530
|
+
* @description 보상형 광고를 불러오는 함수에 필요한 옵션 객체예요.
|
|
531
|
+
*/
|
|
532
|
+
type LoadAdMobRewardedAdParams = AdMobHandlerParams<LoadAdMobRewardedAdOptions, LoadAdMobRewardedAdEvent>;
|
|
533
|
+
/**
|
|
534
|
+
* @public
|
|
535
|
+
* @category 광고
|
|
536
|
+
* @name loadAdMobRewardedAd
|
|
537
|
+
* @description 사용자가 광고를 끝까지 시청하면 리워드를 제공할 수 있는 보상형 광고를 미리 불러와서, 광고가 필요한 시점에 바로 보여줄 수 있도록 준비하는 함수예요.
|
|
538
|
+
* @param {LoadAdMobRewardedAdParams} params 광고를 불러올 때 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
|
|
539
|
+
* @param {LoadAdMobRewardedAdOptions} params.options 광고를 불러올 때 전달할 옵션 객체예요.
|
|
540
|
+
* @param {string} params.options.adUnitId 광고 단위 ID예요. 발급받은 보상형 광고용 ID를 입력해요.
|
|
541
|
+
* @param {(event: LoadAdMobRewardedAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고가 닫히거나 클릭됐을 때). 자세한 이벤트 타입은 [LoadAdMobRewardedAdEvent](/react-native/reference/framework/광고/LoadAdMobRewardedAdEvent.html)를 참고하세요.
|
|
542
|
+
* @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
|
|
543
|
+
* @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
|
|
544
|
+
*
|
|
545
|
+
* @example
|
|
546
|
+
* ### 뷰 진입 시 보상형 광고 불러오기
|
|
547
|
+
* ```tsx
|
|
548
|
+
* import { GoogleAdMob } from '@apps-in-toss/framework';
|
|
549
|
+
* import { useEffect } from 'react';
|
|
550
|
+
* import { View, Text } from 'react-native';
|
|
551
|
+
*
|
|
552
|
+
* const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
|
|
553
|
+
*
|
|
554
|
+
* function Page() {
|
|
555
|
+
* useEffect(() => {
|
|
556
|
+
* if (GoogleAdMob.loadAdMobRewardedAd.isSupported() !== true) {
|
|
557
|
+
* return;
|
|
558
|
+
* }
|
|
559
|
+
*
|
|
560
|
+
* const cleanup = GoogleAdMob.loadAdMobRewardedAd({
|
|
561
|
+
* options: {
|
|
562
|
+
* adUnitId: AD_UNIT_ID,
|
|
563
|
+
* },
|
|
564
|
+
* onEvent: (event) => {
|
|
565
|
+
* switch (event.type) {
|
|
566
|
+
* case 'loaded':
|
|
567
|
+
* console.log('광고 로드 성공', event.data);
|
|
568
|
+
* break;
|
|
569
|
+
*
|
|
570
|
+
* case 'clicked':
|
|
571
|
+
* console.log('광고 클릭');
|
|
572
|
+
* break;
|
|
573
|
+
*
|
|
574
|
+
* case 'dismissed':
|
|
575
|
+
* console.log('광고 닫힘');
|
|
576
|
+
* break;
|
|
577
|
+
*
|
|
578
|
+
* case 'failedToShow':
|
|
579
|
+
* console.log('광고 보여주기 실패');
|
|
580
|
+
* break;
|
|
581
|
+
*
|
|
582
|
+
* case 'impression':
|
|
583
|
+
* console.log('광고 노출');
|
|
584
|
+
* break;
|
|
585
|
+
*
|
|
586
|
+
* case 'show':
|
|
587
|
+
* console.log('광고 컨텐츠 보여졌음');
|
|
588
|
+
* break;
|
|
589
|
+
*
|
|
590
|
+
* case 'userEarnedReward':
|
|
591
|
+
* console.log('사용자가 광고 시청을 완료했음');
|
|
592
|
+
* break;
|
|
593
|
+
* }
|
|
594
|
+
* },
|
|
595
|
+
* onError: (error) => {
|
|
596
|
+
* console.error('광고 불러오기 실패', error);
|
|
597
|
+
* },
|
|
598
|
+
* });
|
|
599
|
+
*
|
|
600
|
+
* return cleanup;
|
|
601
|
+
* }, []);
|
|
602
|
+
*
|
|
603
|
+
* return (
|
|
604
|
+
* <View>
|
|
605
|
+
* <Text>Page</Text>
|
|
606
|
+
* </View>
|
|
607
|
+
* );
|
|
608
|
+
* }
|
|
609
|
+
* ```
|
|
610
|
+
*/
|
|
611
|
+
declare function loadAdMobRewardedAd(params: LoadAdMobRewardedAdParams): () => void;
|
|
612
|
+
declare namespace loadAdMobRewardedAd {
|
|
613
|
+
var isSupported: () => boolean;
|
|
614
|
+
}
|
|
615
|
+
interface ShowAdMobRewardedAdOptions {
|
|
347
616
|
/**
|
|
348
|
-
*
|
|
617
|
+
* 광고 단위 ID
|
|
349
618
|
*/
|
|
350
|
-
|
|
619
|
+
adUnitId: string;
|
|
620
|
+
}
|
|
621
|
+
/**
|
|
622
|
+
* @public
|
|
623
|
+
* @category 광고
|
|
624
|
+
* @name ShowAdMobRewardedAdEvent
|
|
625
|
+
* @description 보상형 광고를 보여주는 함수에서 발생하는 이벤트 타입이에요. `requested` 이벤트가 발생하면 광고 노출 요청이 Google AdMob에 성공적으로 전달된 거예요.
|
|
626
|
+
*/
|
|
627
|
+
type ShowAdMobRewardedAdEvent = {
|
|
628
|
+
type: 'requested';
|
|
629
|
+
};
|
|
630
|
+
/**
|
|
631
|
+
* @public
|
|
632
|
+
* @category 광고
|
|
633
|
+
* @name ShowAdMobRewardedAdParams
|
|
634
|
+
* @description 불러온 보상형 광고를 보여주는 함수에 필요한 옵션 객체예요.
|
|
635
|
+
*/
|
|
636
|
+
type ShowAdMobRewardedAdParams = AdMobHandlerParams<ShowAdMobRewardedAdOptions, ShowAdMobRewardedAdEvent>;
|
|
637
|
+
/**
|
|
638
|
+
* @public
|
|
639
|
+
* @category 광고
|
|
640
|
+
* @name showAdMobRewardedAd
|
|
641
|
+
* @description 사용자가 광고를 끝까지 보면 리워드를 받을 수 있도록, 보상형 광고를 화면에 보여줘요. 이 함수는 `loadAdMobRewardedAd` 로 미리 불러온 광고를 실제로 사용자에게 노출해요.
|
|
642
|
+
* @param {ShowAdMobRewardedAdParams} params 광고를 보여주기 위해 사용할 설정 값이에요. 광고 ID와 광고의 동작에 대한 콜백을 설정할 수 있어요.
|
|
643
|
+
* @param {ShowAdMobRewardedAdOptions} params.options 광고를 보여줄 때 전달할 옵션 객체예요.
|
|
644
|
+
* @param {string} params.options.adUnitId 광고 단위 ID예요. `loadAdMobRewardedAd` 로 불러온 보상형 광고용 ID를 입력해요.
|
|
645
|
+
* @param {(event: ShowAdMobRewardedAdEvent) => void} [params.onEvent] 광고 관련 이벤트가 발생했을 때 호출돼요. (예시: 광고 노출을 요청했을 때). 자세한 이벤트 타입은 [ShowAdMobRewardedAdEvent](/react-native/reference/framework/광고/ShowAdMobRewardedAdEvent.html)를 참고하세요.
|
|
646
|
+
* @param {(reason: unknown) => void} [params.onError] 광고를 불러오지 못했을 때 호출돼요. (예시: 네트워크 오류나 지원하지 않는 환경일 때)
|
|
647
|
+
* @property {() => boolean} [isSupported] 현재 실행 중인 앱(예: 토스 앱, 개발용 샌드박스 앱 등)에서 Google AdMob 광고 기능을 지원하는지 확인하는 함수예요. 기능을 사용하기 전에 지원 여부를 확인해야 해요.
|
|
648
|
+
*
|
|
649
|
+
* @example
|
|
650
|
+
* ### 버튼 눌러 불러온 보상형 광고 보여주기
|
|
651
|
+
* ```tsx
|
|
652
|
+
* import { GoogleAdMob } from '@apps-in-toss/framework';
|
|
653
|
+
* import { View, Text, Button } from 'react-native';
|
|
654
|
+
*
|
|
655
|
+
* const AD_UNIT_ID = '<YOUR_AD_UNIT_ID>';
|
|
656
|
+
*
|
|
657
|
+
* function Page() {
|
|
658
|
+
* const handlePress = () => {
|
|
659
|
+
* if (GoogleAdMob.showAdMobRewardedAd.isSupported() !== true) {
|
|
660
|
+
* return;
|
|
661
|
+
* }
|
|
662
|
+
*
|
|
663
|
+
* GoogleAdMob.showAdMobRewardedAd({
|
|
664
|
+
* options: {
|
|
665
|
+
* adUnitId: AD_UNIT_ID,
|
|
666
|
+
* },
|
|
667
|
+
* onEvent: (event) => {
|
|
668
|
+
* switch (event.type) {
|
|
669
|
+
* case 'requested':
|
|
670
|
+
* console.log('광고 보여주기 요청 완료');
|
|
671
|
+
* break;
|
|
672
|
+
* }
|
|
673
|
+
* },
|
|
674
|
+
* onError: (error) => {
|
|
675
|
+
* console.error('광고 보여주기 실패', error);
|
|
676
|
+
* },
|
|
677
|
+
* });
|
|
678
|
+
* }
|
|
679
|
+
*
|
|
680
|
+
* return (
|
|
681
|
+
* <Button onPress={handlePress} title="광고 보기" />
|
|
682
|
+
* );
|
|
683
|
+
* }
|
|
684
|
+
* ```
|
|
685
|
+
*/
|
|
686
|
+
declare function showAdMobRewardedAd(params: ShowAdMobRewardedAdParams): () => void;
|
|
687
|
+
declare namespace showAdMobRewardedAd {
|
|
688
|
+
var isSupported: () => boolean;
|
|
351
689
|
}
|
|
690
|
+
|
|
352
691
|
/**
|
|
353
692
|
* @public
|
|
354
693
|
* @category 토스페이
|
|
355
|
-
* @name
|
|
356
|
-
* @description
|
|
357
|
-
* @property {
|
|
358
|
-
* @property {number} code 결제 요청의 결과 코드예요.
|
|
359
|
-
* @property {'LIVE' | 'TEST'} mode 현재 결제 환경이에요.
|
|
360
|
-
* @property {string} orderNo 주문번호예요.
|
|
361
|
-
* @property {number} amount 총 결제 금액이에요.
|
|
362
|
-
* @property {string} approvalTime 결제가 승인된 시간이에요. (ISO 8601 형식)
|
|
363
|
-
* @property {string} stateMsg 결제 상태 메시지예요.
|
|
364
|
-
* @property {number} discountedAmount 적용된 할인 금액이에요.
|
|
365
|
-
* @property {number} paidAmount 실제 결제된 금액이에요.
|
|
366
|
-
* @property {string} payToken 결제 요청 시 사용한 Pay 토큰이에요.
|
|
367
|
-
* @property {string} transactionId 거래 ID예요.
|
|
368
|
-
* @property {number} cardCompanyCode 카드사 코드예요.
|
|
369
|
-
* @property {string} cardCompanyName 카드사 이름이에요.
|
|
370
|
-
* @property {string} cardAuthorizationNo 카드사 승인 번호예요. (라이브 결제 환경에서만 확인 가능해요)
|
|
371
|
-
* @property {number} spreadOut 할부 개월 수예요. (5만원 미만 금액 및 일시불 결제의 경우에는 `0`)
|
|
372
|
-
* @property {boolean} noInterest 무이자 할부 여부예요.
|
|
373
|
-
* @property {string} salesCheckLinkUrl 결제 내역을 확인할 수 있는 매출전표 URL이에요.
|
|
374
|
-
* @property {'CREDIT' | 'CHECK' | 'PREPAYMENT'} cardMethodType 카드 유형이에요.
|
|
375
|
-
* @property {string} cardNumber 마스킹된 카드 번호예요. (`****-****-****-1234` 형식)
|
|
376
|
-
* @property {string} cardNum4Print 카드 번호의 마지막 4자리예요.
|
|
377
|
-
* @property {string} cardBinNumber 카드 BIN 번호예요.
|
|
694
|
+
* @name CheckoutPaymentOptions
|
|
695
|
+
* @description 토스페이 결제창을 띄울 때 필요한 옵션이에요.
|
|
696
|
+
* @property {string} payToken 결제 토큰이에요.
|
|
378
697
|
*/
|
|
379
|
-
interface
|
|
380
|
-
/**
|
|
381
|
-
* 결제 수단이에요.
|
|
382
|
-
*/
|
|
383
|
-
payMethod: 'CARD';
|
|
384
|
-
/**
|
|
385
|
-
* 결제 요청의 결과 코드예요.
|
|
386
|
-
*/
|
|
387
|
-
code: number;
|
|
388
|
-
/**
|
|
389
|
-
* 현재 결제 환경이에요.
|
|
390
|
-
*
|
|
391
|
-
* - `LIVE`: 실제 환경
|
|
392
|
-
* - `TEST`: 테스트 환경
|
|
393
|
-
*/
|
|
394
|
-
mode: 'LIVE' | 'TEST';
|
|
395
|
-
/**
|
|
396
|
-
* 주문번호예요.
|
|
397
|
-
*/
|
|
398
|
-
orderNo: string;
|
|
399
|
-
/**
|
|
400
|
-
* 총 결제 금액이에요.
|
|
401
|
-
*/
|
|
402
|
-
amount: number;
|
|
403
|
-
/**
|
|
404
|
-
* 결제가 승인된 시간이에요. (ISO 8601 형식)
|
|
405
|
-
*/
|
|
406
|
-
approvalTime: string;
|
|
407
|
-
/**
|
|
408
|
-
* 결제 상태 메시지예요.
|
|
409
|
-
*/
|
|
410
|
-
stateMsg: string;
|
|
411
|
-
/**
|
|
412
|
-
* 적용된 할인 금액이에요.
|
|
413
|
-
*/
|
|
414
|
-
discountedAmount: number;
|
|
415
|
-
/**
|
|
416
|
-
* 실제 결제된 금액이에요.
|
|
417
|
-
*/
|
|
418
|
-
paidAmount: number;
|
|
698
|
+
interface CheckoutPaymentOptions {
|
|
419
699
|
/**
|
|
420
|
-
* 결제
|
|
700
|
+
* 결제 토큰이에요.
|
|
421
701
|
*/
|
|
422
702
|
payToken: string;
|
|
423
|
-
/**
|
|
424
|
-
* 거래 ID예요.
|
|
425
|
-
*/
|
|
426
|
-
transactionId: string;
|
|
427
|
-
/**
|
|
428
|
-
* 카드사 코드예요.
|
|
429
|
-
*/
|
|
430
|
-
cardCompanyCode: number;
|
|
431
|
-
/**
|
|
432
|
-
* 카드사 이름이에요.
|
|
433
|
-
*/
|
|
434
|
-
cardCompanyName: string;
|
|
435
|
-
/**
|
|
436
|
-
* 카드사 승인 번호예요. (라이브 결제 환경에서만 확인 가능해요)
|
|
437
|
-
*/
|
|
438
|
-
cardAuthorizationNo: string;
|
|
439
|
-
/**
|
|
440
|
-
* 할부 개월 수예요. (5만원 미만 금액 및 일시불 결제의 경우에는 `0`)
|
|
441
|
-
*/
|
|
442
|
-
spreadOut: number;
|
|
443
|
-
/**
|
|
444
|
-
* 무이자 할부 여부예요.
|
|
445
|
-
*/
|
|
446
|
-
noInterest: boolean;
|
|
447
|
-
/**
|
|
448
|
-
* 결제 내역을 확인할 수 있는 매출전표 URL이에요.
|
|
449
|
-
*/
|
|
450
|
-
salesCheckLinkUrl: string;
|
|
451
|
-
/**
|
|
452
|
-
* 카드 유형이에요.
|
|
453
|
-
*
|
|
454
|
-
* - 'CREDIT': 신용카드
|
|
455
|
-
* - 'CHECK': 체크카드
|
|
456
|
-
* - 'PREPAYMENT': 선불카드
|
|
457
|
-
*/
|
|
458
|
-
cardMethodType: 'CREDIT' | 'CHECK' | 'PREPAYMENT';
|
|
459
|
-
/**
|
|
460
|
-
* 마스킹된 카드 번호예요. (`****-****-****-1234` 형식)
|
|
461
|
-
*/
|
|
462
|
-
cardNumber: string;
|
|
463
|
-
/**
|
|
464
|
-
* 카드 사용자 구분을 나타내는 값이에요.
|
|
465
|
-
*
|
|
466
|
-
* - 'PERSONAL': 개인 카드
|
|
467
|
-
* - 'PERSONAL_FAMILY': 가족 카드
|
|
468
|
-
* - 'CORP_PERSONAL': 법인지정 결제계좌 (임직원)
|
|
469
|
-
* - 'CORP_PRIVATE': 법인 공용
|
|
470
|
-
* - 'CORP_COMPANY': 법인지정 결제계좌 회사 (하나카드 Only)
|
|
471
|
-
*/
|
|
472
|
-
cardUserType: 'PERSONAL' | 'PERSONAL_FAMILY' | 'CORP_PERSONAL' | 'CORP_PRIVATE' | 'CORP_COMPANY';
|
|
473
|
-
/**
|
|
474
|
-
* 카드 번호의 마지막 4자리예요.
|
|
475
|
-
*/
|
|
476
|
-
cardNum4Print: string;
|
|
477
|
-
/**
|
|
478
|
-
* 카드 BIN 번호예요.
|
|
479
|
-
*/
|
|
480
|
-
cardBinNumber: string;
|
|
481
703
|
}
|
|
482
704
|
/**
|
|
483
705
|
* @public
|
|
484
706
|
* @category 토스페이
|
|
485
|
-
* @name
|
|
486
|
-
* @description
|
|
487
|
-
* @property {
|
|
488
|
-
* @property {
|
|
489
|
-
* @property {'LIVE' | 'TEST'} mode 현재 결제 환경이에요.
|
|
490
|
-
* @property {string} orderNo 주문번호예요.
|
|
491
|
-
* @property {number} amount 총 결제 금액이에요.
|
|
492
|
-
* @property {string} approvalTime 결제가 승인된 시간이에요. (ISO 8601 형식)
|
|
493
|
-
* @property {string} stateMsg 결제 상태 메시지예요.
|
|
494
|
-
* @property {number} discountedAmount 적용된 할인 금액이에요.
|
|
495
|
-
* @property {number} paidAmount 실제 결제된 금액이에요.
|
|
496
|
-
* @property {string} payToken 결제 요청 시 사용한 Pay 토큰이에요.
|
|
497
|
-
* @property {string} transactionId 거래 ID예요.
|
|
498
|
-
* @property {string} cashReceiptMgtKey 현금영수증 관리번호 식별값이에요.
|
|
499
|
-
* @property {string} accountBankName 결제된 은행의 코드예요.
|
|
500
|
-
* @property {string} accountNumber 결제된 계좌번호예요.
|
|
707
|
+
* @name CheckoutPaymentResult
|
|
708
|
+
* @description 토스페이 결제창에서 사용자가 인증에 성공했는지 여부예요.
|
|
709
|
+
* @property {boolean} success 인증이 성공했는지 여부예요.
|
|
710
|
+
* @property {string} [reason] 인증이 실패했을 경우의 이유예요.
|
|
501
711
|
*/
|
|
502
|
-
interface
|
|
503
|
-
/**
|
|
504
|
-
* 결제에 사용된 결제 수단이에요.
|
|
505
|
-
*/
|
|
506
|
-
payMethod: 'TOSS_MONEY';
|
|
507
|
-
/**
|
|
508
|
-
* 결제 요청의 결과 코드예요.
|
|
509
|
-
*/
|
|
510
|
-
code: number;
|
|
511
|
-
/**
|
|
512
|
-
* 현재 결제 환경이에요.
|
|
513
|
-
*
|
|
514
|
-
* - `LIVE`: 실제 환경
|
|
515
|
-
* - `TEST`: 테스트 환경
|
|
516
|
-
*/
|
|
517
|
-
mode: 'LIVE' | 'TEST';
|
|
518
|
-
/**
|
|
519
|
-
* 결제 승인된 상품의 주문번호예요.
|
|
520
|
-
*/
|
|
521
|
-
orderNo: string;
|
|
522
|
-
/**
|
|
523
|
-
* 결제 승인된 상품의 총 결제 금액이에요.
|
|
524
|
-
*/
|
|
525
|
-
amount: number;
|
|
526
|
-
/**
|
|
527
|
-
* 결제가 승인된 시간이에요. (ISO 8601 형식)
|
|
528
|
-
*/
|
|
529
|
-
approvalTime: string;
|
|
530
|
-
/**
|
|
531
|
-
* 결제 상태 메시지예요.
|
|
532
|
-
*/
|
|
533
|
-
stateMsg: string;
|
|
712
|
+
interface CheckoutPaymentResult {
|
|
534
713
|
/**
|
|
535
|
-
*
|
|
714
|
+
* 인증이 성공했는지 여부예요.
|
|
536
715
|
*/
|
|
537
|
-
|
|
716
|
+
success: boolean;
|
|
538
717
|
/**
|
|
539
|
-
*
|
|
718
|
+
* 인증이 실패했을 경우의 이유예요.
|
|
540
719
|
*/
|
|
541
|
-
|
|
542
|
-
/**
|
|
543
|
-
* 결제 요청 시 사용한 Pay 토큰이에요.
|
|
544
|
-
*/
|
|
545
|
-
payToken: string;
|
|
546
|
-
/**
|
|
547
|
-
* 거래 ID예요.
|
|
548
|
-
*/
|
|
549
|
-
transactionId: string;
|
|
550
|
-
/**
|
|
551
|
-
* 현금영수증 관리번호 식별값이에요.
|
|
552
|
-
*/
|
|
553
|
-
cashReceiptMgtKey: string;
|
|
554
|
-
/**
|
|
555
|
-
* 결제된 은행의 코드예요.
|
|
556
|
-
*/
|
|
557
|
-
accountBankName: string;
|
|
558
|
-
/**
|
|
559
|
-
* 결제된 계좌번호예요.
|
|
560
|
-
*/
|
|
561
|
-
accountNumber: string;
|
|
720
|
+
reason?: string;
|
|
562
721
|
}
|
|
563
722
|
/**
|
|
564
723
|
* @public
|
|
565
724
|
* @category 토스페이
|
|
566
|
-
* @name
|
|
567
|
-
* @description
|
|
725
|
+
* @name checkoutPayment
|
|
726
|
+
* @description 토스페이 결제창을 띄우고, 사용자 인증을 수행해요. 인증이 완료되면 성공 여부를 반환해요.
|
|
727
|
+
*
|
|
728
|
+
* 이 함수는 결제창을 통해 사용자 인증만 해요. 실제 결제 처리는 인증 성공 후 서버에서 별도로 해야 해요.
|
|
568
729
|
*
|
|
569
|
-
* @param {
|
|
570
|
-
* @
|
|
571
|
-
* @param {string} options.payToken 결제 인증 과정에서 전달받은 결제 토큰이에요. 결제를 실행할 때 사용해요.
|
|
572
|
-
* @returns {Promise<CardExecutePaymentResult | TossMoneyExecutePaymentResult>} 결제 결과 객체를 반환해요. 자세한 내용은 [카드 결제 결과](/react-native/reference/framework/토스페이/CardExecutePaymentResult.html) 또는 [토스머니 결제 결과](/react-native/reference/framework/토스페이/TossMoneyExecutePaymentResult.html)를 참고하세요.
|
|
730
|
+
* @param {CheckoutPaymentOptions} options 결제창을 띄울 때 필요한 옵션이에요.
|
|
731
|
+
* @returns {Promise<CheckoutPaymentResult>} 인증 성공 여부를 포함한 결과를 반환해요.
|
|
573
732
|
*
|
|
574
733
|
* @example
|
|
575
734
|
*
|
|
576
|
-
* ###
|
|
735
|
+
* ### 토스페이 결제창 띄우고 인증 처리하기
|
|
577
736
|
*
|
|
578
737
|
* ```tsx
|
|
579
738
|
* import { TossPay } from '@apps-in-toss/framework';
|
|
580
739
|
*
|
|
581
740
|
* async function handlePayment() {
|
|
582
741
|
* try {
|
|
583
|
-
*
|
|
742
|
+
* // 실제 구현 시 결제 생성 역할을 하는 API 엔드포인트로 대체해주세요.
|
|
743
|
+
* const { payToken } = await fetch('/my-api/payment/create').then(res => res.json());
|
|
584
744
|
*
|
|
585
|
-
* const
|
|
586
|
-
* orderNo: 'ORDER_12345',
|
|
587
|
-
* payToken,
|
|
588
|
-
* });
|
|
745
|
+
* const { success, reason } = await TossPay.checkoutPayment({ payToken });
|
|
589
746
|
*
|
|
590
|
-
*
|
|
747
|
+
* if (success) {
|
|
748
|
+
* // 실제 구현 시 결제를 실행하는 API 엔드포인트로 대체해주세요.
|
|
749
|
+
* await fetch('/my-api/payment/execute', {
|
|
750
|
+
* method: 'POST',
|
|
751
|
+
* body: JSON.stringify({ payToken }),
|
|
752
|
+
* headers: { 'Content-Type': 'application/json' },
|
|
753
|
+
* });
|
|
754
|
+
* } else {
|
|
755
|
+
* console.log('인증 실패:', reason);
|
|
756
|
+
* }
|
|
591
757
|
* } catch (error) {
|
|
592
|
-
* console.error('
|
|
758
|
+
* console.error('결제 인증 중 오류가 발생했어요:', error);
|
|
593
759
|
* }
|
|
594
760
|
* }
|
|
595
761
|
* ```
|
|
596
762
|
*/
|
|
597
|
-
declare function
|
|
763
|
+
declare function checkoutPayment(options: CheckoutPaymentOptions): Promise<CheckoutPaymentResult>;
|
|
598
764
|
|
|
599
765
|
/**
|
|
600
766
|
* @public
|
|
@@ -1159,10 +1325,10 @@ declare function clearItems(): Promise<void>;
|
|
|
1159
1325
|
* @category 저장소
|
|
1160
1326
|
* @name Storage
|
|
1161
1327
|
* @description 네이티브의 저장소를 사용해요.
|
|
1162
|
-
* @property {typeof getItem} [getItem] 모바일 앱의 로컬 저장소에서 아이템을 가져오는 함수예요. 자세한 내용은 [getItem](/react-native/reference/framework/저장소/getItem)을 참고하세요.
|
|
1163
|
-
* @property {typeof setItem} [setItem] 모바일 앱의 로컬 저장소에 아이템을 저장하는 함수예요. 자세한 내용은 [setItem](/react-native/reference/framework/저장소/setItem)을
|
|
1164
|
-
* @property {typeof removeItem} [removeItem] 모바일 앱의 로컬 저장소에서 아이템을 삭제하는 함수예요. 자세한 내용은 [removeItem](/react-native/reference/framework/저장소/removeItem)을 참고하세요.
|
|
1165
|
-
* @property {typeof clearItems} [clearItems] 모바일 앱의 로컬 저장소를 초기화하는 함수예요. 자세한 내용은 [clearItems](/react-native/reference/framework/저장소/clearItems)을 참고하세요.
|
|
1328
|
+
* @property {typeof getItem} [getItem] 모바일 앱의 로컬 저장소에서 아이템을 가져오는 함수예요. 자세한 내용은 [getItem](/react-native/reference/framework/저장소/getItem.html)을 참고하세요.
|
|
1329
|
+
* @property {typeof setItem} [setItem] 모바일 앱의 로컬 저장소에 아이템을 저장하는 함수예요. 자세한 내용은 [setItem](/react-native/reference/framework/저장소/setItem.html)을 참고하셰요.
|
|
1330
|
+
* @property {typeof removeItem} [removeItem] 모바일 앱의 로컬 저장소에서 아이템을 삭제하는 함수예요. 자세한 내용은 [removeItem](/react-native/reference/framework/저장소/removeItem.html)을 참고하세요.
|
|
1331
|
+
* @property {typeof clearItems} [clearItems] 모바일 앱의 로컬 저장소를 초기화하는 함수예요. 자세한 내용은 [clearItems](/react-native/reference/framework/저장소/clearItems.html)을 참고하세요.
|
|
1166
1332
|
*/
|
|
1167
1333
|
declare const Storage: {
|
|
1168
1334
|
getItem: typeof getItem;
|
|
@@ -1171,13 +1337,100 @@ declare const Storage: {
|
|
|
1171
1337
|
clearItems: typeof clearItems;
|
|
1172
1338
|
};
|
|
1173
1339
|
|
|
1340
|
+
/**
|
|
1341
|
+
* @public
|
|
1342
|
+
* @category 환경 확인
|
|
1343
|
+
* @kind function
|
|
1344
|
+
* @name isMinVersionSupported
|
|
1345
|
+
* @description
|
|
1346
|
+
* 현재 토스 앱 버전이 지정한 최소 버전 이상인지 확인해요.
|
|
1347
|
+
*
|
|
1348
|
+
* 이 함수는 현재 실행 중인 토스 앱의 버전이 파라미터로 전달된 최소 버전 요구사항을 충족하는지 확인해요. 특정 기능이 최신 버전에서만 동작할 때, 사용자에게 앱 업데이트를 안내할 수 있어요.
|
|
1349
|
+
*
|
|
1350
|
+
* @param {Object} minVersions 플랫폼별 최소 버전 요구사항을 지정하는 객체예요.
|
|
1351
|
+
* @param {(`${number}.${number}.${number}` | 'always' | 'never')} minVersions.android 안드로이드 플랫폼의 최소 버전 요구사항이에요.
|
|
1352
|
+
* @param {(`${number}.${number}.${number}` | 'always' | 'never')} minVersions.ios iOS 플랫폼의 최소 버전 요구사항이에요.
|
|
1353
|
+
* @returns {boolean} 현재 앱 버전이 최소 버전 이상이면 true, 그렇지 않으면 false를 반환해요.
|
|
1354
|
+
*
|
|
1355
|
+
* @example
|
|
1356
|
+
* ### 앱 버전 확인하기
|
|
1357
|
+
*
|
|
1358
|
+
* ```tsx
|
|
1359
|
+
* import { isMinVersionSupported } from '@apps-in-toss/framework';
|
|
1360
|
+
* import { Text, View } from 'react-native';
|
|
1361
|
+
*
|
|
1362
|
+
* function VersionCheck() {
|
|
1363
|
+
* const isSupported = isMinVersionSupported({
|
|
1364
|
+
* android: '1.2.0',
|
|
1365
|
+
* ios: '1.3.0'
|
|
1366
|
+
* });
|
|
1367
|
+
*
|
|
1368
|
+
* return (
|
|
1369
|
+
* <View>
|
|
1370
|
+
* {!isSupported && (
|
|
1371
|
+
* <Text>최신 버전으로 업데이트가 필요해요.</Text>
|
|
1372
|
+
* )}
|
|
1373
|
+
* </View>
|
|
1374
|
+
* );
|
|
1375
|
+
* }
|
|
1376
|
+
* ```
|
|
1377
|
+
*/
|
|
1378
|
+
declare function isMinVersionSupported(minVersions: {
|
|
1379
|
+
android: `${number}.${number}.${number}` | 'always' | 'never';
|
|
1380
|
+
ios: `${number}.${number}.${number}` | 'always' | 'never';
|
|
1381
|
+
}): boolean;
|
|
1382
|
+
|
|
1383
|
+
type Primitive = string | number | boolean | null | undefined | symbol;
|
|
1384
|
+
|
|
1385
|
+
interface EventLogParams {
|
|
1386
|
+
log_name: string;
|
|
1387
|
+
log_type: 'debug' | 'info' | 'warn' | 'error' | 'screen' | 'impression' | 'click';
|
|
1388
|
+
params: Record<string, Primitive>;
|
|
1389
|
+
}
|
|
1390
|
+
/**
|
|
1391
|
+
* @category 로깅
|
|
1392
|
+
* @kind function
|
|
1393
|
+
* @name eventLog
|
|
1394
|
+
* @description
|
|
1395
|
+
* 이벤트 로그를 기록하는 함수예요.
|
|
1396
|
+
*
|
|
1397
|
+
* 이 함수는 앱 내에서 발생하는 다양한 이벤트를 로깅하는 데 사용돼요. 디버깅, 정보 제공, 경고, 오류 등 다양한 유형의 로그를 기록할 수 있어요. 샌드박스 환경에서는 콘솔에 로그가 출력되고, 실제 환경에서는 로그 시스템에 기록돼요.
|
|
1398
|
+
*
|
|
1399
|
+
* @param {Object} params 로그 기록에 필요한 매개변수 객체예요.
|
|
1400
|
+
* @param {string} params.log_name 로그의 이름이에요.
|
|
1401
|
+
* @param {'debug' | 'info' | 'warn' | 'error' | 'screen' | 'impression' | 'click'} params.log_type 로그의 유형이에요.
|
|
1402
|
+
* @param {Record<string, Primitive>} params.params 로그에 포함할 추가 매개변수 객체예요.
|
|
1403
|
+
*
|
|
1404
|
+
* @returns {Promise<void>} 로그 기록이 완료되면 해결되는 Promise예요.
|
|
1405
|
+
*
|
|
1406
|
+
* @example
|
|
1407
|
+
* ### 이벤트 로그 기록하기
|
|
1408
|
+
*
|
|
1409
|
+
* ```tsx
|
|
1410
|
+
* import { eventLog } from '@apps-in-toss/framework';
|
|
1411
|
+
*
|
|
1412
|
+
* function logUserAction() {
|
|
1413
|
+
* eventLog({
|
|
1414
|
+
* log_name: 'user_action',
|
|
1415
|
+
* log_type: 'info',
|
|
1416
|
+
* params: {
|
|
1417
|
+
* action: 'button_click',
|
|
1418
|
+
* screen: 'main',
|
|
1419
|
+
* userId: 12345
|
|
1420
|
+
* }
|
|
1421
|
+
* });
|
|
1422
|
+
* }
|
|
1423
|
+
* ```
|
|
1424
|
+
*/
|
|
1425
|
+
declare function eventLog(params: EventLogParams): Promise<void>;
|
|
1426
|
+
|
|
1174
1427
|
/**
|
|
1175
1428
|
* @public
|
|
1176
1429
|
* @category 공유
|
|
1177
1430
|
* @kind function
|
|
1178
1431
|
* @name getTossShareLink
|
|
1179
1432
|
* @description
|
|
1180
|
-
* `getTossShareLink` 함수는 사용자가 지정한 경로를 토스 앱에서 열 수 공유 링크를 반환해요.
|
|
1433
|
+
* `getTossShareLink` 함수는 사용자가 지정한 경로를 토스 앱에서 열 수 있는 공유 링크를 반환해요.
|
|
1181
1434
|
* 이 링크를 다른 사람과 공유하면 토스 앱이 실행되면서 지정한 경로로 진입해요. 토스앱이 없는 사람은 iOS 일 때는 앱스토어로 이동하고, Android 일 때는 플레이스토어로 이동해요.
|
|
1182
1435
|
*
|
|
1183
1436
|
* 경로는 토스 앱 내부 특정 화면을 나타내는 딥링크(deep link) 형식이어야 해요.
|
|
@@ -1190,7 +1443,8 @@ declare const Storage: {
|
|
|
1190
1443
|
*
|
|
1191
1444
|
* @example
|
|
1192
1445
|
* ```tsx
|
|
1193
|
-
* import {
|
|
1446
|
+
* import { share } from 'react-native-bedrock';
|
|
1447
|
+
* import { getTossShareLink } from '@apps-in-toss/framework';
|
|
1194
1448
|
*
|
|
1195
1449
|
* // '/' 경로를 딥링크로 포함한 토스 공유 링크를 생성해요.
|
|
1196
1450
|
* const tossLink = await getTossShareLink('intoss://my-app');
|
|
@@ -1206,12 +1460,26 @@ declare function getTossShareLink(path: string): Promise<string>;
|
|
|
1206
1460
|
* @category 토스페이
|
|
1207
1461
|
* @name TossPay
|
|
1208
1462
|
* @description 토스페이 결제 관련 함수를 모아둔 객체예요.
|
|
1209
|
-
* @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를
|
|
1210
|
-
* @property {typeof executePayment} [executePayment] 토스페이 결제를 실행하는 함수예요. 자세한 내용은 [executePayment](/react-native/reference/framework/토스페이/executePayment)를 참고하세요.
|
|
1463
|
+
* @property {typeof checkoutPayment} [checkoutPayment] 토스페이 결제를 인증하는 함수예요. 자세한 내용은 [checkoutPayment](/react-native/reference/framework/토스페이/checkoutPayment)를 참고하세요.
|
|
1211
1464
|
*/
|
|
1212
1465
|
declare const TossPay: {
|
|
1213
1466
|
checkoutPayment: typeof checkoutPayment;
|
|
1214
|
-
|
|
1467
|
+
};
|
|
1468
|
+
/**
|
|
1469
|
+
* @public
|
|
1470
|
+
* @category 광고
|
|
1471
|
+
* @name GoogleAdMob
|
|
1472
|
+
* @description Google AdMob 광고 관련 함수를 모아둔 객체예요.
|
|
1473
|
+
* @property {typeof loadAdMobInterstitialAd} [loadAdMobInterstitialAd] 전면 광고를 로드하는 함수예요. 자세한 내용은 [loadAdMobInterstitialAd](/react-native/reference/framework/광고/loadAdMobInterstitialAd.html)를 참고하세요.
|
|
1474
|
+
* @property {typeof showAdMobInterstitialAd} [showAdMobInterstitialAd] 로드한 전면 광고를 보여주는 함수예요. 자세한 내용은 [showAdMobInterstitialAd](/react-native/reference/framework/광고/showAdMobInterstitialAd.html)를 참고하세요.
|
|
1475
|
+
* @property {typeof loadAdMobRewardedAd} [loadAdMobRewardedAd] 보상형 광고를 로드하는 함수예요. 자세한 내용은 [loadAdMobRewardedAd](/react-native/reference/framework/광고/loadAdMobRewardedAd.html)를 참고하세요.
|
|
1476
|
+
* @property {typeof showAdMobRewardedAd} [showAdMobRewardedAd] 로드한 보상형 광고를 보여주는 함수예요. 자세한 내용은 [showAdMobRewardedAd](/react-native/reference/framework/광고/showAdMobRewardedAd.html)를 참고하세요.
|
|
1477
|
+
*/
|
|
1478
|
+
declare const GoogleAdMob: {
|
|
1479
|
+
loadAdMobInterstitialAd: typeof loadAdMobInterstitialAd;
|
|
1480
|
+
showAdMobInterstitialAd: typeof showAdMobInterstitialAd;
|
|
1481
|
+
loadAdMobRewardedAd: typeof loadAdMobRewardedAd;
|
|
1482
|
+
showAdMobRewardedAd: typeof showAdMobRewardedAd;
|
|
1215
1483
|
};
|
|
1216
1484
|
|
|
1217
1485
|
type GameWebViewProps$1 = WebViewProps$1;
|
|
@@ -1236,7 +1504,7 @@ interface LocalNetwork {
|
|
|
1236
1504
|
type InternalProps = 'source' | 'cacheEnabled' | 'sharedCookiesEnabled' | 'thirdPartyCookiesEnabled' | 'injectedJavaScriptBeforeContentLoaded';
|
|
1237
1505
|
declare function WebView({ type, local, onMessage, ...props }: WebViewProps): react_jsx_runtime.JSX.Element;
|
|
1238
1506
|
|
|
1239
|
-
type UseGeolocationOptions = Omit<StartUpdateLocationOptions, 'callback'>;
|
|
1507
|
+
type UseGeolocationOptions = Omit<StartUpdateLocationOptions$1, 'callback'>;
|
|
1240
1508
|
/**
|
|
1241
1509
|
* @public
|
|
1242
1510
|
* @category 위치 정보
|
|
@@ -1286,4 +1554,57 @@ declare const env: {
|
|
|
1286
1554
|
getDeploymentId: () => string | undefined;
|
|
1287
1555
|
};
|
|
1288
1556
|
|
|
1289
|
-
|
|
1557
|
+
declare class EntryMessageExitedEvent extends BedrockEventDefinition<undefined, undefined> {
|
|
1558
|
+
name: "entryMessageExited";
|
|
1559
|
+
remove(): void;
|
|
1560
|
+
listener(_: undefined): void;
|
|
1561
|
+
}
|
|
1562
|
+
|
|
1563
|
+
interface StartUpdateLocationOptions {
|
|
1564
|
+
/**
|
|
1565
|
+
* 위치 정확도를 설정해요.
|
|
1566
|
+
*/
|
|
1567
|
+
accuracy: Accuracy;
|
|
1568
|
+
/**
|
|
1569
|
+
* 위치 업데이트 주기를 밀리초(ms) 단위로 설정해요.
|
|
1570
|
+
*/
|
|
1571
|
+
timeInterval: number;
|
|
1572
|
+
/**
|
|
1573
|
+
* 위치 변경 거리를 미터(m) 단위로 설정해요.
|
|
1574
|
+
*/
|
|
1575
|
+
distanceInterval: number;
|
|
1576
|
+
}
|
|
1577
|
+
declare class UpdateLocationEvent extends BedrockEventDefinition<StartUpdateLocationOptions, Location> {
|
|
1578
|
+
name: "updateLocationEvent";
|
|
1579
|
+
subscriptionCount: number;
|
|
1580
|
+
ref: {
|
|
1581
|
+
remove: () => void;
|
|
1582
|
+
};
|
|
1583
|
+
remove(): void;
|
|
1584
|
+
listener(options: StartUpdateLocationOptions, onEvent: (response: Location) => void, onError: (error: unknown) => void): void;
|
|
1585
|
+
}
|
|
1586
|
+
|
|
1587
|
+
interface AppBridgeCallbackResult {
|
|
1588
|
+
name: string;
|
|
1589
|
+
params?: any;
|
|
1590
|
+
}
|
|
1591
|
+
declare class AppBridgeCallbackEvent extends BedrockEventDefinition<void, AppBridgeCallbackResult> {
|
|
1592
|
+
private static INTERNAL__appBridgeSubscription?;
|
|
1593
|
+
name: "appBridgeCallbackEvent";
|
|
1594
|
+
constructor();
|
|
1595
|
+
remove(): void;
|
|
1596
|
+
listener(): void;
|
|
1597
|
+
private registerAppBridgeCallbackEventListener;
|
|
1598
|
+
private ensureInvokeAppBridgeCallback;
|
|
1599
|
+
}
|
|
1600
|
+
|
|
1601
|
+
declare const appsInTossEvent: BedrockEvent<EntryMessageExitedEvent | AppBridgeCallbackEvent | UpdateLocationEvent>;
|
|
1602
|
+
|
|
1603
|
+
declare const Analytics: {
|
|
1604
|
+
init: (options: _apps_in_toss_analytics.AnalyticsConfig) => void;
|
|
1605
|
+
Impression: ({ enabled, impression: impressionType, ...props }: _apps_in_toss_analytics.LoggingImpressionProps) => react_jsx_runtime.JSX.Element;
|
|
1606
|
+
Press: react.ForwardRefExoticComponent<_apps_in_toss_analytics.LoggingPressProps & react.RefAttributes<unknown>>;
|
|
1607
|
+
Area: ({ children, params: _params, ...props }: _apps_in_toss_analytics.LoggingAreaProps) => react_jsx_runtime.JSX.Element;
|
|
1608
|
+
};
|
|
1609
|
+
|
|
1610
|
+
export { Accuracy, Analytics, AppsInToss, type ContactEntity, type EventLogParams, type ExternalWebViewProps, type FetchAlbumPhotosOptions, type GameWebViewProps, type GetCurrentLocationOptions, GoogleAdMob, type ImageResponse, type LoadAdMobInterstitialAdEvent, type LoadAdMobInterstitialAdOptions, type LoadAdMobRewardedAdEvent, type LoadAdMobRewardedAdOptions, type Location, type LocationCoords, type OpenCameraOptions, type PartnerWebViewProps, type ShowAdMobInterstitialAdEvent, type ShowAdMobInterstitialAdOptions, type ShowAdMobRewardedAdEvent, type ShowAdMobRewardedAdOptions, type StartUpdateLocationOptions$1 as StartUpdateLocationOptions, type StartUpdateLocationSubscription, Storage, TossPay, type UpdateLocationEventEmitter, type UseGeolocationOptions, WebView, type WebViewProps, appLogin, appsInTossEvent, env, eventLog, fetchAlbumPhotos, fetchContacts, getClipboardText, getCurrentLocation, getDeviceId, getOperationalEnvironment, getTossAppVersion, getTossShareLink, isMinVersionSupported, openCamera, setClipboardText, startUpdateLocation, useGeolocation };
|