feat: add live module and optimize report list

2026-07-08 14:25:14 +08:00
parent 8ca8bcf948
commit 4a78a0c21a
14 changed files with 3712 additions and 102 deletions
--- a/suixinkan/Features/Live/API/LiveAPI.swift
+++ b/suixinkan/Features/Live/API/LiveAPI.swift
@ -0,0 +1,194 @@
+//
+//  LiveAPI.swift
+//  suixinkan
+//
+
+import Foundation
+
+/// 直播服务协议，抽象 manual-live 与 view-album 接口。
+@MainActor
+protocol LiveServing {
+    /// 拉取直播列表。
+    func liveList(scenicId: String, page: Int, pageSize: Int) async throws -> LiveListResponse
+
+    /// 拉取直播详情。
+    func liveDetail(liveId: Int) async throws -> LiveItem
+
+    /// 新建直播。
+    func createLive(scenicId: String, title: String, coverImg: String) async throws
+
+    /// 开始直播。
+    func startLive(liveId: Int) async throws
+
+    /// 暂停直播。
+    func stopLive(liveId: Int) async throws
+
+    /// 结束直播。
+    func finishLive(liveId: Int) async throws
+
+    /// 设置直播推流模式。
+    func setPushMode(liveId: Int, mode: Int) async throws
+
+    /// 拉取直播相册列表。
+    func albumList(scenicId: String, startTime: String?, endTime: String?, page: Int, pageSize: Int) async throws -> LiveAlbumFolderListResponse
+
+    /// 创建直播相册文件夹。
+    func createAlbumFolder(scenicId: String, name: String, items: [LiveAlbumFile]) async throws
+
+    /// 删除直播相册文件夹。
+    func deleteAlbumFolder(folderId: Int) async throws
+
+    /// 拉取直播相册详情。
+    func albumFolderDetail(folderId: Int) async throws -> LiveAlbumFolder
+
+    /// 删除直播相册素材。
+    func deleteAlbumFile(folderId: Int, fileId: Int) async throws
+}
+
+/// 直播 API，封装 Android `NetworkApi` 中 alive/manual-live 与 view-album 接口。
+@MainActor
+final class LiveAPI: LiveServing {
+    private let client: APIClient
+
+    /// 初始化直播 API。
+    init(client: APIClient) {
+        self.client = client
+    }
+
+    /// 拉取直播列表。
+    func liveList(scenicId: String, page: Int = 1, pageSize: Int = 10) async throws -> LiveListResponse {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/app/manual-live/list",
+                queryItems: [
+                    URLQueryItem(name: "scenic_id", value: scenicId),
+                    URLQueryItem(name: "page", value: String(max(page, 1))),
+                    URLQueryItem(name: "page_size", value: String(max(pageSize, 1))),
+                ]
+            )
+        )
+    }
+
+    /// 拉取直播详情。
+    func liveDetail(liveId: Int) async throws -> LiveItem {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/app/manual-live/detail",
+                queryItems: [URLQueryItem(name: "live_id", value: String(liveId))]
+            )
+        )
+    }
+
+    /// 新建直播。
+    func createLive(scenicId: String, title: String, coverImg: String) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/app/manual-live/create",
+                body: LiveCreateRequest(scenicId: scenicId, title: title, coverImg: coverImg)
+            )
+        )
+    }
+
+    /// 开始直播。
+    func startLive(liveId: Int) async throws {
+        try await controlLive(path: "/api/app/manual-live/start", liveId: liveId)
+    }
+
+    /// 暂停直播。
+    func stopLive(liveId: Int) async throws {
+        try await controlLive(path: "/api/app/manual-live/stop", liveId: liveId)
+    }
+
+    /// 结束直播。
+    func finishLive(liveId: Int) async throws {
+        try await controlLive(path: "/api/app/manual-live/finish", liveId: liveId)
+    }
+
+    /// 设置直播推流模式。
+    func setPushMode(liveId: Int, mode: Int) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/app/manual-live/set-push-mode",
+                body: LivePushModeRequest(liveId: liveId, manualPushMode: mode)
+            )
+        )
+    }
+
+    /// 拉取直播相册列表。
+    func albumList(
+        scenicId: String,
+        startTime: String? = nil,
+        endTime: String? = nil,
+        page: Int = 1,
+        pageSize: Int = 10
+    ) async throws -> LiveAlbumFolderListResponse {
+        var items = [
+            URLQueryItem(name: "scenic_id", value: scenicId),
+            URLQueryItem(name: "page", value: String(max(page, 1))),
+            URLQueryItem(name: "page_size", value: String(max(pageSize, 1))),
+        ]
+        if let startTime, !startTime.isEmpty {
+            items.append(URLQueryItem(name: "start_time", value: startTime))
+        }
+        if let endTime, !endTime.isEmpty {
+            items.append(URLQueryItem(name: "end_time", value: endTime))
+        }
+        return try await client.send(
+            APIRequest(method: .get, path: "/api/app/view-album/folders", queryItems: items)
+        )
+    }
+
+    /// 创建直播相册文件夹。
+    func createAlbumFolder(scenicId: String, name: String, items: [LiveAlbumFile]) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/app/view-album/create-folder",
+                body: LiveAlbumFolderCreateRequest(scenicId: scenicId, name: name, items: items)
+            )
+        )
+    }
+
+    /// 删除直播相册文件夹。
+    func deleteAlbumFolder(folderId: Int) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/app/view-album/delete-folder",
+                body: LiveAlbumFolderDeleteRequest(folderId: folderId)
+            )
+        )
+    }
+
+    /// 拉取直播相册详情。
+    func albumFolderDetail(folderId: Int) async throws -> LiveAlbumFolder {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/app/view-album/folder-detail",
+                queryItems: [URLQueryItem(name: "folder_id", value: String(folderId))]
+            )
+        )
+    }
+
+    /// 删除直播相册素材。
+    func deleteAlbumFile(folderId: Int, fileId: Int) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/app/view-album/delete-files",
+                body: LiveAlbumFileDeleteRequest(folderId: folderId, fileIds: [fileId])
+            )
+        )
+    }
+
+    private func controlLive(path: String, liveId: Int) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(method: .post, path: path, body: LiveControlRequest(liveId: liveId))
+        )
+    }
+}