react-native-s2offerwall 1.0.33 → 1.0.36

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.
@@ -74,5 +74,5 @@ def kotlin_version = getExtOrDefault("kotlinVersion")
74
74
  dependencies {
75
75
  implementation "com.facebook.react:react-android"
76
76
  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
77
- implementation("io.snapplay:s2offerwall-aos-sdk:1.0.33")
77
+ implementation("io.snapplay:s2offerwall-aos-sdk:1.0.36")
78
78
  }
@@ -14,6 +14,7 @@ import com.facebook.react.bridge.WritableMap;
14
14
  import com.facebook.react.modules.core.DeviceEventManagerModule;
15
15
 
16
16
  import s2.adapi.sdk.offerwall.S2Offerwall;
17
+ import s2.adapi.sdk.offerwall.S2RewardedAdRequest;
17
18
 
18
19
  public class S2OfferwallModule extends ReactContextBaseJavaModule {
19
20
  private static final String TAG = "S2OfferwallModule";
@@ -38,7 +39,47 @@ public class S2OfferwallModule extends ReactContextBaseJavaModule {
38
39
  }
39
40
  }
40
41
 
42
+ // 앱 RV 요청을 JS 로 전달한다.
43
+ // JS 는 네이티브 request 객체를 가질 수 없으므로 requestId 문자열만 넘기고,
44
+ // 결과는 reportRewardedAdResult 호출로 되돌려 받는다.
45
+ private void sendRewardedAdEvent(String eventName, S2RewardedAdRequest request) {
46
+ if (!getReactApplicationContext().hasActiveCatalystInstance()) {
47
+ // JS 쪽이 아직 연결되지 않았다.
48
+ // 이벤트 페이지가 타임아웃까지 기다리지 않도록 즉시 응답한다.
49
+ Log.e(TAG, "no active catalyst instance. reply to rewarded-ad request. " + eventName);
50
+ if ("onRewardedAdShow".equals(eventName)) {
51
+ request.onDismissed();
52
+ }
53
+ else {
54
+ request.onNoAd();
55
+ }
56
+ return;
57
+ }
58
+
59
+ WritableMap map = Arguments.createMap();
60
+ map.putString("name", eventName);
61
+ map.putString("requestId", request.getRequestId());
62
+ map.putString("slot", request.getSlot());
63
+ sendEvent(eventName, map);
64
+ }
65
+
66
+ private void registerRewardedAdListener() {
67
+ S2Offerwall.setRewardedAdListener(new S2Offerwall.RewardedAdListener() {
68
+ @Override
69
+ public void onRewardedAdRequested(S2RewardedAdRequest request) {
70
+ sendRewardedAdEvent("onRewardedAdRequested", request);
71
+ }
72
+
73
+ @Override
74
+ public void onRewardedAdShow(S2RewardedAdRequest request) {
75
+ sendRewardedAdEvent("onRewardedAdShow", request);
76
+ }
77
+ });
78
+ }
79
+
41
80
  private void registerOfferwallListener() {
81
+ registerRewardedAdListener();
82
+
42
83
  S2Offerwall.setEventListener(new S2Offerwall.EventListener() {
43
84
  @Override
44
85
  public void onLoginRequested(String param) {
@@ -231,6 +272,12 @@ public class S2OfferwallModule extends ReactContextBaseJavaModule {
231
272
  promise.resolve(null);
232
273
  }
233
274
 
275
+ @ReactMethod
276
+ public void reportRewardedAdResult(String requestId, String result, Promise promise) {
277
+ S2Offerwall.reportRewardedAdResult(requestId, result);
278
+ promise.resolve(null);
279
+ }
280
+
234
281
  @ReactMethod
235
282
  public void getPlatformVersion(Promise promise) {
236
283
  promise.resolve("Android " + android.os.Build.VERSION.RELEASE);
@@ -7,7 +7,7 @@
7
7
  // MARK: - Module Interface & Protocols
8
8
 
9
9
  // S2OfferwallModule 인터페이스 정의 및 RCTBridgeModule, RCTEventEmitter 상속
10
- @interface S2OfferwallModule : RCTEventEmitter <RCTBridgeModule, S2OfferwallEventListener, S2OfferwallInitializeListener>
10
+ @interface S2OfferwallModule : RCTEventEmitter <RCTBridgeModule, S2OfferwallEventListener, S2OfferwallInitializeListener, S2RewardedAdListener>
11
11
 
12
12
  @end
13
13
 
@@ -23,19 +23,22 @@ RCT_EXPORT_MODULE();
23
23
  // MARK: - RCTEventEmitter Overrides
24
24
 
25
25
  - (NSArray<NSString *> *)supportedEvents {
26
- return @[@"onInitCompleted", @"onLoginRequested"];
26
+ return @[@"onInitCompleted", @"onLoginRequested",
27
+ @"onRewardedAdRequested", @"onRewardedAdShow"];
27
28
  }
28
29
 
29
30
  - (void)startObserving {
30
31
  hasListeners = YES;
31
32
  // 이벤트 리스너가 추가될 때 네이티브 리스너를 설정할 수 있습니다.
32
33
  [S2Offerwall setEventListener:self];
34
+ [S2Offerwall setRewardedAdListener:self];
33
35
  }
34
36
 
35
37
  - (void)stopObserving {
36
38
  hasListeners = NO;
37
39
  // 이벤트 리스너가 모두 제거되면 네이티브 리스너를 해제할 수 있습니다.
38
40
  [S2Offerwall setEventListener:nil];
41
+ [S2Offerwall setRewardedAdListener:nil];
39
42
  }
40
43
 
41
44
  // MARK: - Helper to send events
@@ -238,4 +241,53 @@ RCT_EXPORT_METHOD(getPlatformVersion:(RCTPromiseResolveBlock)resolve rejecter:(R
238
241
  [self sendEvent:@"onInitCompleted" body:@{@"name": @"onInitCompleted", @"flag": @NO}];
239
242
  }
240
243
 
244
+
245
+ // MARK: - S2RewardedAdListener (앱 RV)
246
+
247
+ // 앱 RV 요청을 JS 로 전달한다.
248
+ // JS 는 네이티브 request 객체를 가질 수 없으므로 requestId 문자열만 넘기고,
249
+ // 결과는 reportRewardedAdResult 호출로 되돌려 받는다.
250
+ - (void)sendRewardedAdEvent:(NSString *)eventName request:(S2RewardedAdRequest *)request
251
+ {
252
+ if (!hasListeners) {
253
+ // JS 쪽 리스너가 아직 없다.
254
+ // 이벤트 페이지가 타임아웃까지 기다리지 않도록 즉시 응답한다.
255
+ RCTLogWarn(@"no listeners. reply to rewarded-ad request. %@", eventName);
256
+ if ([eventName isEqualToString:@"onRewardedAdShow"]) {
257
+ [request onDismissed];
258
+ } else {
259
+ [request onNoAd];
260
+ }
261
+ return;
262
+ }
263
+
264
+ [self sendEventWithName:eventName body:@{
265
+ @"name": eventName,
266
+ @"requestId": request.requestId,
267
+ @"slot": request.slot
268
+ }];
269
+ }
270
+
271
+ - (void)onRewardedAdRequested:(S2RewardedAdRequest *)request
272
+ {
273
+ [self sendRewardedAdEvent:@"onRewardedAdRequested" request:request];
274
+ }
275
+
276
+ - (void)onRewardedAdShow:(S2RewardedAdRequest *)request
277
+ {
278
+ [self sendRewardedAdEvent:@"onRewardedAdShow" request:request];
279
+ }
280
+
281
+ // reportRewardedAdResult
282
+ RCT_EXPORT_METHOD(reportRewardedAdResult:(NSString *)requestId
283
+ result:(NSString *)result
284
+ withResolver:(RCTPromiseResolveBlock)resolve
285
+ withRejecter:(RCTPromiseRejectBlock)reject)
286
+ {
287
+ // 생성된 Swift 인터페이스가 두 번째 인자에 라벨이 없어 아래와 같은 형태로 호출한다.
288
+ // + (void)reportRewardedAdResult:(NSString *)requestId :(NSString *)result;
289
+ [S2Offerwall reportRewardedAdResult:requestId :result];
290
+ resolve(nil);
291
+ }
292
+
241
293
  @end
@@ -8,6 +8,95 @@ const {
8
8
 
9
9
  // 이벤트 타입 정의
10
10
 
11
+ // 광고 길이 구분
12
+ export const S2RewardedAdSlot = {
13
+ short: 'short',
14
+ middle: 'middle',
15
+ long: 'long',
16
+ random: 'random'
17
+ };
18
+ /**
19
+ * 오퍼월 이벤트 페이지가 리워드 광고(RV)를 필요로 할 때 전달되는 요청이다.
20
+ *
21
+ * 매체 앱은 자신의 리워드 광고(admob 등)를 재생하고 아래 메서드 중 하나로 결과를 알린다.
22
+ * 각 요청은 반드시 한 번만 완료해야 하며, 추가 호출은 무시된다.
23
+ *
24
+ * 로딩 단계 - onRewardedAdRequested
25
+ * - onLoaded() : 광고 준비 완료
26
+ * - onNoAd() : 광고 없음. 이벤트 페이지는 기존 웹 광고로 폴백한다
27
+ *
28
+ * 재생 단계 - onRewardedAdShow
29
+ * - onGranted() : 유저가 끝까지 시청함
30
+ * - onDismissed() : 유저가 광고를 닫았거나 재생에 실패함
31
+ *
32
+ * 주의) onNoAd() 는 로딩 단계 전용이다. 재생 단계의 실패는 onDismissed() 로 알려야 한다.
33
+ * 재생 중에 광고 없음을 보고하면 이벤트 페이지가 폴백 처리를 하지 못해 버튼이 묶인다.
34
+ */
35
+ export class S2RewardedAdRequest {
36
+ /** 이 요청의 식별자. 결과를 되돌려 보낼 때 사용된다. */
37
+
38
+ /** 요청된 광고 길이. 재생 단계(onRewardedAdShow)에서는 빈 문자열이다. */
39
+
40
+ constructor(requestId, slot) {
41
+ this.requestId = requestId;
42
+ this.slot = slot;
43
+ }
44
+
45
+ /** 리워드 광고가 준비되었음을 알린다. (로딩 단계) */
46
+ onLoaded() {
47
+ return S2OfferwallModule.reportRewardedAdResult(this.requestId, 'loaded');
48
+ }
49
+
50
+ /** 재생할 광고가 없음을 알린다. (로딩 단계) */
51
+ onNoAd() {
52
+ return S2OfferwallModule.reportRewardedAdResult(this.requestId, 'noad');
53
+ }
54
+
55
+ /** 유저가 광고를 끝까지 시청했음을 알린다. (재생 단계) */
56
+ onGranted() {
57
+ return S2OfferwallModule.reportRewardedAdResult(this.requestId, 'granted');
58
+ }
59
+
60
+ /** 유저가 광고를 닫았거나 재생에 실패했음을 알린다. (재생 단계) */
61
+ onDismissed() {
62
+ return S2OfferwallModule.reportRewardedAdResult(this.requestId, 'dismissed');
63
+ }
64
+ }
65
+ // 앱 RV 는 요청마다 반드시 응답해야 하므로, 콜백이 등록되지 않았어도
66
+ // 내부 리스너가 항상 붙어서 즉시 응답할 수 있어야 한다.
67
+ // (응답하지 않으면 이벤트 페이지가 타임아웃까지 기다린다)
68
+ let rewardedAdRequestedHandler = null;
69
+ let rewardedAdShowHandler = null;
70
+ let rewardedAdListenerBound = false;
71
+ function toRewardedAdRequest(event) {
72
+ return new S2RewardedAdRequest(event?.requestId ?? '', event?.slot ?? '');
73
+ }
74
+ function bindRewardedAdListeners() {
75
+ if (rewardedAdListenerBound) {
76
+ return;
77
+ }
78
+ rewardedAdListenerBound = true;
79
+ const requested = eventEmitter.addListener('onRewardedAdRequested', event => {
80
+ const request = toRewardedAdRequest(event);
81
+ if (rewardedAdRequestedHandler) {
82
+ rewardedAdRequestedHandler(request);
83
+ } else {
84
+ // 매체 앱이 앱 RV 를 연동하지 않았다. 즉시 광고 없음으로 응답한다.
85
+ request.onNoAd();
86
+ }
87
+ });
88
+ const show = eventEmitter.addListener('onRewardedAdShow', event => {
89
+ const request = toRewardedAdRequest(event);
90
+ if (rewardedAdShowHandler) {
91
+ rewardedAdShowHandler(request);
92
+ } else {
93
+ // 정상적으로는 발생할 수 없지만, 방어적으로 중단 처리한다.
94
+ request.onDismissed();
95
+ }
96
+ });
97
+ subscriptions.push(requested, show);
98
+ }
99
+
11
100
  // 핵심: S2OfferwallModule을 래핑하고 모든 메서드와 리스너를 포함하는 단일 객체입니다.
12
101
  // 이 객체를 'S2Offerwall'이라는 이름으로 명시적으로 내보냅니다.
13
102
  const eventEmitter = new NativeEventEmitter(S2OfferwallModule);
@@ -33,16 +122,60 @@ export const S2Offerwall = {
33
122
  },
34
123
  /**
35
124
  * @description 등록된 모든 이벤트 리스너를 제거합니다.
125
+ *
126
+ * 앱 RV 콜백(onRewardedAdRequested / onRewardedAdShow)도 함께 해제됩니다.
127
+ * 따라서 앱 RV 를 특정 화면에서만 등록하면 그 화면을 벗어난 뒤 동작하지 않습니다.
128
+ * 앱 RV 콜백은 화면 컴포넌트가 아니라 앱 진입점에서 한 번만 등록하세요.
36
129
  */
37
130
  removeAllListeners() {
38
131
  subscriptions.forEach(sub => sub.remove());
39
132
  subscriptions = [];
133
+ rewardedAdListenerBound = false;
134
+ rewardedAdRequestedHandler = null;
135
+ rewardedAdShowHandler = null;
136
+ },
137
+ // --- 앱 RV ---
138
+
139
+ /**
140
+ * @description 이벤트 페이지가 리워드 광고 로딩을 요청할 때 호출된다.
141
+ * 광고가 준비되면 request.onLoaded(), 광고가 없으면 request.onNoAd() 를 호출한다.
142
+ * 등록하지 않으면 이벤트 페이지는 기존처럼 웹 리워드 광고를 사용한다.
143
+ *
144
+ * 콜백은 요청이 도착한 시점에 조회되므로 initSdk() 앞뒤 어디서 등록해도 동작한다.
145
+ * 다만 등록 전에 요청이 도착하면 그 참여 1회는 웹 광고로 폴백되므로
146
+ * (크래시나 멈춤은 없지만 조용히 수익만 놓친다),
147
+ * 유저가 오퍼월을 열 수 있게 되기 전에 앱 진입점에서 등록해두는 것이 안전하다.
148
+ */
149
+ onRewardedAdRequested(callback) {
150
+ rewardedAdRequestedHandler = callback;
151
+ bindRewardedAdListeners();
152
+ },
153
+ /**
154
+ * @description 로딩된 리워드 광고를 재생할 때 호출된다.
155
+ * 시청이 완료되면 request.onGranted(),
156
+ * 유저가 닫았거나 재생에 실패하면 request.onDismissed() 를 호출한다.
157
+ *
158
+ * onRewardedAdRequested 와 함께 앱 진입점에서 등록한다.
159
+ */
160
+ onRewardedAdShow(callback) {
161
+ rewardedAdShowHandler = callback;
162
+ bindRewardedAdListeners();
163
+ },
164
+ /**
165
+ * @description 리워드 광고 요청의 결과를 알린다.
166
+ * 보통은 S2RewardedAdRequest 의 메서드를 사용하면 되고 직접 쓸 일은 없다.
167
+ * result 는 loaded, noad, granted, dismissed 중 하나이다.
168
+ */
169
+ reportRewardedAdResult(requestId, result) {
170
+ return S2OfferwallModule.reportRewardedAdResult(requestId, result);
40
171
  },
41
172
  // --- Native Module 메서드 ---
42
173
 
43
174
  // 모든 메서드는 NativeModules 객체에서 직접 호출되도록 래핑됩니다.
44
175
 
45
176
  initSdk() {
177
+ // 콜백이 등록되지 않았더라도 앱 RV 요청에 응답할 수 있도록 리스너를 붙여둔다.
178
+ bindRewardedAdListeners();
46
179
  return S2OfferwallModule.initSdk();
47
180
  },
48
181
  showOfferwall(placementName) {
@@ -1 +1 @@
1
- {"version":3,"names":["NativeModules","NativeEventEmitter","Platform","S2OfferwallModule","eventEmitter","subscriptions","S2Offerwall","onLoginRequested","callback","sub","addListener","push","onInitCompleted","removeAllListeners","forEach","remove","initSdk","showOfferwall","placementName","setAppId","appId","setAppIdForAndroid","OS","Promise","resolve","setAppIdForIOS","setUserName","userName","displayName","getUserName","resetUserName","presentATTPopup","setConsentDialogRequired","required","requestMaxPointData","requestOfferwallData","isEmbeded","openAdItem","advId","needDetail","placementFrom","closeTop","closeAll","getPlatformVersion"],"sourceRoot":"../../src","sources":["NativeS2offerwall.ts"],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"names":["NativeModules","NativeEventEmitter","Platform","S2OfferwallModule","S2RewardedAdSlot","short","middle","long","random","S2RewardedAdRequest","constructor","requestId","slot","onLoaded","reportRewardedAdResult","onNoAd","onGranted","onDismissed","rewardedAdRequestedHandler","rewardedAdShowHandler","rewardedAdListenerBound","toRewardedAdRequest","event","bindRewardedAdListeners","requested","eventEmitter","addListener","request","show","subscriptions","push","S2Offerwall","onLoginRequested","callback","sub","onInitCompleted","removeAllListeners","forEach","remove","onRewardedAdRequested","onRewardedAdShow","result","initSdk","showOfferwall","placementName","setAppId","appId","setAppIdForAndroid","OS","Promise","resolve","setAppIdForIOS","setUserName","userName","displayName","getUserName","resetUserName","presentATTPopup","setConsentDialogRequired","required","requestMaxPointData","requestOfferwallData","isEmbeded","openAdItem","advId","needDetail","placementFrom","closeTop","closeAll","getPlatformVersion"],"sourceRoot":"../../src","sources":["NativeS2offerwall.ts"],"mappings":"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","ignoreList":[]}
@@ -1,5 +1,5 @@
1
1
  "use strict";
2
2
 
3
3
  // 올바른 파일 이름인 './NativeS2Offerwall'에서 모듈과 타입을 가져옵니다.
4
- export { S2Offerwall } from "./NativeS2offerwall.js";
4
+ export { S2Offerwall, S2RewardedAdSlot, S2RewardedAdRequest } from "./NativeS2offerwall.js";
5
5
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["S2Offerwall"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA;AACA,SAASA,WAAW,QAAQ,wBAAqB","ignoreList":[]}
1
+ {"version":3,"names":["S2Offerwall","S2RewardedAdSlot","S2RewardedAdRequest"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA;AACA,SACEA,WAAW,EACXC,gBAAgB,EAChBC,mBAAmB,QACd,wBAAqB","ignoreList":[]}
@@ -7,6 +7,46 @@ export type S2OfferwallEvent = {
7
7
  param: string;
8
8
  };
9
9
  type EventCallback = (data: S2OfferwallEvent) => void;
10
+ export declare const S2RewardedAdSlot: {
11
+ readonly short: "short";
12
+ readonly middle: "middle";
13
+ readonly long: "long";
14
+ readonly random: "random";
15
+ };
16
+ export type S2RewardedAdSlotType = (typeof S2RewardedAdSlot)[keyof typeof S2RewardedAdSlot];
17
+ /**
18
+ * 오퍼월 이벤트 페이지가 리워드 광고(RV)를 필요로 할 때 전달되는 요청이다.
19
+ *
20
+ * 매체 앱은 자신의 리워드 광고(admob 등)를 재생하고 아래 메서드 중 하나로 결과를 알린다.
21
+ * 각 요청은 반드시 한 번만 완료해야 하며, 추가 호출은 무시된다.
22
+ *
23
+ * 로딩 단계 - onRewardedAdRequested
24
+ * - onLoaded() : 광고 준비 완료
25
+ * - onNoAd() : 광고 없음. 이벤트 페이지는 기존 웹 광고로 폴백한다
26
+ *
27
+ * 재생 단계 - onRewardedAdShow
28
+ * - onGranted() : 유저가 끝까지 시청함
29
+ * - onDismissed() : 유저가 광고를 닫았거나 재생에 실패함
30
+ *
31
+ * 주의) onNoAd() 는 로딩 단계 전용이다. 재생 단계의 실패는 onDismissed() 로 알려야 한다.
32
+ * 재생 중에 광고 없음을 보고하면 이벤트 페이지가 폴백 처리를 하지 못해 버튼이 묶인다.
33
+ */
34
+ export declare class S2RewardedAdRequest {
35
+ /** 이 요청의 식별자. 결과를 되돌려 보낼 때 사용된다. */
36
+ readonly requestId: string;
37
+ /** 요청된 광고 길이. 재생 단계(onRewardedAdShow)에서는 빈 문자열이다. */
38
+ readonly slot: string;
39
+ constructor(requestId: string, slot: string);
40
+ /** 리워드 광고가 준비되었음을 알린다. (로딩 단계) */
41
+ onLoaded(): Promise<void>;
42
+ /** 재생할 광고가 없음을 알린다. (로딩 단계) */
43
+ onNoAd(): Promise<void>;
44
+ /** 유저가 광고를 끝까지 시청했음을 알린다. (재생 단계) */
45
+ onGranted(): Promise<void>;
46
+ /** 유저가 광고를 닫았거나 재생에 실패했음을 알린다. (재생 단계) */
47
+ onDismissed(): Promise<void>;
48
+ }
49
+ export type RewardedAdCallback = (request: S2RewardedAdRequest) => void;
10
50
  export declare const S2Offerwall: {
11
51
  /**
12
52
  * @description 로그인 요청 이벤트를 구독합니다.
@@ -18,8 +58,37 @@ export declare const S2Offerwall: {
18
58
  onInitCompleted(callback: EventCallback): EventSubscription;
19
59
  /**
20
60
  * @description 등록된 모든 이벤트 리스너를 제거합니다.
61
+ *
62
+ * 앱 RV 콜백(onRewardedAdRequested / onRewardedAdShow)도 함께 해제됩니다.
63
+ * 따라서 앱 RV 를 특정 화면에서만 등록하면 그 화면을 벗어난 뒤 동작하지 않습니다.
64
+ * 앱 RV 콜백은 화면 컴포넌트가 아니라 앱 진입점에서 한 번만 등록하세요.
21
65
  */
22
66
  removeAllListeners(): void;
67
+ /**
68
+ * @description 이벤트 페이지가 리워드 광고 로딩을 요청할 때 호출된다.
69
+ * 광고가 준비되면 request.onLoaded(), 광고가 없으면 request.onNoAd() 를 호출한다.
70
+ * 등록하지 않으면 이벤트 페이지는 기존처럼 웹 리워드 광고를 사용한다.
71
+ *
72
+ * 콜백은 요청이 도착한 시점에 조회되므로 initSdk() 앞뒤 어디서 등록해도 동작한다.
73
+ * 다만 등록 전에 요청이 도착하면 그 참여 1회는 웹 광고로 폴백되므로
74
+ * (크래시나 멈춤은 없지만 조용히 수익만 놓친다),
75
+ * 유저가 오퍼월을 열 수 있게 되기 전에 앱 진입점에서 등록해두는 것이 안전하다.
76
+ */
77
+ onRewardedAdRequested(callback: RewardedAdCallback): void;
78
+ /**
79
+ * @description 로딩된 리워드 광고를 재생할 때 호출된다.
80
+ * 시청이 완료되면 request.onGranted(),
81
+ * 유저가 닫았거나 재생에 실패하면 request.onDismissed() 를 호출한다.
82
+ *
83
+ * onRewardedAdRequested 와 함께 앱 진입점에서 등록한다.
84
+ */
85
+ onRewardedAdShow(callback: RewardedAdCallback): void;
86
+ /**
87
+ * @description 리워드 광고 요청의 결과를 알린다.
88
+ * 보통은 S2RewardedAdRequest 의 메서드를 사용하면 되고 직접 쓸 일은 없다.
89
+ * result 는 loaded, noad, granted, dismissed 중 하나이다.
90
+ */
91
+ reportRewardedAdResult(requestId: string, result: string): Promise<void>;
23
92
  initSdk(): Promise<void>;
24
93
  showOfferwall(placementName: string): Promise<void>;
25
94
  setAppId(appId: string): Promise<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"NativeS2offerwall.d.ts","sourceRoot":"","sources":["../../../src/NativeS2offerwall.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAMtD,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,KAAK,aAAa,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAOtD,eAAO,MAAM,WAAW;IAGtB;;OAEG;+BACwB,aAAa,GAAG,iBAAiB;IAM5D;;OAEG;8BACuB,aAAa,GAAG,iBAAiB;IAM3D;;OAEG;;eAUQ,OAAO,CAAC,IAAI,CAAC;iCAIK,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;oBAInC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;8BAIZ,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;0BAO1B,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;0BAOtB,MAAM,gBAAe,MAAM,GAAQ,OAAO,CAAC,IAAI,CAAC;mBAIvD,OAAO,CAAC,MAAM,CAAC;qBAIb,OAAO,CAAC,IAAI,CAAC;uBAIX,OAAO,CAAC,IAAI,CAAC;uCAIG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;2BAInC,OAAO,CAAC,MAAM,CAAC;wCAKrB,MAAM,aACV,OAAO,GACjB,OAAO,CAAC,MAAM,CAAC;sBAKT,MAAM,cACD,OAAO,iBACJ,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;gBAIJ,OAAO,CAAC,IAAI,CAAC;gBAIb,OAAO,CAAC,IAAI,CAAC;0BAIH,OAAO,CAAC,MAAM,CAAC;CAGtC,CAAC"}
1
+ {"version":3,"file":"NativeS2offerwall.d.ts","sourceRoot":"","sources":["../../../src/NativeS2offerwall.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAMtD,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,KAAK,aAAa,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAGtD,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAC9B,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAmB;IAC9B,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAK3C,kCAAkC;IAClC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,+BAA+B;IAC/B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,qCAAqC;IACrC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,0CAA0C;IAC1C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAkDxE,eAAO,MAAM,WAAW;IAGtB;;OAEG;+BACwB,aAAa,GAAG,iBAAiB;IAM5D;;OAEG;8BACuB,aAAa,GAAG,iBAAiB;IAM3D;;;;;;OAMG;;IAYH;;;;;;;;;OASG;oCAC6B,kBAAkB;IAKlD;;;;;;OAMG;+BACwB,kBAAkB;IAK7C;;;;OAIG;sCAC+B,MAAM,UAAU,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;eAQ7D,OAAO,CAAC,IAAI,CAAC;iCAOK,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;oBAInC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;8BAIZ,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;0BAO1B,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;0BAOtB,MAAM,gBAAe,MAAM,GAAQ,OAAO,CAAC,IAAI,CAAC;mBAIvD,OAAO,CAAC,MAAM,CAAC;qBAIb,OAAO,CAAC,IAAI,CAAC;uBAIX,OAAO,CAAC,IAAI,CAAC;uCAIG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;2BAInC,OAAO,CAAC,MAAM,CAAC;wCAKrB,MAAM,aACV,OAAO,GACjB,OAAO,CAAC,MAAM,CAAC;sBAKT,MAAM,cACD,OAAO,iBACJ,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;gBAIJ,OAAO,CAAC,IAAI,CAAC;gBAIb,OAAO,CAAC,IAAI,CAAC;0BAIH,OAAO,CAAC,MAAM,CAAC;CAGtC,CAAC"}
@@ -1,3 +1,3 @@
1
- export { S2Offerwall } from './NativeS2offerwall';
2
- export type { S2OfferwallEvent } from './NativeS2offerwall';
1
+ export { S2Offerwall, S2RewardedAdSlot, S2RewardedAdRequest, } from './NativeS2offerwall';
2
+ export type { S2OfferwallEvent, S2RewardedAdSlotType, RewardedAdCallback, } from './NativeS2offerwall';
3
3
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "react-native-s2offerwall",
3
- "version": "1.0.33",
3
+ "version": "1.0.36",
4
4
  "description": "React native plugin for S2Offerwall",
5
5
  "main": "./lib/module/index.js",
6
6
  "types": "./lib/typescript/src/index.d.ts",
@@ -17,7 +17,7 @@ Pod::Spec.new do |s|
17
17
  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
18
18
  s.private_header_files = "ios/**/*.h"
19
19
 
20
- s.dependency 's2offerwall', '~> 1.0.33'
20
+ s.dependency 's2offerwall', '~> 1.0.36'
21
21
  s.dependency 'React-Core'
22
22
 
23
23
  install_modules_dependencies(s)
@@ -11,6 +11,115 @@ export type S2OfferwallEvent =
11
11
 
12
12
  type EventCallback = (data: S2OfferwallEvent) => void;
13
13
 
14
+ // 광고 길이 구분
15
+ export const S2RewardedAdSlot = {
16
+ short: 'short',
17
+ middle: 'middle',
18
+ long: 'long',
19
+ random: 'random',
20
+ } as const;
21
+
22
+ export type S2RewardedAdSlotType =
23
+ (typeof S2RewardedAdSlot)[keyof typeof S2RewardedAdSlot];
24
+
25
+ /**
26
+ * 오퍼월 이벤트 페이지가 리워드 광고(RV)를 필요로 할 때 전달되는 요청이다.
27
+ *
28
+ * 매체 앱은 자신의 리워드 광고(admob 등)를 재생하고 아래 메서드 중 하나로 결과를 알린다.
29
+ * 각 요청은 반드시 한 번만 완료해야 하며, 추가 호출은 무시된다.
30
+ *
31
+ * 로딩 단계 - onRewardedAdRequested
32
+ * - onLoaded() : 광고 준비 완료
33
+ * - onNoAd() : 광고 없음. 이벤트 페이지는 기존 웹 광고로 폴백한다
34
+ *
35
+ * 재생 단계 - onRewardedAdShow
36
+ * - onGranted() : 유저가 끝까지 시청함
37
+ * - onDismissed() : 유저가 광고를 닫았거나 재생에 실패함
38
+ *
39
+ * 주의) onNoAd() 는 로딩 단계 전용이다. 재생 단계의 실패는 onDismissed() 로 알려야 한다.
40
+ * 재생 중에 광고 없음을 보고하면 이벤트 페이지가 폴백 처리를 하지 못해 버튼이 묶인다.
41
+ */
42
+ export class S2RewardedAdRequest {
43
+ /** 이 요청의 식별자. 결과를 되돌려 보낼 때 사용된다. */
44
+ readonly requestId: string;
45
+
46
+ /** 요청된 광고 길이. 재생 단계(onRewardedAdShow)에서는 빈 문자열이다. */
47
+ readonly slot: string;
48
+
49
+ constructor(requestId: string, slot: string) {
50
+ this.requestId = requestId;
51
+ this.slot = slot;
52
+ }
53
+
54
+ /** 리워드 광고가 준비되었음을 알린다. (로딩 단계) */
55
+ onLoaded(): Promise<void> {
56
+ return S2OfferwallModule.reportRewardedAdResult(this.requestId, 'loaded');
57
+ }
58
+
59
+ /** 재생할 광고가 없음을 알린다. (로딩 단계) */
60
+ onNoAd(): Promise<void> {
61
+ return S2OfferwallModule.reportRewardedAdResult(this.requestId, 'noad');
62
+ }
63
+
64
+ /** 유저가 광고를 끝까지 시청했음을 알린다. (재생 단계) */
65
+ onGranted(): Promise<void> {
66
+ return S2OfferwallModule.reportRewardedAdResult(this.requestId, 'granted');
67
+ }
68
+
69
+ /** 유저가 광고를 닫았거나 재생에 실패했음을 알린다. (재생 단계) */
70
+ onDismissed(): Promise<void> {
71
+ return S2OfferwallModule.reportRewardedAdResult(
72
+ this.requestId,
73
+ 'dismissed'
74
+ );
75
+ }
76
+ }
77
+
78
+ export type RewardedAdCallback = (request: S2RewardedAdRequest) => void;
79
+
80
+ // 앱 RV 는 요청마다 반드시 응답해야 하므로, 콜백이 등록되지 않았어도
81
+ // 내부 리스너가 항상 붙어서 즉시 응답할 수 있어야 한다.
82
+ // (응답하지 않으면 이벤트 페이지가 타임아웃까지 기다린다)
83
+ let rewardedAdRequestedHandler: RewardedAdCallback | null = null;
84
+ let rewardedAdShowHandler: RewardedAdCallback | null = null;
85
+ let rewardedAdListenerBound = false;
86
+
87
+ function toRewardedAdRequest(event: any): S2RewardedAdRequest {
88
+ return new S2RewardedAdRequest(event?.requestId ?? '', event?.slot ?? '');
89
+ }
90
+
91
+ function bindRewardedAdListeners() {
92
+ if (rewardedAdListenerBound) {
93
+ return;
94
+ }
95
+ rewardedAdListenerBound = true;
96
+
97
+ const requested = eventEmitter.addListener(
98
+ 'onRewardedAdRequested',
99
+ (event: any) => {
100
+ const request = toRewardedAdRequest(event);
101
+ if (rewardedAdRequestedHandler) {
102
+ rewardedAdRequestedHandler(request);
103
+ } else {
104
+ // 매체 앱이 앱 RV 를 연동하지 않았다. 즉시 광고 없음으로 응답한다.
105
+ request.onNoAd();
106
+ }
107
+ }
108
+ );
109
+
110
+ const show = eventEmitter.addListener('onRewardedAdShow', (event: any) => {
111
+ const request = toRewardedAdRequest(event);
112
+ if (rewardedAdShowHandler) {
113
+ rewardedAdShowHandler(request);
114
+ } else {
115
+ // 정상적으로는 발생할 수 없지만, 방어적으로 중단 처리한다.
116
+ request.onDismissed();
117
+ }
118
+ });
119
+
120
+ subscriptions.push(requested, show);
121
+ }
122
+
14
123
  // 핵심: S2OfferwallModule을 래핑하고 모든 메서드와 리스너를 포함하는 단일 객체입니다.
15
124
  // 이 객체를 'S2Offerwall'이라는 이름으로 명시적으로 내보냅니다.
16
125
  const eventEmitter = new NativeEventEmitter(S2OfferwallModule);
@@ -39,10 +148,56 @@ export const S2Offerwall = {
39
148
 
40
149
  /**
41
150
  * @description 등록된 모든 이벤트 리스너를 제거합니다.
151
+ *
152
+ * 앱 RV 콜백(onRewardedAdRequested / onRewardedAdShow)도 함께 해제됩니다.
153
+ * 따라서 앱 RV 를 특정 화면에서만 등록하면 그 화면을 벗어난 뒤 동작하지 않습니다.
154
+ * 앱 RV 콜백은 화면 컴포넌트가 아니라 앱 진입점에서 한 번만 등록하세요.
42
155
  */
43
156
  removeAllListeners() {
44
157
  subscriptions.forEach((sub) => sub.remove());
45
158
  subscriptions = [];
159
+
160
+ rewardedAdListenerBound = false;
161
+ rewardedAdRequestedHandler = null;
162
+ rewardedAdShowHandler = null;
163
+ },
164
+
165
+ // --- 앱 RV ---
166
+
167
+ /**
168
+ * @description 이벤트 페이지가 리워드 광고 로딩을 요청할 때 호출된다.
169
+ * 광고가 준비되면 request.onLoaded(), 광고가 없으면 request.onNoAd() 를 호출한다.
170
+ * 등록하지 않으면 이벤트 페이지는 기존처럼 웹 리워드 광고를 사용한다.
171
+ *
172
+ * 콜백은 요청이 도착한 시점에 조회되므로 initSdk() 앞뒤 어디서 등록해도 동작한다.
173
+ * 다만 등록 전에 요청이 도착하면 그 참여 1회는 웹 광고로 폴백되므로
174
+ * (크래시나 멈춤은 없지만 조용히 수익만 놓친다),
175
+ * 유저가 오퍼월을 열 수 있게 되기 전에 앱 진입점에서 등록해두는 것이 안전하다.
176
+ */
177
+ onRewardedAdRequested(callback: RewardedAdCallback) {
178
+ rewardedAdRequestedHandler = callback;
179
+ bindRewardedAdListeners();
180
+ },
181
+
182
+ /**
183
+ * @description 로딩된 리워드 광고를 재생할 때 호출된다.
184
+ * 시청이 완료되면 request.onGranted(),
185
+ * 유저가 닫았거나 재생에 실패하면 request.onDismissed() 를 호출한다.
186
+ *
187
+ * onRewardedAdRequested 와 함께 앱 진입점에서 등록한다.
188
+ */
189
+ onRewardedAdShow(callback: RewardedAdCallback) {
190
+ rewardedAdShowHandler = callback;
191
+ bindRewardedAdListeners();
192
+ },
193
+
194
+ /**
195
+ * @description 리워드 광고 요청의 결과를 알린다.
196
+ * 보통은 S2RewardedAdRequest 의 메서드를 사용하면 되고 직접 쓸 일은 없다.
197
+ * result 는 loaded, noad, granted, dismissed 중 하나이다.
198
+ */
199
+ reportRewardedAdResult(requestId: string, result: string): Promise<void> {
200
+ return S2OfferwallModule.reportRewardedAdResult(requestId, result);
46
201
  },
47
202
 
48
203
  // --- Native Module 메서드 ---
@@ -50,6 +205,9 @@ export const S2Offerwall = {
50
205
  // 모든 메서드는 NativeModules 객체에서 직접 호출되도록 래핑됩니다.
51
206
 
52
207
  initSdk(): Promise<void> {
208
+ // 콜백이 등록되지 않았더라도 앱 RV 요청에 응답할 수 있도록 리스너를 붙여둔다.
209
+ bindRewardedAdListeners();
210
+
53
211
  return S2OfferwallModule.initSdk();
54
212
  },
55
213
 
package/src/index.tsx CHANGED
@@ -1,3 +1,11 @@
1
1
  // 올바른 파일 이름인 './NativeS2Offerwall'에서 모듈과 타입을 가져옵니다.
2
- export { S2Offerwall } from './NativeS2offerwall';
3
- export type { S2OfferwallEvent } from './NativeS2offerwall';
2
+ export {
3
+ S2Offerwall,
4
+ S2RewardedAdSlot,
5
+ S2RewardedAdRequest,
6
+ } from './NativeS2offerwall';
7
+ export type {
8
+ S2OfferwallEvent,
9
+ S2RewardedAdSlotType,
10
+ RewardedAdCallback,
11
+ } from './NativeS2offerwall';