1

src/services/big-fish-runtime/bigFishRuntimeClient.ts

@@ -0,0 +1,33 @@
+import type {
+  BigFishSessionResponse,
+  RecordBigFishPlayRequest,
+} from '../../../packages/shared/src/contracts/bigFish';
+import { type ApiRetryOptions, requestJson } from '../apiClient';
+
+const BIG_FISH_RUNTIME_WRITE_RETRY: ApiRetryOptions = {
+  maxRetries: 1,
+  baseDelayMs: 120,
+  maxDelayMs: 360,
+  retryUnsafeMethods: true,
+};
+
+/**
+ * 上报大鱼吃小鱼正式游玩。elapsedMs 为 0 时仅标记玩过作品。
+ */
+export function recordBigFishPlay(
+  sessionId: string,
+  payload: RecordBigFishPlayRequest,
+) {
+  return requestJson<BigFishSessionResponse>(
+    `/api/runtime/big-fish/sessions/${encodeURIComponent(sessionId)}/play`,
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+    },
+    '记录大鱼吃小鱼游玩失败',
+    {
+      retry: BIG_FISH_RUNTIME_WRITE_RETRY,
+    },
+  );
+}

src/services/big-fish-runtime/index.ts

@@ -2,3 +2,4 @@ export {
   advanceLocalBigFishRuntimeRun,
   startLocalBigFishRuntimeRun,
 } from './bigFishLocalRuntime';
+export { recordBigFishPlay } from './bigFishRuntimeClient';

src/services/big-fish-works/bigFishWorksClient.ts

@@ -46,7 +46,24 @@ export async function deleteBigFishWork(sessionId: string) {
   );
 }
 
+/**
+ * 记录已发布大鱼吃小鱼作品的一次正式进入。
+ */
+export async function recordBigFishWorkPlay(sessionId: string) {
+  return requestJson<BigFishWorksResponse>(
+    `${BIG_FISH_WORKS_API_BASE}/${encodeURIComponent(sessionId)}/play`,
+    {
+      method: 'POST',
+    },
+    '记录大鱼吃小鱼游玩次数失败',
+    {
+      retry: BIG_FISH_WORKS_WRITE_RETRY,
+    },
+  );
+}
+
 export const bigFishWorksClient = {
   delete: deleteBigFishWork,
   list: listBigFishWorks,
+  recordPlay: recordBigFishWorkPlay,
 };

src/services/big-fish-works/index.ts

@@ -2,4 +2,5 @@ export {
   bigFishWorksClient,
   deleteBigFishWork,
   listBigFishWorks,
+  recordBigFishWorkPlay,
 } from './bigFishWorksClient';

src/services/rpg-entry/rpgProfileClient.ts

@@ -11,6 +11,7 @@ import type {
   ProfileSaveArchiveResumeResponse,
   ProfileWalletLedgerResponse,
   RedeemProfileReferralInviteCodeResponse,
+  RedeemProfileRewardCodeResponse,
   RuntimeSettings,
 } from '../../../packages/shared/src/contracts/runtime';
 import { rehydrateSavedSnapshot } from '../../persistence/runtimeSnapshot';
@@ -125,6 +126,22 @@ export function redeemRpgProfileReferralInviteCode(
   );
 }
 
+export function redeemRpgProfileRewardCode(
+  code: string,
+  options: RuntimeRequestOptions = {},
+) {
+  return requestRpgRuntimeJson<RedeemProfileRewardCodeResponse>(
+    '/profile/redeem-codes/redeem',
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ code }),
+    },
+    '兑换失败',
+    options,
+  );
+}
+
 export function getRpgProfilePlayStats(options: RuntimeRequestOptions = {}) {
   return requestRpgRuntimeJson<ProfilePlayStatsResponse>(
     '/profile/play-stats',