Mobile Application
App 功能概覽
HoolyHi直播交友一條龍源碼 App 以 Flutter 開發，支援 iOS 與 Android 雙平台，是一款結合直播秀場、語聊房、左滑右滑配對交友、1 對 1 私密通話等功能的綜合娛樂社交應用。底部導覽列分為五大主要 Tab，各自承載獨立的功能模組。
底部五大 Tab
- 🏠 首頁 — 直播間 & 語聊房列表
- 💘 配對 — 左滑右滑 & 陌生語音配對
- 📞 通話 — 1 對 1 私密視訊 / 語音
- 📝 動態 — 社群貼文動態牆
- 👤 我的 — 個人中心 & 設定
虛擬貨幣體系
- 星幣 ⭐：iAP 購買，用於送禮 / 通話
- 鑽石 💎：主播收禮所得，可申請提現
- 支援 Apple Pay iAP 正式 / 沙盒環境
DongChi Live — App 官方引流網站
www.dongchilive.com
面向終端用戶的 App 行銷落地頁，提供 iOS / Android 下載入口、功能介紹與多語系支援。
Tab 1 — Home
首頁 — 直播 & 語聊房
首頁為 App 主入口，頂部以兩個頁籤切換「直播間」與「語聊房」列表，呈現所有進行中的房間。
直播間
列表瀏覽
- 卡片顯示主播封面、暱稱、即時觀看人數
- 依熱度排序，可依分類篩選
- 下拉刷新取得最新列表
觀眾觀看功能
- 即時觀看主播直播串流
- 公開聊天室留言互動
- 點擊主播頭像查看個人資料
- 即時觀眾 / 送禮排行榜
送禮系統
- 從禮物列表選擇禮物（消耗星幣）
- 觸發全螢幕 SVGA 動畫特效
- 連擊加速送禮（x10、x99）
- 禮物即時計入主播鑽石帳戶
- 出現在禮物排行榜
主播開播功能
- 一鍵開啟 / 關閉直播
- 設定直播封面圖 & 分類標籤
- 即時查看收禮紀錄與收益
- 封禁 / 禁言騷擾觀眾
PK 對戰
- 向其他線上主播發起 PK 邀請
- 雙方畫面並排顯示，觀眾競相送禮
- 倒計時結束比較雙方獲禮量定勝負
- PK 紀錄存入系統可供後台查詢
語聊房
列表瀏覽
- 卡片顯示房間封面、名稱、成員數
- 可見各麥位用戶頭像縮圖
- 下拉刷新取得最新列表
聽眾功能
- 進入房間即可收聽所有麥位語音
- 公開聊天室留言互動
- 送出禮物支持主持人或上麥者
- 點擊空麥位申請上麥
麥位系統
- 最多 8 個麥位同時開啟
- 每個麥位顯示上麥者頭像
- 申請上麥需主持人核准
- 主持人可鎖定 / 靜音特定麥位
主持人功能
- 建立語聊房，設定封面 & 名稱
- 邀請 / 踢出 / 靜音任意麥位
- 關閉房間結束本次語聊
- 收禮記入鑽石帳戶
Tab 2 — Match
配對交友
配對頁面提供兩種探索模式：卡片左右滑配對與陌生語音連線配對，讓用戶以不同方式結識新朋友。
左滑右滑配對
卡片瀏覽
- 每次顯示一張用戶資料卡片
- 卡片包含頭像、暱稱、年齡、簡介
- 可查看用戶相冊照片（左右滑切換）
滑動操作
- 右滑 👉：表示喜歡（Like）
- 左滑 👈：跳過此用戶（Skip）
- 雙方互相右滑即配對成功（Match）
- 配對成功後可開啟私訊對話
配對成功
- 雙方收到配對成功通知
- 進入私訊頁面開始聊天
- 可在對話中邀請對方 1 對 1 通話
私訊對話
聊天功能
- 配對成功後解鎖私訊對話頻道
- 支援文字、表情符號、圖片訊息
- 訊息已讀回執
- 可在對話中邀請對方進行 1 對 1 通話
私訊中送禮
- 在私訊介面點擊禮物圖示開啟禮物面板
- 選擇禮物後觸發動畫特效於對話視窗
- 消耗發送方星幣，計入對方鑽石收益
- 禮物訊息顯示在對話紀錄中
- 對方收到推播通知提醒
陌生語音配對
功能說明
- 隨機與線上陌生用戶進行語音連線
- 雙方無需事先配對即可直接通話
- 系統自動媒合等待中的雙方
- 適合喜歡即興社交的用戶
通話中功能
- 即時語音雙向通話
- 可查看對方基本資料與頭像
- 送出禮物（消耗星幣）
- 對方收到禮物記入收益
- 任一方可隨時結束通話 / 換下一位
後續互動
- 通話後可選擇加對方為好友
- 若雙方互有好感可繼續私訊
- 也可邀請進行 1 對 1 私密通話
Tab 3 — Private Call
1 對 1 私密通話
1 對 1 私密通話頁面提供視訊與語音兩種私密連線模式，適合已配對或已互加好友的用戶進行深度交流。通話過程中支援送禮互動。
視訊通話
發起通話
- 從好友列表或配對頁發起視訊邀請
- 對方收到通話邀請通知
- 對方接受後雙方建立視訊連線
- 拒絕則通話取消，發起方收到通知
通話中功能
- 高清雙向視訊串流
- 切換前 / 後鏡頭
- 開啟 / 關閉麥克風
- 開啟 / 關閉本地視訊畫面
- 文字聊天輸入框（同時可傳訊）
通話中送禮
- 通話過程中可向對方送出禮物
- 禮物觸發 SVGA 動畫特效
- 消耗發送方星幣
- 對方收到後計入其鑽石收益
語音通話
發起語音
- 與視訊通話相同流程，但不開啟攝影機
- 介面顯示雙方頭像與通話計時
- 適合不想開鏡頭的私密對談
通話中功能
- 高品質雙向語音串流
- 開啟 / 關閉麥克風
- 切換揚聲器 / 聽筒
- 同樣支援通話中送禮
通話計費
- 通話可依分鐘計費（消耗星幣）
- 主播設定每分鐘費率
- 星幣扣除記錄可在個人中心查詢
- 餘額不足時通話自動結束
Tab 4 — Feed
動態牆
動態牆是 App 的社群廣場，用戶可發布圖片或文字貼文，瀏覽他人動態並互動。貼文發布後需通過後台審核才公開顯示。
瀏覽動態
列表顯示
- 瀑布流顯示所有通過審核的公開貼文
- 每則貼文顯示作者頭像、暱稱、發布時間
- 貼文內容含圖片（最多多張）與文字
- 下拉刷新 / 上拉載入更多
互動功能
- 按讚（雙擊圖片或點愛心按鈕）
- 留言回覆（含文字輸入與送出）
- 點擊作者頭像進入其個人主頁
- 點擊作者暱稱查看完整資料
發布貼文
發布步驟
- 點擊「＋ 發布」按鈕進入編輯頁
- 從相冊選擇或拍攝圖片（可多選）
- 輸入貼文文字描述
- 點擊送出，貼文進入審核佇列
審核機制
- 送出後系統 AI 初步掃描圖片內容
- 通過 AI 審核後進入後台人工審核佇列
- 管理員審核通過後貼文才公開顯示
- 不通過的貼文用戶會收到拒絕通知
Tab 5 — Profile
個人中心
個人中心整合帳號管理、相冊、虛擬貨幣、設定等所有個人功能，是用戶管理自身帳號資產的核心入口。
登入 & 帳號
登入方式
- Apple Sign In（iOS 原生）
- Google OAuth 登入
- 首次登入自動建立帳號
- JWT Token 維持登入狀態
個人資料
- 設定暱稱、大頭貼、個人簡介
- 頭像上傳經 AI NSFW 內容審核
- 上傳個人相冊（需後台審核通過後公開）
- 查看自己的直播 / 語聊 / 動態歷史
虛擬貨幣
| 幣種 | 取得方式 | 用途 | 備註 |
|---|---|---|---|
| 星幣 ⭐ | App 內 iAP 購買（Apple Pay） | 直播送禮、語聊房送禮、1 對 1 通話付費 | 不可退款，不可提現 |
| 鑽石 💎 | 觀眾送禮折算所得 | 申請提現（換算成現金） | 僅主播 / 主持人帳號可累積 |
iAP 購買星幣
- 選擇充值方案（依方案不同有折扣）
- 透過 Apple Pay 完成付款
- 購買即時到帳，可立刻使用
- 正式購買紀錄計入後台財務報表
鑽石提現
- 在個人中心查看鑽石餘額
- 點擊「申請提現」填寫金額與帳戶
- 提現申請送至後台等候管理員審核
- 審核通過後撥款至指定帳戶
申請成為主播
申請入口
- 個人中心 → 點擊「申請成為主播」
- 填寫真實姓名、聯繫方式等基本資料
- 上傳身份驗證文件（身分證正反面）
- 選填自我介紹與直播類型意向
審核流程
- 申請送出後進入後台主播審核佇列
- 管理員核對身份文件資料
- 審核通過後帳號升級為主播帳號
- 通過 / 拒絕均會收到 App 推播通知
主播帳號權限
- 解鎖「開播」功能，可在首頁發起直播
- 可擔任語聊房主持人並開房
- 觀眾送禮折算鑽石，可申請提現
- 後台「主播管理」頁面可查看主播資料
ℹ️一般用戶帳號預設只有觀看、送禮、配對等功能。唯有通過主播審核後，才能開啟直播 / 語聊房主持人功能，並累積鑽石收益。
美顏設定
美顏功能
- 開播前 / 通話前可進入美顏設定頁
- 磨皮：滑桿調整肌膚平滑程度
- 美白：調整膚色亮度
- 瘦臉：臉型修飾程度調整
- 大眼：眼部放大效果調整
濾鏡
- 多種色調濾鏡可套用於鏡頭畫面
- 點選縮圖即時預覽效果
- 可同時疊加美顏 + 濾鏡
- 設定儲存後下次開播自動套用
適用場景
- 直播開播前
- 1 對 1 視訊通話中（可即時調整）
- 陌生語音配對（語音無視訊時停用）
多國語言支援
App 介面支援多語系，首次啟動時自動偵測裝置語言設定，用戶也可在設定中手動切換。
目前支援語系
- 🇹🇼 繁體中文
- 🇨🇳 簡體中文
- 🇺🇸 English（英文）
- 🇻🇳 Tiếng Việt（越南語）
- 🇯🇵 日本語
- 🇰🇷 한국어（韓語）
- 🇸🇦 العربية（阿拉伯語）
- 🇮🇩 Bahasa Indonesia
- 🇮🇳 हिन्दी（印地語）
- 🇪🇸 Español（西班牙語）
- 🇧🇷 Português（葡萄牙語）
- 🇷🇺 Русский（俄語）
語言切換方式
- 個人中心 → 設定 → 語言
- 選擇語系後 App 介面立即切換
- 無需重新啟動 App
- 阿拉伯語自動切換為 RTL 右至左排版
客服中心
進入方式
- 個人中心 → 客服中心
- 或直播 / 語聊房內長按舉報後自動轉入
功能說明
- 即時文字對話介面，訊息發送後等待客服回覆
- 可上傳截圖作為問題佐證
- 歷史對話紀錄完整保留
- 客服由後台管理員在「客服對話」頁面統一回覆
常見反映類型
- 帳號問題（無法登入、被封禁申訴）
- 付款問題（星幣未到帳、iAP 失敗）
- 舉報用戶 / 不當內容
- 功能異常回報
其他設定
通知設定
- 開啟 / 關閉配對成功通知
- 開啟 / 關閉私訊通知
- 開啟 / 關閉系統公告通知
帳號安全
- 查看登入裝置紀錄
- 登出當前裝置
- 申請刪除帳號（不可逆）
Level System
等級說明
App 同時設有「觀眾等級」與「主播等級」兩套獨立等級體系，隨活躍度與消費自動升級，解鎖更多特權與收益加成。等級門檻與圖示可由後台「等級配置」頁面彈性調整。
👥 觀眾等級（Viewer Level）
- 依累計消費星幣數量計算經驗值
- 等級越高，個人頭像旁顯示的徽章越稀有
- 高等級用戶在房間內擁有更顯眼的進場特效
- 部分高等級功能（如專屬貼圖）可配置解鎖條件
🎙️ 主播等級（Streamer Level）
- 依累計收到的鑽石（禮物收益）計算
- 等級影響主播排行榜排名與曝光優先度
- 高等級主播可享受更高比例的鑽石提現加成
- 等級標籤顯示於主播個人頁及直播間頭像旁
⚙️ 後台等級配置
- 管理員可在「工具 › 等級配置」新增 / 編輯等級
- 每個等級可設定：名稱、所需經驗值門檻、圖示
- 觀眾與主播等級分開設定，互不影響
- 異動後即時生效，無需重啟 App
升級機制說明
| 等級類型 | 經驗值來源 | 重置規則 | 顯示位置 |
|---|---|---|---|
| 觀眾等級 | 消費星幣（送禮 / 通話扣費） | 累計不重置 | 頭像徽章、進場特效 |
| 主播等級 | 收到禮物換算鑽石 | 累計不重置 | 個人頁、直播間標籤 |