Add VIP presence themes and custom greetings

2026-04-11 15:44:30 +08:00
parent 9fb7710079
commit 4eba9dfc12
21 changed files with 1126 additions and 49 deletions
@@ -0,0 +1,112 @@
+<?php
+
+/**
+ * 文件功能：会员进退场主题服务
+ * 统一解析会员等级主题、用户自定义文案、特效和横幅风格，
+ * 避免聊天室进场与离场逻辑在多个位置重复拼装数据。
+ */
+
+namespace App\Services;
+
+use App\Models\User;
+
+class VipPresenceService
+{
+    /**
+     * 构造会员进退场主题服务实例。
+     */
+    public function __construct(
+        private readonly VipService $vipService,
+    ) {}
+
+    /**
+     * 构建会员入场主题数据。
+     *
+     * @return array<string, string|null|bool>
+     */
+    public function buildJoinTheme(User $user): array
+    {
+        return $this->buildTheme($user, 'join');
+    }
+
+    /**
+     * 构建会员离场主题数据。
+     *
+     * @return array<string, string|null|bool>
+     */
+    public function buildLeaveTheme(User $user): array
+    {
+        return $this->buildTheme($user, 'leave');
+    }
+
+    /**
+     * 统一构建会员进场或离场的主题数据。
+     *
+     * @param  string  $type  join|leave
+     * @return array<string, string|null|bool>
+     */
+    private function buildTheme(User $user, string $type): array
+    {
+        $vipLevel = $user->vipLevel;
+
+        if (! $user->isVip() || ! $vipLevel) {
+            return [
+                'enabled' => false,
+                'type' => $type,
+                'text' => null,
+                'color' => null,
+                'effect' => null,
+                'banner_style' => null,
+                'level_name' => null,
+                'icon' => null,
+            ];
+        }
+
+        // 先读取个人自定义文案，只有等级允许时才参与覆盖。
+        $customMessage = $type === 'join'
+            ? $this->formatCustomMessage($user->custom_join_message, $user->username)
+            : $this->formatCustomMessage($user->custom_leave_message, $user->username);
+
+        if (! $user->canCustomizeVipPresence()) {
+            $customMessage = null;
+        }
+
+        // 如果用户没有填写自定义文案，则回退到等级模板。
+        $templateMessage = $type === 'join'
+            ? $this->vipService->getJoinMessage($user)
+            : $this->vipService->getLeaveMessage($user);
+
+        return [
+            'enabled' => true,
+            'type' => $type,
+            'text' => $customMessage ?: $templateMessage,
+            'color' => $vipLevel->color ?: '#f59e0b',
+            'effect' => $type === 'join' ? $this->normalizeEffect($vipLevel->joinEffectKey()) : $this->normalizeEffect($vipLevel->leaveEffectKey()),
+            'banner_style' => $type === 'join' ? $vipLevel->joinBannerStyleKey() : $vipLevel->leaveBannerStyleKey(),
+            'level_name' => $vipLevel->name,
+            'icon' => $vipLevel->icon,
+        ];
+    }
+
+    /**
+     * 格式化用户自定义文案，支持 {username} 占位符。
+     */
+    private function formatCustomMessage(?string $message, string $username): ?string
+    {
+        $message = trim((string) $message);
+
+        if ($message === '') {
+            return null;
+        }
+
+        return str_replace('{username}', $username, $message);
+    }
+
+    /**
+     * 把 none 这类占位值转换为 null，方便外部判断是否要播特效。
+     */
+    private function normalizeEffect(string $effect): ?string
+    {
+        return $effect === 'none' ? null : $effect;
+    }
+}