兼容 IOS

2.新增打包构建脚本

.gitignore

@@ -18,6 +18,8 @@ pubspec.lock
 *.ipr
 *.iws
 .idea/
+.cursor
+Podfile.lock
 
 # The .vscode folder contains launch configuration and tasks you configure in
 # VS Code which you may wish to be included in version control, so this line
@@ -44,3 +46,5 @@ app.*.map.json
 /android/app/debug
 /android/app/profile
 /android/app/release
+/android/.kotlin
+

android/app/build.gradle.kts

@@ -4,7 +4,7 @@ plugins {
     id("dev.flutter.flutter-gradle-plugin")
 }
 
-val appPackageName = "com.qxy.dronex"
+val appPackageName = "com.dronex.rec"
 
 android {
     namespace = appPackageName

android/app/src/debug/AndroidManifest.xml

@@ -1,7 +0,0 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
-    <!-- The INTERNET permission is required for development. Specifically,
-         the Flutter tool needs it to communicate with the running application
-         to allow setting breakpoints, to provide hot reload, etc.
-    -->
-    <uses-permission android:name="android.permission.INTERNET"/>
-</manifest>

android/app/src/main/AndroidManifest.xml

@@ -1,5 +1,6 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    package="com.qxy.dronex">
+    package="com.dronex.rec">
+    <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.CAMERA" />
     <uses-permission android:name="android.permission.RECORD_AUDIO" />
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

android/app/src/main/kotlin/com/dronex/rec/AppConstants.kt

@@ -1,7 +1,7 @@
-package com.qxy.dronex
+package com.dronex.rec
 
 object AppConstants {
-    const val PACKAGE_NAME = "com.qxy.dronex"
+    const val PACKAGE_NAME = "com.dronex.rec"
     const val PLATFORM_INFO_CHANNEL = "$PACKAGE_NAME/platform_info"
     const val RECORDING_METHOD_CHANNEL = "$PACKAGE_NAME/recording"
     const val RECORDING_EVENT_CHANNEL = "$PACKAGE_NAME/recording_events"

android/app/src/main/kotlin/com/dronex/rec/MainActivity.kt

@@ -1,4 +1,4 @@
-package com.qxy.dronex
+package com.dronex.rec
 
 import android.content.Context
 import android.content.pm.ApplicationInfo
@@ -7,8 +7,8 @@ import android.os.Build
 import android.os.Environment
 import android.os.StatFs
 import androidx.camera.view.PreviewView
-import com.qxy.dronex.recording.RecordingPlatformHandler
+import com.dronex.rec.recording.RecordingPlatformHandler
-import com.qxy.dronex.recording.RecordingPreviewFactory
+import com.dronex.rec.recording.RecordingPreviewFactory
 import io.flutter.embedding.android.FlutterActivity
 import io.flutter.embedding.engine.FlutterEngine
 import io.flutter.plugin.common.MethodChannel
@@ -114,6 +114,7 @@ class MainActivity : FlutterActivity() {
                 "brand" to Build.BRAND,
                 "model" to Build.MODEL,
                 "systemVersion" to Build.VERSION.RELEASE,
+                "sdkInt" to Build.VERSION.SDK_INT,
                 "isPhysicalDevice" to !isEmulator,
         )
     }

android/app/src/main/kotlin/com/dronex/rec/recording/BatteryOptimizationHelper.kt

@@ -1,4 +1,4 @@
-package com.qxy.dronex.recording
+package com.dronex.rec.recording
 
 import android.content.Context
 import android.content.Intent

android/app/src/main/kotlin/com/dronex/rec/recording/DoNotDisturbHelper.kt

@@ -1,4 +1,4 @@
-package com.qxy.dronex.recording
+package com.dronex.rec.recording
 
 import android.app.NotificationManager
 import android.content.Context

android/app/src/main/kotlin/com/dronex/rec/recording/RecordingCameraController.kt

@@ -0,0 +1,588 @@
+package com.dronex.rec.recording
+
+import android.content.Context
+import android.hardware.camera2.CameraCharacteristics
+import android.hardware.camera2.CameraManager
+import android.util.Log
+import androidx.camera.camera2.interop.Camera2CameraInfo
+import androidx.camera.core.Camera
+import androidx.camera.core.CameraSelector
+import androidx.camera.core.Preview
+import androidx.camera.lifecycle.ProcessCameraProvider
+import androidx.camera.video.Quality
+import androidx.camera.video.QualitySelector
+import androidx.camera.video.Recorder
+import androidx.camera.video.Recording
+import androidx.camera.video.VideoCapture
+import androidx.camera.video.VideoRecordEvent
+import androidx.camera.view.PreviewView
+import androidx.core.content.ContextCompat
+import androidx.lifecycle.LifecycleOwner
+import kotlin.math.atan
+import java.util.concurrent.Executor
+
+class RecordingCameraController(
+        private val appContext: Context,
+) {
+    private val mainExecutor: Executor = ContextCompat.getMainExecutor(appContext)
+
+    private var cameraProvider: ProcessCameraProvider? = null
+    private var preview: Preview? = null
+    private var videoCapture: VideoCapture<Recorder>? = null
+    private var camera: Camera? = null
+    private var mainCameraId: String? = null
+    private var ultraWideCameraId: String? = null
+    private var ultraWideZoomRatio: Float = DEFAULT_ULTRA_WIDE_ZOOM_RATIO
+    private var currentLensMode: LensMode = LensMode.MAIN
+    private var activeRecording: Recording? = null
+    private var boundLifecycleOwner: LifecycleOwner? = null
+    private var currentZoomRatio: Float = 1f
+
+    var status: RecordingStatus = RecordingStatus(RecordingState.IDLE)
+        private set
+
+    var statusListener: ((RecordingStatus) -> Unit)? = null
+
+    private var recordingStartedAt: Long = 0L
+    private var latestOutputPath: String? = null
+    private var pendingStopCallback: ((String?) -> Unit)? = null
+
+    fun bindPreview(
+            lifecycleOwner: LifecycleOwner,
+            previewView: PreviewView,
+            onReady: (Boolean) -> Unit,
+    ) {
+        val future = ProcessCameraProvider.getInstance(appContext)
+        future.addListener(
+                {
+                    try {
+                        val provider = future.get()
+                        cameraProvider = provider
+                        boundLifecycleOwner = lifecycleOwner
+
+                        preview =
+                                Preview.Builder().build().also {
+                                    it.surfaceProvider = previewView.surfaceProvider
+                                }
+
+                        val recorder =
+                                Recorder.Builder()
+                                        .setQualitySelector(QualitySelector.from(Quality.HD))
+                                        .build()
+                        videoCapture = VideoCapture.withOutput(recorder)
+
+                        discoverBackCameras(provider)
+                        bindUseCases(provider, lifecycleOwner, selectorForCurrentLensMode())
+                        applyCurrentZoom()
+
+                        updateStatus(RecordingStatus(RecordingState.PREVIEWING))
+                        onReady(true)
+                    } catch (error: Exception) {
+                        Log.e(TAG, "bindPreview failed", error)
+                        updateStatus(
+                                RecordingStatus(
+                                        RecordingState.ERROR,
+                                        message = error.message,
+                                ),
+                        )
+                        onReady(false)
+                    }
+                },
+                mainExecutor,
+        )
+    }
+
+    fun rebindForRecording(
+            lifecycleOwner: LifecycleOwner,
+            previewView: PreviewView,
+            onReady: (Boolean) -> Unit,
+    ) {
+        val provider = cameraProvider
+        if (provider == null) {
+            bindPreview(lifecycleOwner, previewView, onReady)
+            return
+        }
+
+        if (
+                boundLifecycleOwner === lifecycleOwner &&
+                        preview != null &&
+                        videoCapture != null
+        ) {
+            onReady(true)
+            return
+        }
+
+        try {
+            boundLifecycleOwner = lifecycleOwner
+            bindUseCases(provider, lifecycleOwner, selectorForCurrentLensMode())
+            applyCurrentZoom()
+            onReady(true)
+        } catch (error: Exception) {
+            Log.e(TAG, "rebindForRecording failed", error)
+            onReady(false)
+        }
+    }
+
+    fun startRecording(
+            withAudio: Boolean,
+            displayName: String?,
+            onStarted: (Boolean, String?) -> Unit,
+    ) {
+        val capture = videoCapture
+        if (capture == null || boundLifecycleOwner == null) {
+            onStarted(false, "Camera not ready")
+            return
+        }
+
+        if (activeRecording != null) {
+            onStarted(false, "Already recording")
+            return
+        }
+
+        val outputOptions =
+                RecordingOutputFactory.buildMediaStoreOutputOptions(
+                        appContext,
+                        displayName,
+                )
+        latestOutputPath = null
+
+        val pending =
+                capture.output.prepareRecording(appContext, outputOptions).apply {
+                    if (withAudio) {
+                        val granted =
+                                ContextCompat.checkSelfPermission(
+                                        appContext,
+                                        android.Manifest.permission.RECORD_AUDIO,
+                                ) == android.content.pm.PackageManager.PERMISSION_GRANTED
+                        if (granted) {
+                            withAudioEnabled()
+                        }
+                    }
+                }
+
+        recordingStartedAt = System.currentTimeMillis()
+        updateStatus(
+                RecordingStatus(
+                        RecordingState.RECORDING,
+                        outputPath = latestOutputPath,
+                ),
+        )
+
+        activeRecording =
+                pending.start(mainExecutor) { event ->
+                    when (event) {
+                        is VideoRecordEvent.Start -> Unit
+                        is VideoRecordEvent.Finalize -> {
+                            activeRecording = null
+                            if (event.hasError()) {
+                                updateStatus(
+                                        RecordingStatus(
+                                                RecordingState.ERROR,
+                                                message = event.cause?.message
+                                                                ?: "Recording failed",
+                                        ),
+                                )
+                            } else {
+                                latestOutputPath = event.outputResults.outputUri.toString()
+                                updateStatus(
+                                        RecordingStatus(
+                                                RecordingState.PREVIEWING,
+                                                outputPath = latestOutputPath,
+                                                elapsedMillis =
+                                                        System.currentTimeMillis() -
+                                                                recordingStartedAt,
+                                        ),
+                                )
+                            }
+                            val stopCallback = pendingStopCallback
+                            pendingStopCallback = null
+                            stopCallback?.invoke(latestOutputPath)
+                        }
+                    }
+                }
+
+        onStarted(true, latestOutputPath ?: "recording")
+    }
+
+    fun stopRecording(onStopped: (String?) -> Unit) {
+        val recording = activeRecording
+        if (recording == null) {
+            onStopped(latestOutputPath)
+            return
+        }
+
+        pendingStopCallback = onStopped
+        updateStatus(
+                RecordingStatus(
+                        RecordingState.STOPPING,
+                        outputPath = latestOutputPath,
+                ),
+        )
+
+        recording.stop()
+        activeRecording = null
+    }
+
+    fun zoomCapabilitiesMap(): Map<String, Any> {
+        val zoomState = camera?.cameraInfo?.zoomState?.value
+        val logicalMin = zoomState?.minZoomRatio ?: 1f
+        // 兜底两路超广角来源：独立超广角镜头(0.6) 与 逻辑相机原生 <1.0 变焦范围，取更小者。
+        val minZoom =
+                if (hasUltraWideCamera()) {
+                    minOf(ultraWideZoomRatio, logicalMin)
+                } else {
+                    logicalMin
+                }
+        val maxZoom = zoomState?.maxZoomRatio ?: 3f
+        val zoom =
+                if (currentLensMode == LensMode.ULTRA_WIDE) {
+                    ultraWideZoomRatio
+                } else {
+                    (zoomState?.zoomRatio ?: currentZoomRatio).coerceIn(minZoom, maxZoom)
+                }
+        currentZoomRatio = zoom
+        Log.d(
+                TAG,
+                "zoomCapabilities hasUltraWide=${hasUltraWideCamera()} logicalMin=$logicalMin " +
+                        "ultraWideZoomRatio=$ultraWideZoomRatio minZoom=$minZoom maxZoom=$maxZoom zoom=$zoom",
+        )
+        return mapOf(
+                "zoomRatio" to zoom.toDouble(),
+                "minZoomRatio" to minZoom.toDouble(),
+                "maxZoomRatio" to maxZoom.toDouble(),
+        )
+    }
+
+    fun setZoomRatio(
+            ratio: Double,
+            onComplete: (Boolean, Map<String, Any>, String?) -> Unit,
+    ) {
+        val boundCamera = camera
+        if (boundCamera == null) {
+            val clamped =
+                    if (ratio < 1.0 && hasUltraWideCamera()) {
+                        ultraWideZoomRatio
+                    } else {
+                        ratio.toFloat().coerceAtLeast(1f)
+                    }
+            currentZoomRatio = clamped
+            onComplete(true, zoomCapabilitiesMap(), null)
+            return
+        }
+
+        if (ratio < 1.0 && hasUltraWideCamera()) {
+            switchToUltraWide(onComplete)
+            return
+        }
+
+        if (currentLensMode == LensMode.ULTRA_WIDE) {
+            switchToMainAndZoom(ratio, onComplete)
+            return
+        }
+
+        val zoomState = boundCamera.cameraInfo.zoomState.value
+        val minZoom = zoomState?.minZoomRatio ?: 1f
+        val maxZoom = zoomState?.maxZoomRatio ?: clampedMaxZoom()
+        val nextZoom = ratio.toFloat().coerceIn(minZoom, maxZoom)
+        currentZoomRatio = nextZoom
+
+        val future = boundCamera.cameraControl.setZoomRatio(nextZoom)
+        future.addListener(
+                {
+                    try {
+                        future.get()
+                        onComplete(true, zoomCapabilitiesMap(), null)
+                    } catch (error: Exception) {
+                        Log.e(TAG, "setZoomRatio failed", error)
+                        onComplete(false, zoomCapabilitiesMap(), error.message)
+                    }
+                },
+                mainExecutor,
+        )
+    }
+
+    fun unbind() {
+        activeRecording?.stop()
+        activeRecording = null
+        cameraProvider?.unbindAll()
+        cameraProvider = null
+        preview = null
+        videoCapture = null
+        camera = null
+        boundLifecycleOwner = null
+        currentLensMode = LensMode.MAIN
+        currentZoomRatio = 1f
+        ultraWideZoomRatio = DEFAULT_ULTRA_WIDE_ZOOM_RATIO
+        updateStatus(RecordingStatus(RecordingState.IDLE))
+    }
+
+    fun elapsedMillis(): Long {
+        if (status.state != RecordingState.RECORDING) return 0L
+        return System.currentTimeMillis() - recordingStartedAt
+    }
+
+    private fun updateStatus(next: RecordingStatus) {
+        status = next
+        statusListener?.invoke(next)
+    }
+
+    private fun applyCurrentZoom() {
+        val boundCamera = camera ?: return
+        if (currentLensMode == LensMode.ULTRA_WIDE) {
+            currentZoomRatio = ultraWideZoomRatio
+            boundCamera.cameraControl.setZoomRatio(1f)
+            return
+        }
+        val zoomState = boundCamera.cameraInfo.zoomState.value
+        val minZoom = zoomState?.minZoomRatio ?: 1f
+        val maxZoom = zoomState?.maxZoomRatio ?: clampedMaxZoom()
+        currentZoomRatio = currentZoomRatio.coerceIn(minZoom, maxZoom)
+        boundCamera.cameraControl.setZoomRatio(currentZoomRatio)
+    }
+
+    private fun clampedMaxZoom(): Float {
+        return camera?.cameraInfo?.zoomState?.value?.maxZoomRatio ?: 3f
+    }
+
+    private fun discoverBackCameras(provider: ProcessCameraProvider) {
+        if (mainCameraId == null) {
+            mainCameraId = cameraIdForSelector(provider, CameraSelector.DEFAULT_BACK_CAMERA)
+        }
+        val ultraWideCamera = findUltraWideCamera(provider, mainCameraId)
+        ultraWideCameraId = ultraWideCamera?.cameraId
+        ultraWideZoomRatio = ultraWideCamera?.zoomRatio ?: DEFAULT_ULTRA_WIDE_ZOOM_RATIO
+        if (ultraWideCamera == null && currentLensMode == LensMode.ULTRA_WIDE) {
+            currentLensMode = LensMode.MAIN
+            currentZoomRatio = 1f
+        }
+        Log.d(
+                TAG,
+                "mainCameraId=$mainCameraId ultraWideCameraId=$ultraWideCameraId " +
+                        "ultraWideZoomRatio=$ultraWideZoomRatio",
+        )
+    }
+
+    private fun cameraIdForSelector(
+            provider: ProcessCameraProvider,
+            selector: CameraSelector,
+    ): String? {
+        return try {
+            val infos = selector.filter(provider.availableCameraInfos)
+            infos.firstOrNull()?.let { Camera2CameraInfo.from(it).cameraId }
+        } catch (error: Exception) {
+            Log.w(TAG, "cameraIdForSelector failed", error)
+            null
+        }
+    }
+
+    private fun findUltraWideCamera(
+            provider: ProcessCameraProvider,
+            excludedCameraId: String?,
+    ): UltraWideCamera? {
+        val manager = appContext.getSystemService(Context.CAMERA_SERVICE) as CameraManager
+        val candidates =
+                manager.cameraIdList
+                        .mapNotNull { cameraId -> backCameraProfile(manager, cameraId) }
+                        .filter { it.cameraId != excludedCameraId }
+                        .filter { provider.hasCameraSafely(selectorForCameraId(it.cameraId)) }
+                        .sortedWith(
+                                compareByDescending<CameraProfile> { it.horizontalFov }
+                                        .thenBy { it.minFocalLength },
+                        )
+
+        val mainProfile = excludedCameraId?.let { backCameraProfile(manager, it) }
+        val widest = candidates.firstOrNull() ?: return null
+        val candidatesDesc =
+                candidates.joinToString { "id=${it.cameraId} fov=${it.horizontalFov} focal=${it.minFocalLength}" }
+        val mainDesc =
+                mainProfile?.let { "id=${it.cameraId} fov=${it.horizontalFov} focal=${it.minFocalLength}" }
+        Log.d(TAG, "ultraWide candidates=[$candidatesDesc] main=$mainDesc")
+        if (mainProfile == null) {
+            return UltraWideCamera(widest.cameraId, DEFAULT_ULTRA_WIDE_ZOOM_RATIO)
+        }
+
+        val meaningfullyWider =
+                widest.horizontalFov > mainProfile.horizontalFov * ULTRA_WIDE_FOV_FACTOR ||
+                        widest.minFocalLength < mainProfile.minFocalLength * ULTRA_WIDE_FOCAL_FACTOR
+        Log.d(
+                TAG,
+                "ultraWide decision widest=${widest.cameraId} meaningfullyWider=$meaningfullyWider " +
+                        "(fovFactor=$ULTRA_WIDE_FOV_FACTOR focalFactor=$ULTRA_WIDE_FOCAL_FACTOR)",
+        )
+        if (!meaningfullyWider) {
+            return null
+        }
+
+        return UltraWideCamera(widest.cameraId, DEFAULT_ULTRA_WIDE_ZOOM_RATIO)
+    }
+
+    private fun backCameraProfile(
+            manager: CameraManager,
+            cameraId: String,
+    ): CameraProfile? {
+        return try {
+            val characteristics = manager.getCameraCharacteristics(cameraId)
+            val facing = characteristics.get(CameraCharacteristics.LENS_FACING)
+            if (facing != CameraCharacteristics.LENS_FACING_BACK) {
+                return null
+            }
+            val focalLengths =
+                    characteristics.get(CameraCharacteristics.LENS_INFO_AVAILABLE_FOCAL_LENGTHS)
+                            ?: return null
+            val physicalSize =
+                    characteristics.get(CameraCharacteristics.SENSOR_INFO_PHYSICAL_SIZE)
+                            ?: return null
+            val minFocalLength = focalLengths.minOrNull() ?: return null
+            val horizontalFov =
+                    2.0 * atan((physicalSize.width / (2.0f * minFocalLength)).toDouble())
+            CameraProfile(cameraId, minFocalLength, horizontalFov)
+        } catch (error: Exception) {
+            Log.w(TAG, "backCameraProfile failed for cameraId=$cameraId", error)
+            null
+        }
+    }
+
+    private fun selectorForCurrentLensMode(): CameraSelector {
+        val cameraId =
+                if (currentLensMode == LensMode.ULTRA_WIDE) {
+                    ultraWideCameraId
+                } else {
+                    mainCameraId
+                }
+        return if (cameraId != null) {
+            selectorForCameraId(cameraId)
+        } else {
+            CameraSelector.DEFAULT_BACK_CAMERA
+        }
+    }
+
+    private fun selectorForCameraId(cameraId: String): CameraSelector {
+        return CameraSelector.Builder()
+                .addCameraFilter { cameraInfos ->
+                    cameraInfos.filter { Camera2CameraInfo.from(it).cameraId == cameraId }
+                }
+                .build()
+    }
+
+    private fun bindUseCases(
+            provider: ProcessCameraProvider,
+            lifecycleOwner: LifecycleOwner,
+            selector: CameraSelector,
+    ) {
+        val boundPreview = preview ?: throw IllegalStateException("Preview is not ready")
+        val boundVideoCapture =
+                videoCapture ?: throw IllegalStateException("Video capture is not ready")
+        provider.unbindAll()
+        camera =
+                provider.bindToLifecycle(
+                        lifecycleOwner,
+                        selector,
+                        boundPreview,
+                        boundVideoCapture,
+                )
+    }
+
+    private fun switchToUltraWide(
+            onComplete: (Boolean, Map<String, Any>, String?) -> Unit,
+    ) {
+        val ultraWideId = ultraWideCameraId
+        if (ultraWideId == null) {
+            onComplete(false, zoomCapabilitiesMap(), "Ultra-wide camera is unavailable")
+            return
+        }
+        if (currentLensMode == LensMode.ULTRA_WIDE) {
+            currentZoomRatio = ultraWideZoomRatio
+            onComplete(true, zoomCapabilitiesMap(), null)
+            return
+        }
+        if (activeRecording != null) {
+            onComplete(false, zoomCapabilitiesMap(), "Cannot switch physical camera while recording")
+            return
+        }
+        val provider = cameraProvider
+        val lifecycleOwner = boundLifecycleOwner
+        if (provider == null || lifecycleOwner == null) {
+            onComplete(false, zoomCapabilitiesMap(), "Camera is not ready")
+            return
+        }
+        try {
+            currentLensMode = LensMode.ULTRA_WIDE
+            currentZoomRatio = ultraWideZoomRatio
+            bindUseCases(provider, lifecycleOwner, selectorForCameraId(ultraWideId))
+            applyCurrentZoom()
+            onComplete(true, zoomCapabilitiesMap(), null)
+        } catch (error: Exception) {
+            Log.e(TAG, "switchToUltraWide failed", error)
+            currentLensMode = LensMode.MAIN
+            currentZoomRatio = 1f
+            try {
+                bindUseCases(provider, lifecycleOwner, selectorForCurrentLensMode())
+                applyCurrentZoom()
+            } catch (restoreError: Exception) {
+                Log.e(TAG, "restore main camera after ultra-wide failure failed", restoreError)
+            }
+            onComplete(false, zoomCapabilitiesMap(), error.message)
+        }
+    }
+
+    private fun switchToMainAndZoom(
+            ratio: Double,
+            onComplete: (Boolean, Map<String, Any>, String?) -> Unit,
+    ) {
+        if (activeRecording != null) {
+            onComplete(false, zoomCapabilitiesMap(), "Cannot switch physical camera while recording")
+            return
+        }
+        val provider = cameraProvider
+        val lifecycleOwner = boundLifecycleOwner
+        if (provider == null || lifecycleOwner == null) {
+            onComplete(false, zoomCapabilitiesMap(), "Camera is not ready")
+            return
+        }
+        try {
+            currentLensMode = LensMode.MAIN
+            currentZoomRatio = ratio.toFloat().coerceAtLeast(1f)
+            bindUseCases(provider, lifecycleOwner, selectorForCurrentLensMode())
+            setZoomRatio(ratio, onComplete)
+        } catch (error: Exception) {
+            Log.e(TAG, "switchToMainAndZoom failed", error)
+            onComplete(false, zoomCapabilitiesMap(), error.message)
+        }
+    }
+
+    private fun hasUltraWideCamera(): Boolean {
+        return ultraWideCameraId != null
+    }
+
+    private fun ProcessCameraProvider.hasCameraSafely(selector: CameraSelector): Boolean {
+        return try {
+            hasCamera(selector)
+        } catch (error: Exception) {
+            false
+        }
+    }
+
+    private enum class LensMode {
+        MAIN,
+        ULTRA_WIDE,
+    }
+
+    private data class CameraProfile(
+            val cameraId: String,
+            val minFocalLength: Float,
+            val horizontalFov: Double,
+    )
+
+    private data class UltraWideCamera(
+            val cameraId: String,
+            val zoomRatio: Float,
+    )
+
+    companion object {
+        private const val TAG = "RecordingCamera"
+        private const val DEFAULT_ULTRA_WIDE_ZOOM_RATIO = 0.6f
+        // 适度放宽判定宽容度，覆盖更多机型(更小的 FOV/焦距差异也视为超广角)。
+        private const val ULTRA_WIDE_FOV_FACTOR = 1.04
+        private const val ULTRA_WIDE_FOCAL_FACTOR = 0.96
+    }
+}

android/app/src/main/kotlin/com/dronex/rec/recording/RecordingForegroundService.kt

@@ -1,4 +1,4 @@
-package com.qxy.dronex.recording
+package com.dronex.rec.recording
 
 import android.app.Notification
 import android.app.NotificationChannel
@@ -14,8 +14,8 @@ import android.os.PowerManager
 import androidx.core.app.NotificationCompat
 import androidx.core.content.ContextCompat
 import androidx.lifecycle.LifecycleService
-import com.qxy.dronex.AppConstants
+import com.dronex.rec.AppConstants
-import com.qxy.dronex.MainActivity
+import com.dronex.rec.MainActivity
 
 class RecordingForegroundService : LifecycleService() {
     private var wakeLock: PowerManager.WakeLock? = null

android/app/src/main/kotlin/com/dronex/rec/recording/RecordingOutputFactory.kt

@@ -1,4 +1,4 @@
-package com.qxy.dronex.recording
+package com.dronex.rec.recording
 
 import android.content.ContentValues
 import android.content.Context

android/app/src/main/kotlin/com/dronex/rec/recording/RecordingPlatformHandler.kt

@@ -1,12 +1,12 @@
-package com.qxy.dronex.recording
+package com.dronex.rec.recording
 
 import android.os.Handler
 import android.os.Looper
 import androidx.core.view.WindowCompat
 import androidx.core.view.WindowInsetsCompat
 import androidx.core.view.WindowInsetsControllerCompat
-import com.qxy.dronex.AppConstants
+import com.dronex.rec.AppConstants
-import com.qxy.dronex.MainActivity
+import com.dronex.rec.MainActivity
 import io.flutter.plugin.common.BinaryMessenger
 import io.flutter.plugin.common.EventChannel
 import io.flutter.plugin.common.MethodCall
@@ -50,6 +50,11 @@ class RecordingPlatformHandler(
                 startRecording(withAudio, enableDnd, displayName, result)
             }
             "stopRecording" -> stopRecording(result)
+            "getZoomCapabilities" -> result.success(controller.zoomCapabilitiesMap())
+            "setZoomRatio" -> {
+                val ratio = call.argument<Double>("zoomRatio") ?: 1.0
+                setZoomRatio(ratio, result)
+            }
             "disposePreview" -> {
                 controller.unbind()
                 result.success(null)
@@ -161,21 +166,42 @@ class RecordingPlatformHandler(
         controller.stopRecording { path ->
             RecordingSession.stopForeground(activity)
             DoNotDisturbHelper.disable(activity)
+            val previewView = activity.recordingPreviewView
+            if (previewView == null) {
+                mainHandler.post { deliverStopResult(result, path) }
+                return@stopRecording
+            }
+            controller.rebindForRecording(activity, previewView) { _ ->
+                mainHandler.post { deliverStopResult(result, path) }
+            }
+        }
+    }
+
+    private fun setZoomRatio(ratio: Double, result: MethodChannel.Result) {
+        controller.setZoomRatio(ratio) { success, capabilities, message ->
             mainHandler.post {
-                val gallerySaved = path != null && controller.status.state != RecordingState.ERROR
+                if (success) {
+                    result.success(capabilities)
+                } else {
+                    result.error("ZOOM_FAILED", message ?: "Failed to set camera zoom", null)
+                }
+            }
+        }
+    }
+
+    private fun deliverStopResult(result: MethodChannel.Result, path: String?) {
+        val fileSaved = path != null && controller.status.state != RecordingState.ERROR
         val payload =
                 mutableMapOf<String, Any?>(
                         "outputPath" to path,
                         "status" to controller.status.toMap(),
-                                "gallerySaved" to gallerySaved,
+                        "fileSaved" to fileSaved,
                 )
-                if (!gallerySaved) {
+        if (!fileSaved) {
-                    payload["galleryErrorMessage"] = controller.status.message ?: "保存到相册失败"
+            payload["fileErrorMessage"] = controller.status.message ?: "保存到文件夹失败"
         }
         result.success(payload)
     }
-        }
-    }
 
     private fun setImmersiveMode(enabled: Boolean) {
         val window = activity.window

android/app/src/main/kotlin/com/dronex/rec/recording/RecordingPreviewFactory.kt

@@ -1,9 +1,9 @@
-package com.qxy.dronex.recording
+package com.dronex.rec.recording
 
 import android.content.Context
 import android.view.View
 import androidx.camera.view.PreviewView
-import com.qxy.dronex.MainActivity
+import com.dronex.rec.MainActivity
 import io.flutter.plugin.common.StandardMessageCodec
 import io.flutter.plugin.platform.PlatformView
 import io.flutter.plugin.platform.PlatformViewFactory

android/app/src/main/kotlin/com/dronex/rec/recording/RecordingSession.kt

@@ -1,4 +1,4 @@
-package com.qxy.dronex.recording
+package com.dronex.rec.recording
 
 import android.content.Context
 import androidx.lifecycle.LifecycleService

android/app/src/main/kotlin/com/dronex/rec/recording/RecordingState.kt

@@ -1,4 +1,4 @@
-package com.qxy.dronex.recording
+package com.dronex.rec.recording
 
 enum class RecordingState {
     IDLE,

android/app/src/main/kotlin/com/qxy/dronex/recording/RecordingCameraController.kt

@@ -1,239 +0,0 @@
-package com.qxy.dronex.recording
-
-import android.content.Context
-import android.util.Log
-import androidx.camera.core.CameraSelector
-import androidx.camera.core.Preview
-import androidx.camera.lifecycle.ProcessCameraProvider
-import androidx.camera.video.Quality
-import androidx.camera.video.QualitySelector
-import androidx.camera.video.Recorder
-import androidx.camera.video.Recording
-import androidx.camera.video.VideoCapture
-import androidx.camera.video.VideoRecordEvent
-import androidx.camera.view.PreviewView
-import androidx.core.content.ContextCompat
-import androidx.lifecycle.LifecycleOwner
-import java.util.concurrent.Executor
-
-class RecordingCameraController(
-        private val appContext: Context,
-) {
-    private val mainExecutor: Executor = ContextCompat.getMainExecutor(appContext)
-
-    private var cameraProvider: ProcessCameraProvider? = null
-    private var preview: Preview? = null
-    private var videoCapture: VideoCapture<Recorder>? = null
-    private var activeRecording: Recording? = null
-    private var boundLifecycleOwner: LifecycleOwner? = null
-
-    var status: RecordingStatus = RecordingStatus(RecordingState.IDLE)
-        private set
-
-    var statusListener: ((RecordingStatus) -> Unit)? = null
-
-    private var recordingStartedAt: Long = 0L
-    private var latestOutputPath: String? = null
-    private var pendingStopCallback: ((String?) -> Unit)? = null
-
-    fun bindPreview(
-            lifecycleOwner: LifecycleOwner,
-            previewView: PreviewView,
-            onReady: (Boolean) -> Unit,
-    ) {
-        val future = ProcessCameraProvider.getInstance(appContext)
-        future.addListener(
-                {
-                    try {
-                        val provider = future.get()
-                        cameraProvider = provider
-                        boundLifecycleOwner = lifecycleOwner
-
-                        preview =
-                                Preview.Builder().build().also {
-                                    it.surfaceProvider = previewView.surfaceProvider
-                                }
-
-                        val recorder =
-                                Recorder.Builder()
-                                        .setQualitySelector(QualitySelector.from(Quality.HD))
-                                        .build()
-                        videoCapture = VideoCapture.withOutput(recorder)
-
-                        provider.unbindAll()
-                        provider.bindToLifecycle(
-                                lifecycleOwner,
-                                CameraSelector.DEFAULT_BACK_CAMERA,
-                                preview,
-                                videoCapture,
-                        )
-
-                        updateStatus(RecordingStatus(RecordingState.PREVIEWING))
-                        onReady(true)
-                    } catch (error: Exception) {
-                        Log.e(TAG, "bindPreview failed", error)
-                        updateStatus(
-                                RecordingStatus(
-                                        RecordingState.ERROR,
-                                        message = error.message,
-                                ),
-                        )
-                        onReady(false)
-                    }
-                },
-                mainExecutor,
-        )
-    }
-
-    fun rebindForRecording(
-            lifecycleOwner: LifecycleOwner,
-            previewView: PreviewView,
-            onReady: (Boolean) -> Unit,
-    ) {
-        val provider = cameraProvider
-        if (provider == null) {
-            bindPreview(lifecycleOwner, previewView, onReady)
-            return
-        }
-
-        try {
-            boundLifecycleOwner = lifecycleOwner
-            provider.unbindAll()
-            provider.bindToLifecycle(
-                    lifecycleOwner,
-                    CameraSelector.DEFAULT_BACK_CAMERA,
-                    preview,
-                    videoCapture,
-            )
-            onReady(true)
-        } catch (error: Exception) {
-            Log.e(TAG, "rebindForRecording failed", error)
-            onReady(false)
-        }
-    }
-
-    fun startRecording(
-            withAudio: Boolean,
-            displayName: String?,
-            onStarted: (Boolean, String?) -> Unit,
-    ) {
-        val capture = videoCapture
-        if (capture == null || boundLifecycleOwner == null) {
-            onStarted(false, "Camera not ready")
-            return
-        }
-
-        if (activeRecording != null) {
-            onStarted(false, "Already recording")
-            return
-        }
-
-        val outputOptions =
-                RecordingOutputFactory.buildMediaStoreOutputOptions(
-                        appContext,
-                        displayName,
-                )
-        latestOutputPath = null
-
-        val pending =
-                capture.output.prepareRecording(appContext, outputOptions).apply {
-                    if (withAudio) {
-                        val granted =
-                                ContextCompat.checkSelfPermission(
-                                        appContext,
-                                        android.Manifest.permission.RECORD_AUDIO,
-                                ) == android.content.pm.PackageManager.PERMISSION_GRANTED
-                        if (granted) {
-                            withAudioEnabled()
-                        }
-                    }
-                }
-
-        recordingStartedAt = System.currentTimeMillis()
-        updateStatus(
-                RecordingStatus(
-                        RecordingState.RECORDING,
-                        outputPath = latestOutputPath,
-                ),
-        )
-
-        activeRecording =
-                pending.start(mainExecutor) { event ->
-                    when (event) {
-                        is VideoRecordEvent.Start -> Unit
-                        is VideoRecordEvent.Finalize -> {
-                            activeRecording = null
-                            if (event.hasError()) {
-                                updateStatus(
-                                        RecordingStatus(
-                                                RecordingState.ERROR,
-                                                message = event.cause?.message
-                                                                ?: "Recording failed",
-                                        ),
-                                )
-                            } else {
-                                latestOutputPath = event.outputResults.outputUri.toString()
-                                updateStatus(
-                                        RecordingStatus(
-                                                RecordingState.PREVIEWING,
-                                                outputPath = latestOutputPath,
-                                                elapsedMillis =
-                                                        System.currentTimeMillis() -
-                                                                recordingStartedAt,
-                                        ),
-                                )
-                            }
-                            val stopCallback = pendingStopCallback
-                            pendingStopCallback = null
-                            stopCallback?.invoke(latestOutputPath)
-                        }
-                    }
-                }
-
-        onStarted(true, latestOutputPath ?: "recording")
-    }
-
-    fun stopRecording(onStopped: (String?) -> Unit) {
-        val recording = activeRecording
-        if (recording == null) {
-            onStopped(latestOutputPath)
-            return
-        }
-
-        pendingStopCallback = onStopped
-        updateStatus(
-                RecordingStatus(
-                        RecordingState.STOPPING,
-                        outputPath = latestOutputPath,
-                ),
-        )
-
-        recording.stop()
-        activeRecording = null
-    }
-
-    fun unbind() {
-        activeRecording?.stop()
-        activeRecording = null
-        cameraProvider?.unbindAll()
-        cameraProvider = null
-        preview = null
-        videoCapture = null
-        boundLifecycleOwner = null
-        updateStatus(RecordingStatus(RecordingState.IDLE))
-    }
-
-    fun elapsedMillis(): Long {
-        if (status.state != RecordingState.RECORDING) return 0L
-        return System.currentTimeMillis() - recordingStartedAt
-    }
-
-    private fun updateStatus(next: RecordingStatus) {
-        status = next
-        statusListener?.invoke(next)
-    }
-
-    companion object {
-        private const val TAG = "RecordingCamera"
-    }
-}

android/app/src/main/res/drawable-v21/launch_background.xml

@@ -1,12 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- Modify this file to customize your launch splash screen -->
 <layer-list xmlns:android="http://schemas.android.com/apk/res/android">
-    <item android:drawable="?android:colorBackground" />
+    <item>
-
-    <!-- You can insert your own image assets here -->
-    <!-- <item>
         <bitmap
-            android:gravity="center"
+            android:gravity="fill"
-            android:src="@mipmap/launch_image" />
+            android:src="@drawable/startup_background" />
-    </item> -->
+    </item>
 </layer-list>

android/app/src/main/res/drawable/launch_background.xml

@@ -1,12 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- Modify this file to customize your launch splash screen -->
 <layer-list xmlns:android="http://schemas.android.com/apk/res/android">
-    <item android:drawable="@android:color/white" />
+    <item>
-
-    <!-- You can insert your own image assets here -->
-    <!-- <item>
         <bitmap
-            android:gravity="center"
+            android:gravity="fill"
-            android:src="@mipmap/launch_image" />
+            android:src="@drawable/startup_background" />
-    </item> -->
+    </item>
 </layer-list>

android/app/src/profile/AndroidManifest.xml

@@ -1,7 +0,0 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
-    <!-- The INTERNET permission is required for development. Specifically,
-         the Flutter tool needs it to communicate with the running application
-         to allow setting breakpoints, to provide hot reload, etc.
-    -->
-    <uses-permission android:name="android.permission.INTERNET"/>
-</manifest>

build-apk-split.sh

@@ -0,0 +1 @@
+flutter build apk --release --split-per-abi

build-apk.sh

@@ -0,0 +1 @@
+flutter build apk --release

buildServer.json

@@ -0,0 +1,19 @@
+{
+	"name": "xcode build server",
+	"version": "1.3.0",
+	"bspVersion": "2.2.0",
+	"languages": [
+		"c",
+		"cpp",
+		"objective-c",
+		"objective-cpp",
+		"swift"
+	],
+	"argv": [
+		"/opt/homebrew/bin/xcode-build-server"
+	],
+	"workspace": "/Users/ZhuanZ/Documents/gdfw/record-tool/ios/Runner.xcworkspace",
+	"build_root": "/Users/ZhuanZ/Library/Developer/Xcode/DerivedData/Runner-ckjfuyjdkgumnpbnnftroxddsppq",
+	"scheme": "Runner",
+	"kind": "xcode"
+}

clean.sh

@@ -0,0 +1,7 @@
+flutter clean  
+flutter pub get
+rm -rf ios/Pods
+rm -rf ios/Podfile.lock
+cd ios
+pod install
+cd ..

devtools_options.yaml

@@ -0,0 +1,3 @@
+description: This file stores settings for Dart & Flutter DevTools.
+documentation: https://docs.flutter.dev/tools/devtools/extensions#configure-extension-enablement-states
+extensions:

ios/Flutter/Debug.xcconfig

@@ -1,2 +1,3 @@
 #include? "Pods/Target Support Files/Pods-Runner/Pods-Runner.debug.xcconfig"
 #include "Generated.xcconfig"
+FRAMEWORK_SEARCH_PATHS = $(inherited) "${PODS_CONFIGURATION_BUILD_DIR}"

ios/Flutter/Release.xcconfig

@@ -1,2 +1,3 @@
 #include? "Pods/Target Support Files/Pods-Runner/Pods-Runner.release.xcconfig"
 #include "Generated.xcconfig"
+FRAMEWORK_SEARCH_PATHS = $(inherited) "${PODS_CONFIGURATION_BUILD_DIR}"

ios/Podfile

@@ -45,9 +45,34 @@ post_install do |installer|
         '$(inherited)',
         'PERMISSION_CAMERA=1',
         'PERMISSION_MICROPHONE=1',
-        'PERMISSION_PHOTOS=1',
-        'PERMISSION_PHOTOS_ADD_ONLY=1',
       ]
     end
   end
+
+  pods_runner_dir = File.join(
+    installer.sandbox.root,
+    'Target Support Files',
+    'Pods-Runner'
+  )
+  Dir.glob(File.join(pods_runner_dir, 'Pods-Runner.*.xcconfig')).each do |config_path|
+    config = File.read(config_path)
+    config.gsub!(
+      'FRAMEWORK_SEARCH_PATHS = $(inherited)',
+      'FRAMEWORK_SEARCH_PATHS = $(inherited) "${PODS_CONFIGURATION_BUILD_DIR}"'
+    )
+    File.write(config_path, config)
+  end
+
+  Dir.glob(File.join(pods_runner_dir, 'Pods-Runner-frameworks-*input-files.xcfilelist')).each do |file_list_path|
+    file_list = File.read(file_list_path)
+    file_list.gsub!('${BUILT_PRODUCTS_DIR}/', '${PODS_CONFIGURATION_BUILD_DIR}/')
+    File.write(file_list_path, file_list)
+  end
+
+  frameworks_script = File.join(pods_runner_dir, 'Pods-Runner-frameworks.sh')
+  if File.exist?(frameworks_script)
+    script = File.read(frameworks_script)
+    script.gsub!('${BUILT_PRODUCTS_DIR}/', '${PODS_CONFIGURATION_BUILD_DIR}/')
+    File.write(frameworks_script, script)
+  end
 end

ios/Podfile.lock

@@ -1,16 +1,48 @@
 PODS:
+  - connectivity_plus (0.0.1):
+    - Flutter
   - Flutter (1.0.0)
+  - permission_handler_apple (9.4.8):
+    - Flutter
+  - shared_preferences_foundation (0.0.1):
+    - Flutter
+    - FlutterMacOS
+  - sqflite_darwin (0.0.4):
+    - Flutter
+    - FlutterMacOS
+  - url_launcher_ios (0.0.1):
+    - Flutter
 
 DEPENDENCIES:
+  - connectivity_plus (from `.symlinks/plugins/connectivity_plus/ios`)
   - Flutter (from `Flutter`)
+  - permission_handler_apple (from `.symlinks/plugins/permission_handler_apple/ios`)
+  - shared_preferences_foundation (from `.symlinks/plugins/shared_preferences_foundation/darwin`)
+  - sqflite_darwin (from `.symlinks/plugins/sqflite_darwin/darwin`)
+  - url_launcher_ios (from `.symlinks/plugins/url_launcher_ios/ios`)
 
 EXTERNAL SOURCES:
+  connectivity_plus:
+    :path: ".symlinks/plugins/connectivity_plus/ios"
   Flutter:
     :path: Flutter
+  permission_handler_apple:
+    :path: ".symlinks/plugins/permission_handler_apple/ios"
+  shared_preferences_foundation:
+    :path: ".symlinks/plugins/shared_preferences_foundation/darwin"
+  sqflite_darwin:
+    :path: ".symlinks/plugins/sqflite_darwin/darwin"
+  url_launcher_ios:
+    :path: ".symlinks/plugins/url_launcher_ios/ios"
 
 SPEC CHECKSUMS:
+  connectivity_plus: cb623214f4e1f6ef8fe7403d580fdad517d2f7dd
   Flutter: cabc95a1d2626b1b06e7179b784ebcf0c0cde467
+  permission_handler_apple: 92d754bbaa7361d436db2d6c3c1c2a0fdcec462e
+  shared_preferences_foundation: 7036424c3d8ec98dfe75ff1667cb0cd531ec82bb
+  sqflite_darwin: 20b2a3a3b70e43edae938624ce550a3cbf66a3d0
+  url_launcher_ios: 7a95fa5b60cc718a708b8f2966718e93db0cef1b
 
-PODFILE CHECKSUM: 5a82b772179df87e6518bddc6f9bb8b4053ce48b
+PODFILE CHECKSUM: 858401fbd980bedce6ecd2f9b429bf271f11f74b
 
 COCOAPODS: 1.16.2

ios/Runner.xcodeproj/project.pbxproj

@@ -12,7 +12,6 @@
 		3B3967161E833CAA004F5970 /* AppFrameworkInfo.plist in Resources */ = {isa = PBXBuildFile; fileRef = 3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */; };
 		64BC3B3C75FABAA128C4FE7A /* Pods_RunnerTests.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = D84231833EC084C45F76D9A0 /* Pods_RunnerTests.framework */; };
 		74858FAF1ED2DC5600515810 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 74858FAE1ED2DC5600515810 /* AppDelegate.swift */; };
-		78A318202AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage in Frameworks */ = {isa = PBXBuildFile; productRef = 78A3181F2AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage */; };
 		87DA76CA5231F693C9392B80 /* Pods_Runner.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = B6AA1C86CE710449CC3E8FCD /* Pods_Runner.framework */; };
 		8D5D9D9E2C69000100F10001 /* RecordingPlugin.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8D5D9D9D2C69000100F10001 /* RecordingPlugin.swift */; };
 		8E5D9D9E2C69000100F10002 /* PlatformInfoPlugin.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8E5D9D9D2C69000100F10002 /* PlatformInfoPlugin.swift */; };
@@ -54,7 +53,6 @@
 		69561E7442E8CC939DB2B482 /* Pods-Runner.debug.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; name = "Pods-Runner.debug.xcconfig"; path = "Target Support Files/Pods-Runner/Pods-Runner.debug.xcconfig"; sourceTree = "<group>"; };
 		74858FAD1ED2DC5600515810 /* Runner-Bridging-Header.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = "Runner-Bridging-Header.h"; sourceTree = "<group>"; };
 		74858FAE1ED2DC5600515810 /* AppDelegate.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = "<group>"; };
-		78E0A7A72DC9AD7400C4905E /* FlutterGeneratedPluginSwiftPackage */ = {isa = PBXFileReference; lastKnownFileType = wrapper; name = FlutterGeneratedPluginSwiftPackage; path = Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage; sourceTree = "<group>"; };
 		7AFA3C8E1D35360C0083082E /* Release.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = Release.xcconfig; path = Flutter/Release.xcconfig; sourceTree = "<group>"; };
 		8D5D9D9D2C69000100F10001 /* RecordingPlugin.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RecordingPlugin.swift; sourceTree = "<group>"; };
 		8E5D9D9D2C69000100F10002 /* PlatformInfoPlugin.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PlatformInfoPlugin.swift; sourceTree = "<group>"; };
@@ -86,7 +84,6 @@
 			isa = PBXFrameworksBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
-				78A318202AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage in Frameworks */,
 				87DA76CA5231F693C9392B80 /* Pods_Runner.framework in Frameworks */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
@@ -104,7 +101,6 @@
 				DFA822DC4965C5AFAFF6BB41 /* Pods-RunnerTests.release.xcconfig */,
 				99DBE6263F70650B13C33EAC /* Pods-RunnerTests.profile.xcconfig */,
 			);
-			name = Pods;
 			path = Pods;
 			sourceTree = "<group>";
 		};
@@ -128,7 +124,6 @@
 		9740EEB11CF90186004384FC /* Flutter */ = {
 			isa = PBXGroup;
 			children = (
-				78E0A7A72DC9AD7400C4905E /* FlutterGeneratedPluginSwiftPackage */,
 				3B3967151E833CAA004F5970 /* AppFrameworkInfo.plist */,
 				9740EEB21CF90195004384FC /* Debug.xcconfig */,
 				7AFA3C8E1D35360C0083082E /* Release.xcconfig */,
@@ -208,15 +203,14 @@
 				97C146EC1CF9000F007C117D /* Resources */,
 				9705A1C41CF9048500538489 /* Embed Frameworks */,
 				3B06AD1E1E4923F5004D2608 /* Thin Binary */,
+				7858230D5ADC7A99F778CB03 /* [CP] Embed Pods Frameworks */,
+				99E9790F23C2D0C0B51A6C19 /* [CP] Copy Pods Resources */,
 			);
 			buildRules = (
 			);
 			dependencies = (
 			);
 			name = Runner;
-			packageProductDependencies = (
-				78A3181F2AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage */,
-			);
 			productName = Runner;
 			productReference = 97C146EE1CF9000F007C117D /* Runner.app */;
 			productType = "com.apple.product-type.application";
@@ -250,9 +244,6 @@
 				Base,
 			);
 			mainGroup = 97C146E51CF9000F007C117D;
-			packageReferences = (
-				781AD8BC2B33823900A9FFBB /* XCLocalSwiftPackageReference "FlutterGeneratedPluginSwiftPackage" */,
-			);
 			productRefGroup = 97C146EF1CF9000F007C117D /* Products */;
 			projectDirPath = "";
 			projectRoot = "";
@@ -345,6 +336,23 @@
 			shellScript = "diff \"${PODS_PODFILE_DIR_PATH}/Podfile.lock\" \"${PODS_ROOT}/Manifest.lock\" > /dev/null\nif [ $? != 0 ] ; then\n    # print error to STDERR\n    echo \"error: The sandbox is not in sync with the Podfile.lock. Run 'pod install' or update your CocoaPods installation.\" >&2\n    exit 1\nfi\n# This output is used by Xcode 'outputs' to avoid re-running this script phase.\necho \"SUCCESS\" > \"${SCRIPT_OUTPUT_FILE_0}\"\n";
 			showEnvVarsInLog = 0;
 		};
+		7858230D5ADC7A99F778CB03 /* [CP] Embed Pods Frameworks */ = {
+			isa = PBXShellScriptBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			inputFileListPaths = (
+				"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-frameworks-${CONFIGURATION}-input-files.xcfilelist",
+			);
+			name = "[CP] Embed Pods Frameworks";
+			outputFileListPaths = (
+				"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-frameworks-${CONFIGURATION}-output-files.xcfilelist",
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+			shellPath = /bin/sh;
+			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-frameworks.sh\"\n";
+			showEnvVarsInLog = 0;
+		};
 		9740EEB61CF901F6004384FC /* Run Script */ = {
 			isa = PBXShellScriptBuildPhase;
 			alwaysOutOfDate = 1;
@@ -360,6 +368,23 @@
 			shellPath = /bin/sh;
 			shellScript = "/bin/sh \"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh\" build";
 		};
+		99E9790F23C2D0C0B51A6C19 /* [CP] Copy Pods Resources */ = {
+			isa = PBXShellScriptBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			inputFileListPaths = (
+				"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-resources-${CONFIGURATION}-input-files.xcfilelist",
+			);
+			name = "[CP] Copy Pods Resources";
+			outputFileListPaths = (
+				"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-resources-${CONFIGURATION}-output-files.xcfilelist",
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+			shellPath = /bin/sh;
+			shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-Runner/Pods-Runner-resources.sh\"\n";
+			showEnvVarsInLog = 0;
+		};
 /* End PBXShellScriptBuildPhase section */
 
 /* Begin PBXSourcesBuildPhase section */
@@ -470,16 +495,22 @@
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CLANG_ENABLE_MODULES = YES;
+				CODE_SIGN_IDENTITY = "Apple Development";
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				CODE_SIGN_STYLE = Manual;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
-				DEVELOPMENT_TEAM = 35634V629S;
+				DEVELOPMENT_TEAM = "";
+				"DEVELOPMENT_TEAM[sdk=iphoneos*]" = MT26BPCKF6;
 				ENABLE_BITCODE = NO;
 				INFOPLIST_FILE = Runner/Info.plist;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				PRODUCT_BUNDLE_IDENTIFIER = com.qxy.dronex;
+				PRODUCT_BUNDLE_IDENTIFIER = com.dronex.rec;
 				PRODUCT_NAME = "$(TARGET_NAME)";
+				PROVISIONING_PROFILE_SPECIFIER = "";
+				"PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "dev-profile-dronex";
 				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
 				SWIFT_VERSION = 5.0;
 				VERSIONING_SYSTEM = "apple-generic";
@@ -653,16 +684,22 @@
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CLANG_ENABLE_MODULES = YES;
+				CODE_SIGN_IDENTITY = "Apple Development";
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				CODE_SIGN_STYLE = Manual;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
-				DEVELOPMENT_TEAM = 35634V629S;
+				DEVELOPMENT_TEAM = "";
+				"DEVELOPMENT_TEAM[sdk=iphoneos*]" = MT26BPCKF6;
 				ENABLE_BITCODE = NO;
 				INFOPLIST_FILE = Runner/Info.plist;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				PRODUCT_BUNDLE_IDENTIFIER = com.qxy.dronex;
+				PRODUCT_BUNDLE_IDENTIFIER = com.dronex.rec;
 				PRODUCT_NAME = "$(TARGET_NAME)";
+				PROVISIONING_PROFILE_SPECIFIER = "";
+				"PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "dev-profile-dronex";
 				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
 				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
 				SWIFT_VERSION = 5.0;
@@ -676,16 +713,22 @@
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CLANG_ENABLE_MODULES = YES;
+				CODE_SIGN_IDENTITY = "Apple Development";
+				"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
+				CODE_SIGN_STYLE = Manual;
 				CURRENT_PROJECT_VERSION = "$(FLUTTER_BUILD_NUMBER)";
-				DEVELOPMENT_TEAM = 35634V629S;
+				DEVELOPMENT_TEAM = "";
+				"DEVELOPMENT_TEAM[sdk=iphoneos*]" = MT26BPCKF6;
 				ENABLE_BITCODE = NO;
 				INFOPLIST_FILE = Runner/Info.plist;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				PRODUCT_BUNDLE_IDENTIFIER = com.qxy.dronex;
+				PRODUCT_BUNDLE_IDENTIFIER = com.dronex.rec;
 				PRODUCT_NAME = "$(TARGET_NAME)";
+				PROVISIONING_PROFILE_SPECIFIER = "";
+				"PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]" = "dev-profile-dronex";
 				SWIFT_OBJC_BRIDGING_HEADER = "Runner/Runner-Bridging-Header.h";
 				SWIFT_VERSION = 5.0;
 				VERSIONING_SYSTEM = "apple-generic";
@@ -726,20 +769,6 @@
 			defaultConfigurationName = Release;
 		};
 /* End XCConfigurationList section */
-
-/* Begin XCLocalSwiftPackageReference section */
-		781AD8BC2B33823900A9FFBB /* XCLocalSwiftPackageReference "FlutterGeneratedPluginSwiftPackage" */ = {
-			isa = XCLocalSwiftPackageReference;
-			relativePath = Flutter/ephemeral/Packages/FlutterGeneratedPluginSwiftPackage;
-		};
-/* End XCLocalSwiftPackageReference section */
-
-/* Begin XCSwiftPackageProductDependency section */
-		78A3181F2AECB46A00862997 /* FlutterGeneratedPluginSwiftPackage */ = {
-			isa = XCSwiftPackageProductDependency;
-			productName = FlutterGeneratedPluginSwiftPackage;
-		};
-/* End XCSwiftPackageProductDependency section */
 	};
 	rootObject = 97C146E61CF9000F007C117D /* Project object */;
 }

ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
    LastUpgradeVersion = "1510"
-   version = "1.3">
+   version = "1.7">
    <BuildAction
       parallelizeBuildables = "YES"
       buildImplicitDependencies = "YES">
@@ -70,7 +70,7 @@
       </Testables>
    </TestAction>
    <LaunchAction
-      buildConfiguration = "Debug"
+      buildConfiguration = "Release"
       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
       customLLDBInitFile = "$(SRCROOT)/Flutter/ephemeral/flutter_lldbinit"

ios/Runner/Assets.xcassets/StartupBackground.imageset/Contents.json

@@ -0,0 +1,13 @@
+{
+  "images" : [
+    {
+      "filename" : "startup_background.png",
+      "idiom" : "universal",
+      "scale" : "1x"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

ios/Runner/Base.lproj/LaunchScreen.storyboard

@@ -16,13 +16,15 @@
                     <view key="view" contentMode="scaleToFill" id="Ze5-6b-2t3">
                         <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
                         <subviews>
-                            <imageView opaque="NO" clipsSubviews="YES" multipleTouchEnabled="YES" contentMode="center" image="LaunchImage" translatesAutoresizingMaskIntoConstraints="NO" id="YRO-k0-Ey4">
+                            <imageView opaque="NO" clipsSubviews="YES" multipleTouchEnabled="YES" contentMode="scaleToFill" image="StartupBackground" translatesAutoresizingMaskIntoConstraints="NO" id="YRO-k0-Ey4">
                             </imageView>
                         </subviews>
                         <color key="backgroundColor" red="1" green="1" blue="1" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
                         <constraints>
-                            <constraint firstItem="YRO-k0-Ey4" firstAttribute="centerX" secondItem="Ze5-6b-2t3" secondAttribute="centerX" id="1a2-6s-vTC"/>
+                            <constraint firstItem="YRO-k0-Ey4" firstAttribute="top" secondItem="Ze5-6b-2t3" secondAttribute="top" id="1a2-6s-vTC"/>
-                            <constraint firstItem="YRO-k0-Ey4" firstAttribute="centerY" secondItem="Ze5-6b-2t3" secondAttribute="centerY" id="4X2-HB-R7a"/>
+                            <constraint firstItem="YRO-k0-Ey4" firstAttribute="bottom" secondItem="Ze5-6b-2t3" secondAttribute="bottom" id="4X2-HB-R7a"/>
+                            <constraint firstItem="YRO-k0-Ey4" firstAttribute="leading" secondItem="Ze5-6b-2t3" secondAttribute="leading" id="E8f-e3-JEx"/>
+                            <constraint firstItem="YRO-k0-Ey4" firstAttribute="trailing" secondItem="Ze5-6b-2t3" secondAttribute="trailing" id="rwG-Bh-0uU"/>
                         </constraints>
                     </view>
                 </viewController>
@@ -32,6 +34,6 @@
         </scene>
     </scenes>
     <resources>
-        <image name="LaunchImage" width="168" height="185"/>
+        <image name="StartupBackground" width="750" height="1624"/>
     </resources>
 </document>

ios/Runner/Base.lproj/Main.storyboard

@@ -1,8 +1,10 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<?xml version="1.0" encoding="UTF-8"?>
-<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="10117" systemVersion="15F34" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" initialViewController="BYZ-38-t0r">
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="24412" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" colorMatched="YES" initialViewController="BYZ-38-t0r">
+    <device id="retina6_12" orientation="portrait" appearance="light"/>
     <dependencies>
         <deployment identifier="iOS"/>
-        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="10085"/>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="24405"/>
+        <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
     </dependencies>
     <scenes>
         <!--Flutter View Controller-->
@@ -14,13 +16,28 @@
                         <viewControllerLayoutGuide type="bottom" id="wfy-db-euE"/>
                     </layoutGuides>
                     <view key="view" contentMode="scaleToFill" id="8bC-Xf-vdC">
-                        <rect key="frame" x="0.0" y="0.0" width="600" height="600"/>
+                        <rect key="frame" x="0.0" y="0.0" width="393" height="852"/>
                         <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
-                        <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="calibratedWhite"/>
+                        <subviews>
+                            <imageView opaque="NO" clipsSubviews="YES" multipleTouchEnabled="YES" contentMode="scaleToFill" image="StartupBackground" translatesAutoresizingMaskIntoConstraints="NO" id="YQm-Ov-qw7">
+                                <rect key="frame" x="0.0" y="0.0" width="393" height="852"/>
+                            </imageView>
+                        </subviews>
+                        <color key="backgroundColor" red="1" green="1" blue="1" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
+                        <constraints>
+                            <constraint firstItem="YQm-Ov-qw7" firstAttribute="top" secondItem="8bC-Xf-vdC" secondAttribute="top" id="7pp-OK-Dgk"/>
+                            <constraint firstItem="YQm-Ov-qw7" firstAttribute="bottom" secondItem="8bC-Xf-vdC" secondAttribute="bottom" id="Hbf-gY-rbf"/>
+                            <constraint firstItem="YQm-Ov-qw7" firstAttribute="leading" secondItem="8bC-Xf-vdC" secondAttribute="leading" id="WPc-7k-20p"/>
+                            <constraint firstItem="YQm-Ov-qw7" firstAttribute="trailing" secondItem="8bC-Xf-vdC" secondAttribute="trailing" id="w1G-WA-3QR"/>
+                        </constraints>
                     </view>
                 </viewController>
                 <placeholder placeholderIdentifier="IBFirstResponder" id="dkx-z0-nzr" sceneMemberID="firstResponder"/>
             </objects>
+            <point key="canvasLocation" x="139" y="122"/>
         </scene>
     </scenes>
+    <resources>
+        <image name="StartupBackground" width="750" height="1624"/>
+    </resources>
 </document>

ios/Runner/Info.plist

@@ -30,8 +30,10 @@
 	<string>需要访问相机以显示预览并录制视频。</string>
 	<key>NSMicrophoneUsageDescription</key>
 	<string>需要访问麦克风以录制视频声音；未授权时将静音录制。</string>
-	<key>NSPhotoLibraryAddUsageDescription</key>
+	<key>UIFileSharingEnabled</key>
-	<string>需要将录制的视频保存到相册。</string>
+	<true/>
+	<key>LSSupportsOpeningDocumentsInPlace</key>
+	<true/>
 	<key>UIApplicationSceneManifest</key>
 	<dict>
 		<key>UIApplicationSupportsMultipleScenes</key>

ios/Runner/PlatformInfoPlugin.swift

@@ -4,7 +4,7 @@ import UIKit
 final class PlatformInfoPlugin: NSObject, FlutterPlugin {
   static func register(with registrar: FlutterPluginRegistrar) {
     let channel = FlutterMethodChannel(
-      name: "com.qxy.dronex/platform_info",
+      name: "com.dronex.rec/platform_info",
       binaryMessenger: registrar.messenger()
     )
     let plugin = PlatformInfoPlugin()

ios/Runner/RecordingPlugin.swift

@@ -1,6 +1,5 @@
 import AVFoundation
 import Flutter
-import Photos
 import UIKit
 
 private enum RecordingState: String {
@@ -110,12 +109,13 @@ private final class RecordingCameraController: NSObject, AVCaptureFileOutputReco
   private var audioInput: AVCaptureDeviceInput?
   private var configured = false
   private var latestOutputPath: String?
-  private var latestGallerySaved = true
+  private var latestFileSaved = true
-  private var latestGalleryErrorMessage: String?
+  private var latestFileErrorMessage: String?
   private var pendingDisplayName: String?
   private var recordingStartedAt: Date?
   private var elapsedTimer: Timer?
   private var pendingStopResult: FlutterResult?
+  private var currentZoomRatio: CGFloat = 1.0
 
   private(set) var status = RecordingStatus(state: .idle) {
     didSet {
@@ -129,16 +129,32 @@ private final class RecordingCameraController: NSObject, AVCaptureFileOutputReco
   var statusListener: (([String: Any]) -> Void)?
 
   func attach(previewView: RecordingPreviewView) {
+    let bindPreview = { [weak self, weak previewView] in
+      guard let self, let previewView else { return }
       self.previewView = previewView
-    previewView.previewLayer.session = session
+      previewView.previewLayer.session = self.session
+    }
+    if Thread.isMainThread {
+      bindPreview()
+    } else {
+      DispatchQueue.main.async(execute: bindPreview)
+    }
   }
 
   func detach(previewView: RecordingPreviewView) {
+    let unbindPreview = { [weak self, weak previewView] in
+      guard let self, let previewView else { return }
       if self.previewView === previewView {
-      self.previewView?.previewLayer.session = nil
+        previewView.previewLayer.session = nil
         self.previewView = nil
       }
     }
+    if Thread.isMainThread {
+      unbindPreview()
+    } else {
+      DispatchQueue.main.async(execute: unbindPreview)
+    }
+  }
 
   func initializePreview(result: @escaping FlutterResult) {
     guard let previewView else {
@@ -199,10 +215,10 @@ private final class RecordingCameraController: NSObject, AVCaptureFileOutputReco
         }
 
         self.pendingDisplayName = displayName
-        self.latestGallerySaved = true
+        self.latestFileSaved = true
-        self.latestGalleryErrorMessage = nil
+        self.latestFileErrorMessage = nil
         let outputURL = try self.createOutputURL(displayName: displayName)
-        self.latestOutputPath = outputURL.lastPathComponent
+        self.latestOutputPath = outputURL.path
         self.recordingStartedAt = Date()
         self.updateStatus(RecordingStatus(state: .recording, outputPath: outputURL.path))
         self.movieOutput.startRecording(to: outputURL, recordingDelegate: self)
@@ -238,11 +254,11 @@ private final class RecordingCameraController: NSObject, AVCaptureFileOutputReco
           var payload: [String: Any] = [
             "outputPath": self.latestOutputPath as Any,
             "status": self.currentStatusMap(),
-            "gallerySaved": self.latestGallerySaved,
+            "fileSaved": self.latestFileSaved,
           ]
-          if !self.latestGallerySaved {
+          if !self.latestFileSaved {
-            payload["galleryErrorMessage"] =
+            payload["fileErrorMessage"] =
-              self.latestGalleryErrorMessage ?? "保存到相册失败"
+              self.latestFileErrorMessage ?? "保存到文件夹失败"
           }
           result(payload)
         }
@@ -275,6 +291,7 @@ private final class RecordingCameraController: NSObject, AVCaptureFileOutputReco
       self.session.commitConfiguration()
       self.videoInput = nil
       self.audioInput = nil
+      self.currentZoomRatio = 1.0
       self.configured = false
       self.updateStatus(RecordingStatus(state: .idle))
 
@@ -296,6 +313,54 @@ private final class RecordingCameraController: NSObject, AVCaptureFileOutputReco
     return status.toMap()
   }
 
+  func zoomCapabilities(result: @escaping FlutterResult) {
+    sessionQueue.async { [weak self] in
+      guard let self else { return }
+      let capabilities = self.currentZoomCapabilitiesMap()
+      DispatchQueue.main.async {
+        result(capabilities)
+      }
+    }
+  }
+
+  func setZoomRatio(_ ratio: CGFloat, result: @escaping FlutterResult) {
+    sessionQueue.async { [weak self] in
+      guard let self else { return }
+      guard let device = self.videoInput?.device else {
+        self.currentZoomRatio = max(1.0, ratio)
+        let capabilities = self.currentZoomCapabilitiesMap()
+        DispatchQueue.main.async {
+          result(capabilities)
+        }
+        return
+      }
+
+      do {
+        // 入参是显示倍率(1.0x = 主摄)，按 S 基准换算回设备 zoomFactor。
+        let baseline = self.mainBaselineFactor(for: device)
+        let nextZoom = self.clampedZoomRatio(ratio * baseline, for: device)
+        try device.lockForConfiguration()
+        device.videoZoomFactor = nextZoom
+        device.unlockForConfiguration()
+        self.currentZoomRatio = nextZoom
+        let capabilities = self.currentZoomCapabilitiesMap()
+        DispatchQueue.main.async {
+          result(capabilities)
+        }
+      } catch {
+        DispatchQueue.main.async {
+          result(
+            FlutterError(
+              code: "ZOOM_FAILED",
+              message: error.localizedDescription,
+              details: nil
+            )
+          )
+        }
+      }
+    }
+  }
+
   func fileOutput(
     _ output: AVCaptureFileOutput,
     didFinishRecordingTo outputFileURL: URL,
@@ -306,8 +371,8 @@ private final class RecordingCameraController: NSObject, AVCaptureFileOutputReco
     pendingStopResult = nil
 
     if let error {
-      latestGallerySaved = false
+      latestFileSaved = false
-      latestGalleryErrorMessage = error.localizedDescription
+      latestFileErrorMessage = error.localizedDescription
       updateStatus(
         RecordingStatus(
           state: .error, outputPath: latestOutputPath, message: error.localizedDescription))
@@ -315,29 +380,30 @@ private final class RecordingCameraController: NSObject, AVCaptureFileOutputReco
       return
     }
 
-    saveVideoToPhotoLibrary(fileURL: outputFileURL) { [weak self] success, message in
+    latestFileSaved = true
-      guard let self else { return }
+    latestFileErrorMessage = nil
-      self.latestGallerySaved = success
+    latestOutputPath = outputFileURL.path
-      self.latestGalleryErrorMessage = message
+    guard FileManager.default.fileExists(atPath: outputFileURL.path) else {
-      if success {
+      latestFileSaved = false
-        self.updateStatus(
+      latestFileErrorMessage = "录制文件未生成"
-          RecordingStatus(
+      updateStatus(
-            state: .previewing,
-            outputPath: self.latestOutputPath,
-            elapsedMillis: self.elapsedMillis()
-          )
-        )
-      } else {
-        self.updateStatus(
         RecordingStatus(
           state: .error,
-            outputPath: self.latestOutputPath,
+          outputPath: latestOutputPath,
-            message: message ?? "保存到相册失败"
+          message: latestFileErrorMessage
         )
       )
+      finishStopRecording(stopResult: stopResult)
+      return
     }
-      self.finishStopRecording(stopResult: stopResult)
+    updateStatus(
-    }
+      RecordingStatus(
+        state: .previewing,
+        outputPath: latestOutputPath,
+        elapsedMillis: elapsedMillis()
+      )
+    )
+    finishStopRecording(stopResult: stopResult)
   }
 
   private func finishStopRecording(stopResult: FlutterResult?) {
@@ -347,79 +413,23 @@ private final class RecordingCameraController: NSObject, AVCaptureFileOutputReco
       var payload: [String: Any] = [
         "outputPath": self.latestOutputPath as Any,
         "status": self.currentStatusMap(),
-        "gallerySaved": self.latestGallerySaved,
+        "fileSaved": self.latestFileSaved,
       ]
-      if !self.latestGallerySaved {
+      if !self.latestFileSaved {
-        payload["galleryErrorMessage"] =
+        payload["fileErrorMessage"] =
-          self.latestGalleryErrorMessage ?? "保存到相册失败，请开启相册权限"
+          self.latestFileErrorMessage ?? "保存到文件夹失败，请检查文件保存权限"
       }
       stopResult?(payload)
     }
   }
 
-  private func saveVideoToPhotoLibrary(
-    fileURL: URL,
-    completion: @escaping (Bool, String?) -> Void
-  ) {
-    let performSave = {
-      PHPhotoLibrary.shared().performChanges({
-        PHAssetCreationRequest.forAsset().addResource(with: .video, fileURL: fileURL, options: nil)
-      }) { success, error in
-        if success {
-          try? FileManager.default.removeItem(at: fileURL)
-          completion(true, nil)
-        } else {
-          completion(false, error?.localizedDescription ?? "保存到相册失败")
-        }
-      }
-    }
-
-    if #available(iOS 14, *) {
-      let status = PHPhotoLibrary.authorizationStatus(for: .addOnly)
-      switch status {
-      case .authorized, .limited:
-        performSave()
-      case .notDetermined:
-        PHPhotoLibrary.requestAuthorization(for: .addOnly) { newStatus in
-          if newStatus == .authorized || newStatus == .limited {
-            performSave()
-          } else {
-            completion(false, "未授予相册权限")
-          }
-        }
-      default:
-        completion(false, "未授予相册权限")
-      }
-    } else {
-      let status = PHPhotoLibrary.authorizationStatus()
-      switch status {
-      case .authorized:
-        performSave()
-      case .notDetermined:
-        PHPhotoLibrary.requestAuthorization { newStatus in
-          if newStatus == .authorized {
-            performSave()
-          } else {
-            completion(false, "未授予相册权限")
-          }
-        }
-      default:
-        completion(false, "未授予相册权限")
-      }
-    }
-  }
-
   private func configureSession(withAudio: Bool) throws {
     if configured {
       try configureAudioInput(enabled: withAudio)
       return
     }
 
-    guard
+    guard let videoDevice = Self.preferredVideoDevice() else {
-      let videoDevice = AVCaptureDevice.default(
-        .builtInWideAngleCamera, for: .video, position: .back)
-        ?? AVCaptureDevice.default(for: .video)
-    else {
       throw NSError(
         domain: "RecordingCamera", code: 1,
         userInfo: [NSLocalizedDescriptionKey: "No camera device available"])
@@ -449,9 +459,74 @@ private final class RecordingCameraController: NSObject, AVCaptureFileOutputReco
     session.commitConfiguration()
 
     configured = true
+    // 默认以主摄(显示 1.0x)开场：虚拟多摄设备里主摄对应的 zoomFactor 是 S。
+    currentZoomRatio = mainBaselineFactor(for: videoDevice)
+    try applyCurrentZoom()
     try configureAudioInput(enabled: withAudio)
   }
 
+  /// 优先选用包含超广角的虚拟多摄设备，使 minAvailableVideoZoomFactor 能低于主摄(从而支持 0.6x)。
+  private static func preferredVideoDevice() -> AVCaptureDevice? {
+    let preferredTypes: [AVCaptureDevice.DeviceType] = [
+      .builtInTripleCamera,
+      .builtInDualWideCamera,
+      .builtInWideAngleCamera,
+    ]
+    for type in preferredTypes {
+      if let device = AVCaptureDevice.default(type, for: .video, position: .back) {
+        return device
+      }
+    }
+    return AVCaptureDevice.default(for: .video)
+  }
+
+  /// 虚拟多摄设备中「主摄(显示 1.0x)」对应的设备 zoomFactor 基准 S。
+  /// 取 ultra-wide → wide 的切换点；非虚拟设备无切换点时返回 1.0(向后兼容)。
+  private func mainBaselineFactor(for device: AVCaptureDevice) -> CGFloat {
+    if let first = device.virtualDeviceSwitchOverVideoZoomFactors.first {
+      let value = CGFloat(truncating: first)
+      if value > 0 {
+        return value
+      }
+    }
+    return 1.0
+  }
+
+  private func currentZoomCapabilitiesMap() -> [String: Any] {
+    guard let device = videoInput?.device else {
+      return [
+        "zoomRatio": Double(currentZoomRatio),
+        "minZoomRatio": 1.0,
+        "maxZoomRatio": 3.0,
+      ]
+    }
+
+    // 设备 zoomFactor 以 S 为基准换算成 App 使用的「显示倍率」(1.0x = 主摄)。
+    let baseline = mainBaselineFactor(for: device)
+    let minZoom = device.minAvailableVideoZoomFactor
+    let maxZoom = device.maxAvailableVideoZoomFactor
+    let zoom = clampedZoomRatio(device.videoZoomFactor, for: device)
+    currentZoomRatio = zoom
+    return [
+      "zoomRatio": Double(zoom / baseline),
+      "minZoomRatio": Double(minZoom / baseline),
+      "maxZoomRatio": Double(maxZoom / baseline),
+    ]
+  }
+
+  private func applyCurrentZoom() throws {
+    guard let device = videoInput?.device else { return }
+    let nextZoom = clampedZoomRatio(currentZoomRatio, for: device)
+    try device.lockForConfiguration()
+    device.videoZoomFactor = nextZoom
+    device.unlockForConfiguration()
+    currentZoomRatio = nextZoom
+  }
+
+  private func clampedZoomRatio(_ ratio: CGFloat, for device: AVCaptureDevice) -> CGFloat {
+    min(max(ratio, device.minAvailableVideoZoomFactor), device.maxAvailableVideoZoomFactor)
+  }
+
   private func configureAudioInput(enabled: Bool) throws {
     session.beginConfiguration()
     defer { session.commitConfiguration() }
@@ -486,7 +561,30 @@ private final class RecordingCameraController: NSObject, AVCaptureFileOutputReco
     try FileManager.default.createDirectory(at: recordingsURL, withIntermediateDirectories: true)
 
     let fileName = Self.resolveFileName(displayName: displayName)
-    return recordingsURL.appendingPathComponent(fileName)
+    return uniqueOutputURL(in: recordingsURL, preferredFileName: fileName)
+  }
+
+  private func uniqueOutputURL(in directoryURL: URL, preferredFileName: String) -> URL {
+    let preferredURL = directoryURL.appendingPathComponent(preferredFileName)
+    guard !FileManager.default.fileExists(atPath: preferredURL.path) else {
+      let fileExtension = preferredURL.pathExtension
+      let baseName = preferredURL.deletingPathExtension().lastPathComponent
+      let timestamp = Self.fileNameDateFormatter.string(from: Date())
+
+      var index = 0
+      while true {
+        let suffix = index == 0 ? timestamp : "\(timestamp)_\(index)"
+        let nextName = fileExtension.isEmpty
+          ? "\(baseName)_\(suffix)"
+          : "\(baseName)_\(suffix).\(fileExtension)"
+        let nextURL = directoryURL.appendingPathComponent(nextName)
+        if !FileManager.default.fileExists(atPath: nextURL.path) {
+          return nextURL
+        }
+        index += 1
+      }
+    }
+    return preferredURL
   }
 
   private static func resolveFileName(displayName: String?) -> String {
@@ -504,6 +602,13 @@ private final class RecordingCameraController: NSObject, AVCaptureFileOutputReco
     return "REC_\(formatter.string(from: Date())).mov"
   }
 
+  private static let fileNameDateFormatter: DateFormatter = {
+    let formatter = DateFormatter()
+    formatter.locale = Locale(identifier: "en_US_POSIX")
+    formatter.dateFormat = "yyyyMMdd_HHmmss"
+    return formatter
+  }()
+
   private func updateStatus(_ next: RecordingStatus) {
     status = next
   }
@@ -528,7 +633,7 @@ private final class RecordingCameraController: NSObject, AVCaptureFileOutputReco
 }
 
 private enum RecordingChannelNames {
-  static let packageName = "com.qxy.dronex"
+  static let packageName = "com.dronex.rec"
   static let method = "\(packageName)/recording"
   static let events = "\(packageName)/recording_events"
 }
@@ -571,6 +676,12 @@ final class RecordingPlugin: NSObject, FlutterPlugin, FlutterStreamHandler {
       controller.startRecording(withAudio: withAudio, displayName: displayName, result: result)
     case "stopRecording":
       controller.stopRecording(result: result)
+    case "getZoomCapabilities":
+      controller.zoomCapabilities(result: result)
+    case "setZoomRatio":
+      let args = call.arguments as? [String: Any]
+      let ratio = args?["zoomRatio"] as? Double ?? 1.0
+      controller.setZoomRatio(CGFloat(ratio), result: result)
     case "disposePreview":
       controller.disposePreview(result: result)
     case "getStatus":

lib/app/app.dart

@@ -3,12 +3,12 @@ import 'package:flutter_easyloading/flutter_easyloading.dart';
 import 'package:flutter_localizations/flutter_localizations.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:pull_to_refresh/pull_to_refresh.dart';
 import 'package:recording_tool/app/config/app_config.dart';
 import 'package:recording_tool/app/router/app_navigator.dart';
 import 'package:recording_tool/app/theme/app_theme.dart';
-import 'package:recording_tool/features/recording/recording_page.dart';
+import 'package:recording_tool/features/recording/pages/page_record.dart';
 import 'package:recording_tool/features/recording/view-model/view_model_recording.dart';
-import 'package:pull_to_refresh/pull_to_refresh.dart';
 
 class FlutterTemplateApp extends ConsumerStatefulWidget {
   const FlutterTemplateApp({super.key});

lib/app/config/app_config.dart

@@ -37,12 +37,12 @@ class AppConfig {
       ),
       AppEnvironment.staging => const EnvironmentValues(
         environment: AppEnvironment.staging,
-        baseUrl: 'https://staging.example.com/api',
+        baseUrl: 'https://example.com/api',
         enableNetworkLog: true,
       ),
       AppEnvironment.prod => const EnvironmentValues(
         environment: AppEnvironment.prod,
-        baseUrl: 'https://api.example.com',
+        baseUrl: 'https://example.com/api',
         enableNetworkLog: false,
       ),
     };

lib/core/platform/app_platform_info.dart

@@ -60,7 +60,7 @@ class AppPlatformInfo {
   AppPlatformInfo._();
 
   static const MethodChannel _channel = MethodChannel(
-    'com.qxy.dronex/platform_info',
+    'com.dronex.rec/platform_info',
   );
 
   static Future<AppPackageInfo> packageInfo() async {

lib/features/dialog/dialog-record.dart

@@ -0,0 +1,281 @@
+// ignore_for_file: file_names
+
+import 'package:flutter/material.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:recording_tool/gen/assets.gen.dart';
+
+/// 录制页统一弹窗，支持单按钮和双按钮。
+class RecordDialog extends StatelessWidget {
+  const RecordDialog({super.key, required this.title, required this.actions});
+
+  static const _transitionDuration = Duration(milliseconds: 280);
+
+  final String title;
+  final List<RecordDialogAction> actions;
+
+  static Future<void> showSingle(
+    BuildContext context, {
+    required String title,
+    required String buttonText,
+    VoidCallback? onPressed,
+    bool barrierDismissible = true,
+  }) {
+    return _present(
+      context,
+      barrierDismissible: barrierDismissible,
+      builder: (dialogContext) {
+        return RecordDialog(
+          title: title,
+          actions: [
+            RecordDialogAction.primary(
+              text: buttonText,
+              onPressed: () {
+                Navigator.of(dialogContext).pop();
+                onPressed?.call();
+              },
+            ),
+          ],
+        );
+      },
+    );
+  }
+
+  static Future<void> showDouble(
+    BuildContext context, {
+    required String title,
+    required String leftText,
+    required String rightText,
+    VoidCallback? onLeftPressed,
+    VoidCallback? onRightPressed,
+    bool barrierDismissible = false,
+  }) {
+    return _present(
+      context,
+      barrierDismissible: barrierDismissible,
+      builder: (dialogContext) {
+        return RecordDialog(
+          title: title,
+          actions: [
+            RecordDialogAction.secondary(
+              text: leftText,
+              onPressed: () {
+                Navigator.of(dialogContext).pop();
+                onLeftPressed?.call();
+              },
+            ),
+            RecordDialogAction.primary(
+              text: rightText,
+              onPressed: () {
+                Navigator.of(dialogContext).pop();
+                onRightPressed?.call();
+              },
+            ),
+          ],
+        );
+      },
+    );
+  }
+
+  static Future<void> _present(
+    BuildContext context, {
+    required Widget Function(BuildContext dialogContext) builder,
+    required bool barrierDismissible,
+  }) {
+    return showGeneralDialog<void>(
+      context: context,
+      barrierDismissible: barrierDismissible,
+      barrierLabel: MaterialLocalizations.of(context).modalBarrierDismissLabel,
+      barrierColor: Colors.black54,
+      transitionDuration: _transitionDuration,
+      pageBuilder: (dialogContext, animation, secondaryAnimation) {
+        return builder(dialogContext);
+      },
+      transitionBuilder: _buildTransition,
+    );
+  }
+
+  static Widget _buildTransition(
+    BuildContext context,
+    Animation<double> animation,
+    Animation<double> secondaryAnimation,
+    Widget child,
+  ) {
+    final curved = CurvedAnimation(
+      parent: animation,
+      curve: Curves.easeOutCubic,
+      reverseCurve: Curves.easeInCubic,
+    );
+
+    return FadeTransition(
+      opacity: curved,
+      child: SlideTransition(
+        position: Tween<Offset>(
+          begin: const Offset(0, 0.08),
+          end: Offset.zero,
+        ).animate(curved),
+        child: ScaleTransition(
+          scale: Tween<double>(begin: 0.92, end: 1).animate(curved),
+          child: child,
+        ),
+      ),
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final actionWidgets = actions
+        .map((action) => Expanded(child: _RecordDialogButton(action: action)))
+        .toList();
+
+    return Dialog(
+      elevation: 0,
+      backgroundColor: Colors.transparent,
+      insetPadding: EdgeInsets.symmetric(horizontal: 37.w),
+      child: ClipRRect(
+        clipBehavior: Clip.none,
+
+        borderRadius: BorderRadius.circular(18.r),
+        child: Container(
+          width: 315.w,
+          // height: 188.r,
+          decoration: BoxDecoration(
+            color: Colors.white,
+
+            borderRadius: BorderRadius.circular(18.r),
+          ),
+          child: Stack(
+            clipBehavior: Clip.none,
+            children: [
+              Positioned(
+                top: -88.r,
+                left: 0,
+                right: 0,
+                child: Image.asset(
+                  Assets.images.imageDialogBg.path,
+                  width: double.maxFinite,
+                  height: 155.h,
+                  fit: BoxFit.fitWidth,
+                ),
+              ),
+              Column(
+                mainAxisSize: MainAxisSize.min,
+                children: [
+                  Padding(
+                    padding: EdgeInsets.fromLTRB(24.w, 44.h, 24.w, 26.h),
+                    child: Column(
+                      mainAxisSize: MainAxisSize.min,
+                      children: [
+                        Text(
+                          title,
+                          textAlign: TextAlign.center,
+                          style: TextStyle(
+                            color: const Color(0xFF333333),
+                            fontSize: 19.sp,
+                            fontWeight: FontWeight.w600,
+                            height: 1.35,
+                          ),
+                        ),
+                        SizedBox(height: 22.h),
+                        Row(
+                          children: [
+                            for (
+                              var index = 0;
+                              index < actionWidgets.length;
+                              index++
+                            ) ...[
+                              if (index > 0) SizedBox(width: 16.w),
+                              actionWidgets[index],
+                            ],
+                          ],
+                        ),
+                      ],
+                    ),
+                  ),
+                ],
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+class RecordDialogAction {
+  const RecordDialogAction._({
+    required this.text,
+    required this.onPressed,
+    required this.isPrimary,
+  });
+
+  factory RecordDialogAction.primary({
+    required String text,
+    required VoidCallback onPressed,
+  }) {
+    return RecordDialogAction._(
+      text: text,
+      onPressed: onPressed,
+      isPrimary: true,
+    );
+  }
+
+  factory RecordDialogAction.secondary({
+    required String text,
+    required VoidCallback onPressed,
+  }) {
+    return RecordDialogAction._(
+      text: text,
+      onPressed: onPressed,
+      isPrimary: false,
+    );
+  }
+
+  final String text;
+  final VoidCallback onPressed;
+  final bool isPrimary;
+}
+
+class _RecordDialogButton extends StatelessWidget {
+  const _RecordDialogButton({required this.action});
+
+  final RecordDialogAction action;
+
+  @override
+  Widget build(BuildContext context) {
+    final child = Center(
+      child: Text(
+        action.text,
+        style: TextStyle(
+          color: action.isPrimary ? Colors.white : const Color(0xFF333333),
+          fontSize: 18.sp,
+          fontWeight: FontWeight.w600,
+        ),
+      ),
+    );
+
+    return SizedBox(
+      height: 48.h,
+      child: TextButton(
+        onPressed: action.onPressed,
+        style: TextButton.styleFrom(
+          padding: EdgeInsets.zero,
+          shape: RoundedRectangleBorder(
+            borderRadius: BorderRadius.circular(24.r),
+          ),
+          backgroundColor: action.isPrimary ? null : const Color(0xFFF2F2F2),
+        ),
+        child: action.isPrimary
+            ? DecoratedBox(
+                decoration: BoxDecoration(
+                  gradient: const LinearGradient(
+                    colors: [Color(0xFF2F85FF), Color(0xFF5DCCF4)],
+                  ),
+                  borderRadius: BorderRadius.circular(24.r),
+                ),
+                child: SizedBox.expand(child: child),
+              )
+            : child,
+      ),
+    );
+  }
+}

lib/features/recording/model/model_recording.dart

@@ -1,4 +1,5 @@
 import 'package:recording_tool/features/recording/model/model_clipboard.dart';
+import 'package:recording_tool/features/recording/model/model_recording_session.dart';
 
 class RecordingModel {
   /// 剪切板内容
@@ -7,11 +8,17 @@ class RecordingModel {
   /// 剪切板是否包含有效的小程序录制信息
   final bool hasValidClipboardInfo;
 
+  /// 录制会话状态
+  final RecordingSessionState session;
+
   RecordingModel({
     required this.clipboardRecordingModel,
     this.hasValidClipboardInfo = false,
+    this.session = const RecordingSessionState(),
   });
 
+  bool get isRecording => session.isRecording;
+
   factory RecordingModel.fromJson(Map<String, dynamic> json) {
     return RecordingModel(
       clipboardRecordingModel: ClipboardRecordingModel.fromJson(
@@ -32,12 +39,14 @@ class RecordingModel {
   RecordingModel copyWith({
     ClipboardRecordingModel? clipboardRecordingModel,
     bool? hasValidClipboardInfo,
+    RecordingSessionState? session,
   }) {
     return RecordingModel(
       clipboardRecordingModel:
           clipboardRecordingModel ?? this.clipboardRecordingModel,
       hasValidClipboardInfo:
           hasValidClipboardInfo ?? this.hasValidClipboardInfo,
+      session: session ?? this.session,
     );
   }
 }

lib/features/recording/model/model_recording_session.dart

@@ -0,0 +1,95 @@
+import 'package:recording_tool/features/recording/platform/recording_platform.dart';
+
+/// 录制会话状态（相机预览、权限、录制进度等）。
+class RecordingSessionState {
+  const RecordingSessionState({
+    this.status = const RecordingStatus(state: RecordingState.idle),
+    this.isTouchLocked = true,
+    this.isPreviewReady = false,
+    this.isStartingRecording = false,
+    this.hasDndAccess = false,
+    this.isBatteryOptimizedIgnored = true,
+    this.notificationsGranted = true,
+    this.isMicrophoneGranted = false,
+    this.zoomRatio = 1.0,
+    this.minZoomRatio = 1.0,
+    this.maxZoomRatio = 3.0,
+    this.lastOutputPath,
+    this.lastSavedDisplayName,
+    this.errorMessage,
+    this.permissionWarning,
+    this.fileSaveFailed = false,
+  });
+
+  final RecordingStatus status;
+  final bool isTouchLocked;
+  final bool isPreviewReady;
+  final bool isStartingRecording;
+  final bool hasDndAccess;
+  final bool isBatteryOptimizedIgnored;
+  final bool notificationsGranted;
+  final bool isMicrophoneGranted;
+  final double zoomRatio;
+  final double minZoomRatio;
+  final double maxZoomRatio;
+  final String? lastOutputPath;
+  final String? lastSavedDisplayName;
+  final String? errorMessage;
+  final String? permissionWarning;
+  final bool fileSaveFailed;
+
+  bool get isRecording => status.isRecording;
+
+  String get elapsedLabel {
+    final totalSeconds = status.elapsedMillis ~/ 1000;
+    final hours = (totalSeconds ~/ 3600).toString().padLeft(2, '0');
+    final minutes = ((totalSeconds % 3600) ~/ 60).toString().padLeft(2, '0');
+    final seconds = (totalSeconds % 60).toString().padLeft(2, '0');
+    return '$hours:$minutes:$seconds';
+  }
+
+  RecordingSessionState copyWith({
+    RecordingStatus? status,
+    bool? isTouchLocked,
+    bool? isPreviewReady,
+    bool? isStartingRecording,
+    bool? hasDndAccess,
+    bool? isBatteryOptimizedIgnored,
+    bool? notificationsGranted,
+    bool? isMicrophoneGranted,
+    double? zoomRatio,
+    double? minZoomRatio,
+    double? maxZoomRatio,
+    String? lastOutputPath,
+    String? lastSavedDisplayName,
+    String? errorMessage,
+    String? permissionWarning,
+    bool? fileSaveFailed,
+    bool clearPermissionWarning = false,
+    bool clearLastSaved = false,
+  }) {
+    return RecordingSessionState(
+      status: status ?? this.status,
+      isTouchLocked: isTouchLocked ?? this.isTouchLocked,
+      isPreviewReady: isPreviewReady ?? this.isPreviewReady,
+      isStartingRecording: isStartingRecording ?? this.isStartingRecording,
+      hasDndAccess: hasDndAccess ?? this.hasDndAccess,
+      isBatteryOptimizedIgnored:
+          isBatteryOptimizedIgnored ?? this.isBatteryOptimizedIgnored,
+      notificationsGranted: notificationsGranted ?? this.notificationsGranted,
+      isMicrophoneGranted: isMicrophoneGranted ?? this.isMicrophoneGranted,
+      zoomRatio: zoomRatio ?? this.zoomRatio,
+      minZoomRatio: minZoomRatio ?? this.minZoomRatio,
+      maxZoomRatio: maxZoomRatio ?? this.maxZoomRatio,
+      lastOutputPath: lastOutputPath ?? this.lastOutputPath,
+      lastSavedDisplayName: clearLastSaved
+          ? null
+          : (lastSavedDisplayName ?? this.lastSavedDisplayName),
+      errorMessage: errorMessage,
+      permissionWarning: clearPermissionWarning
+          ? null
+          : (permissionWarning ?? this.permissionWarning),
+      fileSaveFailed: fileSaveFailed ?? this.fileSaveFailed,
+    );
+  }
+}

lib/features/recording/pages/page_record.dart

@@ -0,0 +1,491 @@
+import 'dart:io';
+
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:permission_handler/permission_handler.dart';
+import 'package:recording_tool/core/platform/app_platform_info.dart';
+import 'package:recording_tool/core/platform/device_health_checker.dart';
+import 'package:recording_tool/features/dialog/dialog-record.dart';
+import 'package:recording_tool/features/recording/model/model_recording.dart';
+import 'package:recording_tool/features/recording/platform/recording_platform.dart';
+import 'package:recording_tool/features/recording/utils/recording_display_name.dart';
+import 'package:recording_tool/features/recording/view-model/view_model_recording.dart';
+import 'package:recording_tool/features/recording/widgets/widget_camera_preview.dart';
+import 'package:recording_tool/features/recording/widgets/widget_record_footer.dart';
+import 'package:recording_tool/features/recording/widgets/widget_record_header.dart';
+import 'package:recording_tool/features/recording/widgets/widget_record_timer.dart';
+import 'package:recording_tool/features/recording/widgets/widget_recording_hud.dart';
+import 'package:recording_tool/features/recording/widgets/widget_recording_loading_overlay.dart';
+import 'package:recording_tool/features/recording/widgets/widget_recording_saved_dialog.dart';
+import 'package:recording_tool/features/recording/widgets/widget_recording_touch_lock_overlay.dart';
+import 'package:recording_tool/shared/widgets/widgets.dart';
+
+/// 录制页入口
+class RecordingPage extends ConsumerStatefulWidget {
+  const RecordingPage({super.key});
+
+  @override
+  /// 创建页面状态
+  ConsumerState<RecordingPage> createState() => _RecordingPageState();
+}
+
+class _RecordingPageState extends ConsumerState<RecordingPage> {
+  var _immersiveApplied = false;
+
+  @override
+  /// 首帧后初始化录制流程
+  void initState() {
+    super.initState();
+    WidgetsBinding.instance.addPostFrameCallback((_) => _bootstrap());
+  }
+
+  /// 检查设备健康状态并弹窗提示
+  Future<void> _checkAndShowDeviceHealthAlerts() async {
+    final snapshot = await AppPlatformInfo.deviceHealth();
+    if (!mounted) return;
+
+    final lines = DeviceHealthChecker.warningLines(snapshot);
+    if (lines.isEmpty) return;
+
+    await RecordDialog.showSingle(
+      context,
+      title: lines.join('\n'),
+      buttonText: '确定',
+    );
+  }
+
+  /// 页面启动：健康检查、读剪贴板、进入录制模式、准备相机会话
+  Future<void> _bootstrap() async {
+    await _checkAndShowDeviceHealthAlerts();
+    if (!mounted) return;
+
+    final clipboardResult = await ref
+        .read(recordingViewModelProvider.notifier)
+        .getClipboardContent();
+    if (!mounted) return;
+    if (clipboardResult == ClipboardReadResult.invalid) {
+      AppToast.show('无选手信息');
+    }
+    await _enterRecordingMode();
+    // Allow PlatformView to attach before binding CameraX preview.
+    await Future<void>.delayed(const Duration(milliseconds: 400));
+    if (!mounted) return;
+    await ref.read(recordingViewModelProvider.notifier).prepareSession();
+  }
+
+  /// Android 进入沉浸式全屏
+  Future<void> _enterRecordingMode() async {
+    if (!Platform.isAndroid) return;
+    await SystemChrome.setEnabledSystemUIMode(SystemUiMode.immersiveSticky);
+    await RecordingPlatform.setImmersiveMode(enabled: true);
+    _immersiveApplied = true;
+  }
+
+  /// 解析保存成功弹窗的标题文案
+  String _savedDialogSessionTitle(
+    RecordingModel recordingInfo,
+    String? savedName,
+  ) {
+    final clipboard = recordingInfo.clipboardRecordingModel;
+    if (recordingInfo.hasValidClipboardInfo &&
+        clipboard.title.trim().isNotEmpty) {
+      return clipboard.title.trim();
+    }
+    if (savedName != null && savedName.isNotEmpty) {
+      return resolveRecordingDisplayName(savedName);
+    }
+    return '录制完成';
+  }
+
+  /// 从剪贴板粘贴赛事信息（与 header「粘贴选手信息」一致）。
+  Future<void> _pasteEventInfo() async {
+    final result = await ref
+        .read(recordingViewModelProvider.notifier)
+        .getClipboardContent();
+    if (!mounted) return;
+    if (result != ClipboardReadResult.success) {
+      AppToast.show('无选手信息');
+    }
+  }
+
+  /// 无选手信息时弹窗提示
+  Future<void> _showNoPlayerInfoDialog() {
+    return RecordDialog.showSingle(
+      context,
+      title: '无选手信息！',
+      buttonText: '粘贴',
+      onPressed: _pasteEventInfo,
+    );
+  }
+
+  /// 根据缺失权限生成弹窗文案。
+  String _recordingPermissionDialogTitle(RecordingRequiredPermissions result) {
+    if (!result.cameraGranted && !result.microphoneGranted) {
+      return '录制需要开启相机和录音权限，请在系统设置中授权后重试';
+    }
+    if (!result.cameraGranted) {
+      return '录制需要开启相机权限，请在系统设置中授权后重试';
+    }
+    return '录制需要开启录音权限，请在系统设置中授权后重试';
+  }
+
+  /// 开始录制前检测相机、录音权限，未授予则弹窗并跳转系统设置。
+  Future<bool> _ensureRecordingPermissions() async {
+    final result = await ref
+        .read(recordingViewModelProvider.notifier)
+        .ensureCameraAndMicrophonePermissions();
+    if (result.allGranted) {
+      final ready = ref.read(recordingViewModelProvider).session.isPreviewReady;
+      if (ready) return true;
+      if (!mounted) return false;
+      AppToast.show('相机预览启动失败，请重试');
+      return false;
+    }
+    if (!mounted) return false;
+
+    await RecordDialog.showSingle(
+      context,
+      title: _recordingPermissionDialogTitle(result),
+      buttonText: '确定',
+      onPressed: openAppSettings,
+    );
+    return false;
+  }
+
+  /// 点击开始录制：校验剪贴板、权限与健康状态
+  Future<void> _onStartRecording() async {
+    final recordingInfo = ref.read(recordingViewModelProvider);
+    if (!recordingInfo.hasClipboardFilename) {
+      await _showNoPlayerInfoDialog();
+      return;
+    }
+    if (!await _ensureRecordingPermissions()) return;
+    if (!mounted) return;
+    await _checkAndShowDeviceHealthAlerts();
+    if (!mounted) return;
+    await ref.read(recordingViewModelProvider.notifier).startRecording();
+  }
+
+  /// 停止录制并按结果显示保存提示。
+  Future<void> _stopRecordingAndShowResult() async {
+    await ref.read(recordingViewModelProvider.notifier).stopRecording();
+    if (!mounted) return;
+    final latest = ref.read(recordingViewModelProvider).session;
+    if (latest.fileSaveFailed) {
+      AppToast.show(latest.errorMessage ?? '保存到文件夹失败，请检查文件保存权限');
+      return;
+    }
+    await _showRecordingSavedDialogIfNeeded();
+  }
+
+  /// 清空剪贴板信息，准备新一轮录制
+  void _clearClipboardForNewRound() {
+    final notifier = ref.read(recordingViewModelProvider.notifier);
+    notifier.resetClipboardInfo();
+    notifier.clearSavedRecordingResult();
+  }
+
+  /// 保存成功后按需弹出完成对话框
+  Future<void> _showRecordingSavedDialogIfNeeded() async {
+    final recordingInfo = ref.read(recordingViewModelProvider);
+    final session = recordingInfo.session;
+    if (session.lastSavedDisplayName == null || session.fileSaveFailed) {
+      return;
+    }
+
+    final sessionTitle = _savedDialogSessionTitle(
+      recordingInfo,
+      session.lastSavedDisplayName,
+    );
+
+    await showRecordingSavedDialog(
+      context,
+      sessionTitle: sessionTitle,
+      onContinueRound: () {
+        ref
+            .read(recordingViewModelProvider.notifier)
+            .clearSavedRecordingResult();
+      },
+      onRecordNewRound: _clearClipboardForNewRound,
+    );
+  }
+
+  /// 退出沉浸式并释放录制会话
+  Future<void> _exitRecordingMode() async {
+    if (!_immersiveApplied) return;
+    await ref.read(recordingViewModelProvider.notifier).teardown();
+    await SystemChrome.setEnabledSystemUIMode(
+      SystemUiMode.manual,
+      overlays: SystemUiOverlay.values,
+    );
+    await RecordingPlatform.setImmersiveMode(enabled: false);
+    _immersiveApplied = false;
+  }
+
+  @override
+  /// 页面销毁时恢复系统 UI
+  void dispose() {
+    if (_immersiveApplied) {
+      SystemChrome.setEnabledSystemUIMode(
+        SystemUiMode.manual,
+        overlays: SystemUiOverlay.values,
+      );
+      RecordingPlatform.setImmersiveMode(enabled: false);
+    }
+    super.dispose();
+  }
+
+  @override
+  /// 构建录制页 UI
+  Widget build(BuildContext context) {
+    return _RecordingPopScope(
+      onExitRecordingMode: _exitRecordingMode,
+      child: Scaffold(
+        backgroundColor: Colors.black,
+        body: Column(
+          children: [
+            _RecordHeaderSection(
+              onPasteEventInfo: _pasteEventInfo,
+              onClearEventInfo: _clearClipboardForNewRound,
+            ),
+            Expanded(
+              child: Stack(
+                children: [
+                  const CameraPreviewWidget(),
+                  const _PreviewLoadingLayer(),
+                  const RecordTimerWidget(),
+                  _RecordingHudLayer(
+                    onStart: _onStartRecording,
+                    onStop: _stopRecordingAndShowResult,
+                  ),
+                  _TouchLockOverlayLayer(
+                    onStopRecording: _stopRecordingAndShowResult,
+                  ),
+                  const _StartingRecordingOverlay(),
+                ],
+              ),
+            ),
+            const RecordFooter(),
+          ],
+        ),
+      ),
+    );
+  }
+}
+
+class _RecordingPopScope extends ConsumerWidget {
+  const _RecordingPopScope({
+    required this.onExitRecordingMode,
+    required this.child,
+  });
+
+  final Future<void> Function() onExitRecordingMode;
+  final Widget child;
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final isRecording = ref.watch(
+      recordingViewModelProvider.select((m) => m.session.isRecording),
+    );
+
+    return PopScope(
+      canPop: !isRecording,
+      onPopInvokedWithResult: (didPop, result) async {
+        if (didPop) {
+          await onExitRecordingMode();
+          return;
+        }
+        if (isRecording) {
+          AppToast.show('录制中无法返回，请先停止录制');
+        }
+      },
+      child: child,
+    );
+  }
+}
+
+class _RecordHeaderSection extends ConsumerWidget {
+  const _RecordHeaderSection({
+    required this.onPasteEventInfo,
+    required this.onClearEventInfo,
+  });
+
+  final Future<void> Function() onPasteEventInfo;
+  final VoidCallback onClearEventInfo;
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final headerState = ref.watch(
+      recordingViewModelProvider.select(
+        (m) => (
+          m.hasValidClipboardInfo,
+          m.hasValidClipboardInfo ? m.clipboardRecordingModel.title : null,
+          m.session.isRecording,
+        ),
+      ),
+    );
+    final (hasValidClipboardInfo, eventTitle, isRecording) = headerState;
+
+    return RecordHeaderWidget(
+      hasValidClipboardInfo: hasValidClipboardInfo,
+      eventTitle: eventTitle,
+      isRecording: isRecording,
+      onPasteEventInfo: onPasteEventInfo,
+      onClearEventInfo: onClearEventInfo,
+    );
+  }
+}
+
+class _PreviewLoadingLayer extends ConsumerWidget {
+  const _PreviewLoadingLayer();
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final showLoading = ref.watch(
+      recordingViewModelProvider.select(
+        (m) => !m.session.isPreviewReady && m.session.errorMessage == null,
+      ),
+    );
+
+    if (!showLoading) {
+      return const SizedBox.shrink();
+    }
+
+    return const RecordingLoadingOverlayWidget(message: '正在启动相机…');
+  }
+}
+
+class _RecordingHudLayer extends ConsumerWidget {
+  const _RecordingHudLayer({required this.onStart, required this.onStop});
+
+  final Future<void> Function() onStart;
+  final Future<void> Function() onStop;
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final hudState = ref.watch(
+      recordingViewModelProvider.select(
+        (m) => (
+          m.session.errorMessage,
+          m.session.permissionWarning,
+          m.session.hasDndAccess,
+          m.session.isBatteryOptimizedIgnored,
+          m.session.notificationsGranted,
+          m.session.isRecording,
+          m.session.isStartingRecording,
+          m.session.isTouchLocked,
+          m.session.zoomRatio,
+          m.session.minZoomRatio,
+          m.session.maxZoomRatio,
+          m.hasValidClipboardInfo,
+          m.clipboardRecordingModel.address.trim(),
+        ),
+      ),
+    );
+    final (
+      errorMessage,
+      permissionWarning,
+      hasDndAccess,
+      isBatteryOptimizedIgnored,
+      notificationsGranted,
+      isRecording,
+      isStartingRecording,
+      isTouchLocked,
+      zoomRatio,
+      minZoomRatio,
+      maxZoomRatio,
+      showClipboardHint,
+      clipboardAddress,
+    ) = hudState;
+    final viewModel = ref.read(recordingViewModelProvider.notifier);
+
+    return RecordingHudWidget(
+      errorMessage: errorMessage,
+      permissionWarning: permissionWarning,
+      hasDndAccess: hasDndAccess,
+      isBatteryOptimizedIgnored: isBatteryOptimizedIgnored,
+      notificationsGranted: notificationsGranted,
+      isRecording: isRecording,
+      isStartingRecording: isStartingRecording,
+      isTouchLocked: isTouchLocked,
+      zoomRatio: zoomRatio,
+      minZoomRatio: minZoomRatio,
+      maxZoomRatio: maxZoomRatio,
+      showClipboardHint: showClipboardHint,
+      clipboardAddress: clipboardAddress,
+      onStart: onStart,
+      onStop: onStop,
+      onOpenDnd: () async {
+        await viewModel.openDndSettings();
+        await viewModel.refreshDndAccess();
+      },
+      onOpenBattery: () async {
+        await viewModel.openBatterySettings();
+        await viewModel.refreshBatteryOptimization();
+      },
+      onToggleTouchLock: () {
+        final locked = ref
+            .read(recordingViewModelProvider)
+            .session
+            .isTouchLocked;
+        viewModel.setTouchLocked(!locked);
+      },
+      onZoomSelected: (ratio) async {
+        await viewModel.setZoomRatio(ratio);
+      },
+    );
+  }
+}
+
+class _TouchLockOverlayLayer extends ConsumerWidget {
+  const _TouchLockOverlayLayer({required this.onStopRecording});
+
+  final Future<void> Function() onStopRecording;
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final overlayState = ref.watch(
+      recordingViewModelProvider.select(
+        (m) => (m.session.isTouchLocked, m.session.isRecording),
+      ),
+    );
+    final (isTouchLocked, isRecording) = overlayState;
+
+    if (!isTouchLocked || !isRecording) {
+      return const SizedBox.shrink();
+    }
+
+    final viewModel = ref.read(recordingViewModelProvider.notifier);
+
+    return RecordingTouchLockOverlayWidget(
+      enabled: true,
+      onUnlocked: (intent) async {
+        viewModel.setTouchLocked(false);
+        if (intent == RecordingTouchLockUnlockIntent.stopRecording) {
+          await onStopRecording();
+        }
+      },
+    );
+  }
+}
+
+class _StartingRecordingOverlay extends ConsumerWidget {
+  const _StartingRecordingOverlay();
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final isStartingRecording = ref.watch(
+      recordingViewModelProvider.select((m) => m.session.isStartingRecording),
+    );
+
+    if (!isStartingRecording) {
+      return const SizedBox.shrink();
+    }
+
+    return RecordingLoadingOverlayWidget(
+      message: '正在开始录制…',
+      backgroundColor: Colors.black.withValues(alpha: 0.24),
+    );
+  }
+}

lib/features/recording/platform/recording_channel_names.dart

@@ -1,5 +1,5 @@
 abstract final class RecordingChannelNames {
-  static const packageName = 'com.qxy.dronex';
+  static const packageName = 'com.dronex.rec';
   static const method = '$packageName/recording';
   static const events = '$packageName/recording_events';
 }

lib/features/recording/platform/recording_platform.dart

@@ -2,7 +2,7 @@ import 'dart:async';
 import 'dart:io';
 
 import 'package:flutter/services.dart';
-import 'package:recording_tool/features/recording/recording_channel_names.dart';
+import 'package:recording_tool/features/recording/platform/recording_channel_names.dart';
 
 enum RecordingState {
   idle,
@@ -81,6 +81,21 @@ class RecordingPlatform {
     return RecordingStatus.fromMap(result ?? const {});
   }
 
+  static Future<RecordingZoomCapabilities> getZoomCapabilities() async {
+    final result = await _channel.invokeMapMethod<String, dynamic>(
+      'getZoomCapabilities',
+    );
+    return RecordingZoomCapabilities.fromMap(result);
+  }
+
+  static Future<RecordingZoomCapabilities> setZoomRatio(double ratio) async {
+    final result = await _channel.invokeMapMethod<String, dynamic>(
+      'setZoomRatio',
+      <String, dynamic>{'zoomRatio': ratio},
+    );
+    return RecordingZoomCapabilities.fromMap(result);
+  }
+
   static Future<RecordingStartResult> startRecording({
     bool withAudio = true,
     bool enableDoNotDisturb = true,
@@ -156,6 +171,29 @@ class RecordingPlatform {
   }
 }
 
+class RecordingZoomCapabilities {
+  const RecordingZoomCapabilities({
+    required this.zoomRatio,
+    required this.minZoomRatio,
+    required this.maxZoomRatio,
+  });
+
+  final double zoomRatio;
+  final double minZoomRatio;
+  final double maxZoomRatio;
+
+  factory RecordingZoomCapabilities.fromMap(Map<String, dynamic>? map) {
+    final minZoomRatio = (map?['minZoomRatio'] as num?)?.toDouble() ?? 1.0;
+    final maxZoomRatio = (map?['maxZoomRatio'] as num?)?.toDouble() ?? 3.0;
+    final zoomRatio = (map?['zoomRatio'] as num?)?.toDouble() ?? minZoomRatio;
+    return RecordingZoomCapabilities(
+      zoomRatio: zoomRatio.clamp(minZoomRatio, maxZoomRatio).toDouble(),
+      minZoomRatio: minZoomRatio,
+      maxZoomRatio: maxZoomRatio,
+    );
+  }
+}
+
 class RecordingStartResult {
   const RecordingStartResult({this.outputPath, required this.status});
 
@@ -167,14 +205,14 @@ class RecordingStopResult {
   const RecordingStopResult({
     this.outputPath,
     required this.status,
-    this.gallerySaved = true,
+    this.fileSaved = true,
-    this.galleryErrorMessage,
+    this.fileErrorMessage,
   });
 
   final String? outputPath;
   final RecordingStatus status;
-  final bool gallerySaved;
+  final bool fileSaved;
-  final String? galleryErrorMessage;
+  final String? fileErrorMessage;
 
   factory RecordingStopResult.fromMap(Map<String, dynamic>? result) {
     return RecordingStopResult(
@@ -182,8 +220,8 @@ class RecordingStopResult {
       status: RecordingStatus.fromMap(
         Map<dynamic, dynamic>.from(result?['status'] as Map? ?? const {}),
       ),
-      gallerySaved: result?['gallerySaved'] as bool? ?? true,
+      fileSaved: result?['fileSaved'] as bool? ?? true,
-      galleryErrorMessage: result?['galleryErrorMessage'] as String?,
+      fileErrorMessage: result?['fileErrorMessage'] as String?,
     );
   }
 }

lib/features/recording/recording_page.dart

@@ -1,676 +0,0 @@
-import 'dart:async';
-import 'dart:io';
-
-import 'package:flutter/material.dart';
-import 'package:flutter/services.dart';
-import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:flutter_screenutil/flutter_screenutil.dart';
-import 'package:permission_handler/permission_handler.dart';
-import 'package:recording_tool/core/platform/app_platform_info.dart';
-import 'package:recording_tool/core/platform/device_health_checker.dart';
-import 'package:recording_tool/core/utils/date_time_formatter.dart';
-import 'package:recording_tool/features/recording/model/model_recording.dart';
-import 'package:recording_tool/features/recording/recording_display_name.dart';
-import 'package:recording_tool/features/recording/recording_platform.dart';
-import 'package:recording_tool/features/recording/recording_session_controller.dart';
-import 'package:recording_tool/features/recording/view-model/view_model_recording.dart';
-import 'package:recording_tool/features/recording/widgets/camera_preview_widget.dart';
-import 'package:recording_tool/features/recording/widgets/recording_saved_dialog.dart';
-import 'package:recording_tool/features/recording/widgets/recording_touch_lock_overlay.dart';
-import 'package:recording_tool/shared/widgets/widgets.dart';
-
-class RecordingPage extends ConsumerStatefulWidget {
-  const RecordingPage({super.key});
-
-  @override
-  ConsumerState<RecordingPage> createState() => _RecordingPageState();
-}
-
-class _RecordingPageState extends ConsumerState<RecordingPage> {
-  var _immersiveApplied = false;
-
-  @override
-  void initState() {
-    super.initState();
-    WidgetsBinding.instance.addPostFrameCallback((_) => _bootstrap());
-  }
-
-  Future<void> _checkAndShowDeviceHealthAlerts() async {
-    final snapshot = await AppPlatformInfo.deviceHealth();
-    if (!mounted) return;
-
-    final lines = DeviceHealthChecker.warningLines(snapshot);
-    if (lines.isEmpty) return;
-
-    await AppDialog.deviceHealthAlert(context, lines: lines);
-  }
-
-  Future<void> _bootstrap() async {
-    await _checkAndShowDeviceHealthAlerts();
-    if (!mounted) return;
-
-    final clipboardResult = await ref
-        .read(recordingViewModelProvider.notifier)
-        .getClipboardContent();
-    if (!mounted) return;
-    if (clipboardResult == ClipboardReadResult.invalid) {
-      AppToast.show('无选手信息');
-    }
-    await _enterRecordingMode();
-    // Allow PlatformView to attach before binding CameraX preview.
-    await Future<void>.delayed(const Duration(milliseconds: 400));
-    if (!mounted) return;
-    await ref
-        .read(recordingSessionControllerProvider.notifier)
-        .prepareSession();
-  }
-
-  Future<void> _enterRecordingMode() async {
-    if (!Platform.isAndroid) return;
-    await SystemChrome.setEnabledSystemUIMode(SystemUiMode.immersiveSticky);
-    await RecordingPlatform.setImmersiveMode(enabled: true);
-    _immersiveApplied = true;
-  }
-
-  String _savedDialogSessionTitle(
-    RecordingModel recordingInfo,
-    String? savedName,
-  ) {
-    final clipboard = recordingInfo.clipboardRecordingModel;
-    if (recordingInfo.hasValidClipboardInfo &&
-        clipboard.title.trim().isNotEmpty) {
-      return clipboard.title.trim();
-    }
-    if (savedName != null && savedName.isNotEmpty) {
-      return resolveRecordingDisplayName(savedName);
-    }
-    return '录制完成';
-  }
-
-  Future<void> _showNoPlayerInfoDialog() {
-    return showDialog<void>(
-      context: context,
-      builder: (dialogContext) {
-        return AlertDialog(
-          content: const Text('无选手信息'),
-          actions: [
-            TextButton(
-              onPressed: () => Navigator.of(dialogContext).pop(),
-              child: const Text('确定'),
-            ),
-          ],
-        );
-      },
-    );
-  }
-
-  Future<void> _onStartRecording() async {
-    final recordingInfo = ref.read(recordingViewModelProvider);
-    if (!recordingInfo.hasClipboardFilename) {
-      await _showNoPlayerInfoDialog();
-      return;
-    }
-    await _checkAndShowDeviceHealthAlerts();
-    if (!mounted) return;
-    await ref.read(recordingSessionControllerProvider.notifier).startRecording();
-  }
-
-  void _clearClipboardForNewRound() {
-    ref.read(recordingViewModelProvider.notifier).resetClipboardInfo();
-    ref
-        .read(recordingSessionControllerProvider.notifier)
-        .clearSavedRecordingResult();
-  }
-
-  Future<void> _showRecordingSavedDialogIfNeeded() async {
-    final session = ref.read(recordingSessionControllerProvider);
-    if (session.lastSavedDisplayName == null || session.gallerySaveFailed) {
-      return;
-    }
-
-    final recordingInfo = ref.read(recordingViewModelProvider);
-    final sessionTitle = _savedDialogSessionTitle(
-      recordingInfo,
-      session.lastSavedDisplayName,
-    );
-
-    await showRecordingSavedDialog(
-      context,
-      sessionTitle: sessionTitle,
-      onContinueRound: () {
-        ref
-            .read(recordingSessionControllerProvider.notifier)
-            .clearSavedRecordingResult();
-      },
-      onRecordNewRound: _clearClipboardForNewRound,
-    );
-  }
-
-  Future<void> _exitRecordingMode() async {
-    if (!_immersiveApplied) return;
-    await ref.read(recordingSessionControllerProvider.notifier).teardown();
-    await SystemChrome.setEnabledSystemUIMode(
-      SystemUiMode.manual,
-      overlays: SystemUiOverlay.values,
-    );
-    await RecordingPlatform.setImmersiveMode(enabled: false);
-    _immersiveApplied = false;
-  }
-
-  @override
-  void dispose() {
-    if (_immersiveApplied) {
-      SystemChrome.setEnabledSystemUIMode(
-        SystemUiMode.manual,
-        overlays: SystemUiOverlay.values,
-      );
-      RecordingPlatform.setImmersiveMode(enabled: false);
-    }
-    super.dispose();
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    final state = ref.watch(recordingSessionControllerProvider);
-    final recordingInfo = ref.watch(recordingViewModelProvider);
-    final controller = ref.read(recordingSessionControllerProvider.notifier);
-    final clipboard = recordingInfo.clipboardRecordingModel;
-    final showClipboardInfo = recordingInfo.hasValidClipboardInfo;
-
-    return PopScope(
-      canPop: !state.isRecording,
-      onPopInvokedWithResult: (didPop, result) async {
-        if (didPop) {
-          await _exitRecordingMode();
-          return;
-        }
-        if (state.isRecording) {
-          AppToast.show('录制中无法返回，请先停止录制');
-        }
-      },
-      child: Scaffold(
-        backgroundColor: Colors.black,
-        body: Stack(
-          fit: StackFit.expand,
-          children: [
-            const CameraPreviewWidget(),
-            if (!state.isPreviewReady && state.errorMessage == null)
-              const _RecordingLoadingOverlay(message: '正在启动相机…'),
-            if (state.isTouchLocked && state.isRecording)
-              RecordingTouchLockOverlay(
-                enabled: true,
-                onUnlocked: () => controller.setTouchLocked(false),
-              ),
-            _RecordingHud(
-              state: state,
-              eventTitle: showClipboardInfo ? clipboard.title : null,
-              eventAddress: showClipboardInfo ? clipboard.address : null,
-              showClipboardHint: showClipboardInfo,
-              clipboardAddress: clipboard.address.trim(),
-              onClearEventInfo: _clearClipboardForNewRound,
-              onPasteEventInfo: () async {
-                final result = await ref
-                    .read(recordingViewModelProvider.notifier)
-                    .getClipboardContent();
-                if (!context.mounted) return;
-                if (result != ClipboardReadResult.success) {
-                  AppToast.show('无赛事信息');
-                }
-              },
-              onStart: _onStartRecording,
-              onStop: () async {
-                await controller.stopRecording();
-                if (!context.mounted) return;
-                final latest = ref.read(recordingSessionControllerProvider);
-                if (latest.gallerySaveFailed) {
-                  AppToast.show(latest.errorMessage ?? '保存到相册失败，请开启相册权限');
-                  return;
-                }
-                await _showRecordingSavedDialogIfNeeded();
-              },
-              onOpenDnd: () async {
-                await controller.openDndSettings();
-                await controller.refreshDndAccess();
-              },
-              onOpenBattery: () async {
-                await controller.openBatterySettings();
-                await controller.refreshBatteryOptimization();
-              },
-              onToggleTouchLock: () {
-                controller.setTouchLocked(!state.isTouchLocked);
-              },
-            ),
-            if (state.isStartingRecording)
-              const _RecordingLoadingOverlay(message: '正在开始录制…'),
-          ],
-        ),
-      ),
-    );
-  }
-}
-
-class _RecordingLoadingOverlay extends StatelessWidget {
-  const _RecordingLoadingOverlay({required this.message});
-
-  final String message;
-
-  @override
-  Widget build(BuildContext context) {
-    return ColoredBox(
-      color: Colors.black,
-      child: Center(
-        child: Column(
-          mainAxisSize: MainAxisSize.min,
-          children: [
-            SizedBox.square(
-              dimension: 32.r,
-              child: CircularProgressIndicator(
-                strokeWidth: 2.5.r,
-                color: Colors.white70,
-              ),
-            ),
-            SizedBox(height: 14.h),
-            Text(
-              message,
-              style: TextStyle(color: Colors.white70, fontSize: 14.sp),
-            ),
-          ],
-        ),
-      ),
-    );
-  }
-}
-
-class _RecordingHud extends StatelessWidget {
-  const _RecordingHud({
-    required this.state,
-    this.eventTitle,
-    this.eventAddress,
-    this.showClipboardHint = false,
-    this.clipboardAddress = '',
-    required this.onClearEventInfo,
-    required this.onPasteEventInfo,
-    required this.onStart,
-    required this.onStop,
-    required this.onOpenDnd,
-    required this.onOpenBattery,
-    required this.onToggleTouchLock,
-  });
-
-  final RecordingSessionState state;
-  final String? eventTitle;
-  final String? eventAddress;
-  final bool showClipboardHint;
-  final String clipboardAddress;
-  final VoidCallback onClearEventInfo;
-  final Future<void> Function() onPasteEventInfo;
-  final Future<void> Function() onStart;
-  final Future<void> Function() onStop;
-  final VoidCallback onOpenDnd;
-  final VoidCallback onOpenBattery;
-  final VoidCallback onToggleTouchLock;
-
-  static TextStyle get _overlayTextStyle => TextStyle(
-    color: Colors.white,
-    shadows: [Shadow(color: Colors.black54, blurRadius: 6.r)],
-  );
-
-  static double get _controlSlotWidth => 48.r;
-
-  @override
-  Widget build(BuildContext context) {
-    final showPasteEventInfo = eventTitle == null && !state.isRecording;
-
-    return SafeArea(
-      child: Stack(
-        children: [
-          Column(
-            children: [
-              SizedBox(
-                height:
-                    eventTitle != null ||
-                        state.isRecording ||
-                        showPasteEventInfo
-                    ? 56.h
-                    : 8.h,
-              ),
-              const Spacer(),
-              if (state.errorMessage != null)
-                Padding(
-                  padding: EdgeInsets.all(12.r),
-                  child: Text(
-                    state.errorMessage!,
-                    style: const TextStyle(color: Colors.amber),
-                    textAlign: TextAlign.center,
-                  ),
-                ),
-              if (state.permissionWarning != null)
-                Padding(
-                  padding: EdgeInsets.symmetric(
-                    horizontal: 16.r,
-                    vertical: 8.r,
-                  ),
-                  child: Text(
-                    state.permissionWarning!,
-                    style: TextStyle(
-                      color: Colors.orangeAccent,
-                      fontSize: 12.sp,
-                    ),
-                    textAlign: TextAlign.center,
-                  ),
-                ),
-              _SetupHints(
-                hasDndAccess: state.hasDndAccess,
-                isBatteryIgnored: state.isBatteryOptimizedIgnored,
-                notificationsGranted: state.notificationsGranted,
-                showClipboardHint: showClipboardHint,
-                clipboardAddress: clipboardAddress,
-                onOpenDnd: onOpenDnd,
-                onOpenBattery: onOpenBattery,
-                onOpenNotificationSettings: openAppSettings,
-              ),
-              Padding(
-                padding: EdgeInsets.fromLTRB(24.r, 8.r, 24.r, 24.r),
-                child: Row(
-                  children: [
-                    SizedBox(
-                      width: _controlSlotWidth,
-                      height: _controlSlotWidth,
-                      child: state.isRecording
-                          ? IconButton(
-                              onPressed: onToggleTouchLock,
-                              icon: Icon(
-                                state.isTouchLocked
-                                    ? Icons.lock
-                                    : Icons.lock_open,
-                                color: Colors.white,
-                                size: 28.r,
-                              ),
-                            )
-                          : null,
-                    ),
-                    Expanded(
-                      child: Center(
-                        child: GestureDetector(
-                          onTap: state.isStartingRecording
-                              ? null
-                              : () async {
-                                  if (state.isRecording) {
-                                    await onStop();
-                                  } else {
-                                    await onStart();
-                                  }
-                                },
-                          child: Container(
-                            width: 76.w,
-                            height: 76.h,
-                            decoration: BoxDecoration(
-                              shape: BoxShape.circle,
-                              border: Border.all(
-                                color: Colors.white,
-                                width: 4.r,
-                              ),
-                              color: state.isRecording
-                                  ? Colors.white
-                                  : Colors.red,
-                            ),
-                            child: Icon(
-                              state.isRecording
-                                  ? Icons.stop
-                                  : Icons.fiber_manual_record,
-                              color: state.isRecording
-                                  ? Colors.red
-                                  : Colors.white,
-                              size: 36.r,
-                            ),
-                          ),
-                        ),
-                      ),
-                    ),
-                    SizedBox(
-                      width: _controlSlotWidth,
-                      height: _controlSlotWidth,
-                    ),
-                  ],
-                ),
-              ),
-            ],
-          ),
-          if (showPasteEventInfo)
-            Positioned(
-              top: 8.r,
-              left: 12.w,
-              right: 12.w,
-              child: Center(
-                child: TextButton.icon(
-                  onPressed: onPasteEventInfo,
-                  icon: Icon(Icons.content_paste, size: 18.r),
-                  label: const Text('粘贴赛事信息'),
-                  style: TextButton.styleFrom(
-                    foregroundColor: Colors.white,
-                    backgroundColor: Colors.black.withValues(alpha: 0.5),
-                    padding: EdgeInsets.symmetric(
-                      horizontal: 14.r,
-                      vertical: 8.r,
-                    ),
-                    shape: RoundedRectangleBorder(
-                      borderRadius: BorderRadius.circular(20.r),
-                      side: const BorderSide(color: Colors.white30),
-                    ),
-                  ),
-                ),
-              ),
-            ),
-          if (eventTitle != null)
-            Positioned(
-              top: 8.r,
-              left: 12.w,
-              right: 12.w,
-              child: Padding(
-                padding: EdgeInsets.only(right: state.isRecording ? 96.w : 0),
-                child: Row(
-                  children: [
-                    Expanded(
-                      child: Text(
-                        eventTitle!,
-                        style: _overlayTextStyle.copyWith(
-                          fontSize: 16.sp,
-                          fontWeight: FontWeight.w600,
-                        ),
-                        textAlign: TextAlign.center,
-                        maxLines: 2,
-                        overflow: TextOverflow.ellipsis,
-                      ),
-                    ),
-                    if (!state.isRecording)
-                      IconButton(
-                        onPressed: onClearEventInfo,
-                        icon: Icon(
-                          Icons.delete_outline,
-                          color: Colors.white,
-                          size: 22.r,
-                        ),
-                        padding: EdgeInsets.zero,
-                        constraints: BoxConstraints(
-                          minWidth: 40.r,
-                          minHeight: 40.r,
-                        ),
-                        tooltip: '删除',
-                      ),
-                  ],
-                ),
-              ),
-            ),
-          if (state.isRecording)
-            Positioned(
-              top: 8.r,
-              right: 12.w,
-              child: Container(
-                padding: EdgeInsets.symmetric(horizontal: 12.r, vertical: 6.r),
-                decoration: BoxDecoration(
-                  color: Colors.red,
-                  borderRadius: BorderRadius.circular(20.r),
-                ),
-                child: Text(
-                  'REC ${state.elapsedLabel}',
-                  style: const TextStyle(
-                    color: Colors.white,
-                    fontWeight: FontWeight.bold,
-                  ),
-                ),
-              ),
-            ),
-          // if (eventAddress != null && eventAddress!.isNotEmpty)
-          //   Positioned(
-          //     left: 16.w,
-          //     bottom: 108.r,
-          //     right: 120.w,
-          //     child: Text(
-          //       eventAddress!,
-          //       style: _overlayTextStyle.copyWith(
-          //         fontSize: 13.sp,
-          //         color: Colors.white70,
-          //       ),
-          //       maxLines: 2,
-          //       overflow: TextOverflow.ellipsis,
-          //     ),
-          //   ),
-        ],
-      ),
-    );
-  }
-}
-
-class _SetupHints extends StatelessWidget {
-  const _SetupHints({
-    required this.hasDndAccess,
-    required this.isBatteryIgnored,
-    required this.notificationsGranted,
-    this.showClipboardHint = false,
-    this.clipboardAddress = '',
-    required this.onOpenDnd,
-    required this.onOpenBattery,
-    required this.onOpenNotificationSettings,
-  });
-
-  final bool hasDndAccess;
-  final bool isBatteryIgnored;
-  final bool notificationsGranted;
-  final bool showClipboardHint;
-  final String clipboardAddress;
-  final VoidCallback onOpenDnd;
-  final VoidCallback onOpenBattery;
-  final VoidCallback onOpenNotificationSettings;
-
-  @override
-  Widget build(BuildContext context) {
-    final showPermissionHints =
-        !hasDndAccess || !isBatteryIgnored || !notificationsGranted;
-    final showClipboardHint = this.showClipboardHint;
-    if (!showPermissionHints && !showClipboardHint) {
-      return const SizedBox.shrink();
-    }
-
-    return Padding(
-      padding: EdgeInsets.symmetric(horizontal: 16.r, vertical: 8.r),
-      child: Column(
-        children: [
-          if (!notificationsGranted) ...[
-            _HintChip(
-              label: '开启通知权限以显示录制前台服务',
-              onTap: onOpenNotificationSettings,
-            ),
-            SizedBox(height: 8.h),
-          ],
-          if (!hasDndAccess)
-            _HintChip(label: '开启勿扰权限可减少录制中断', onTap: onOpenDnd),
-          if (!isBatteryIgnored) ...[
-            SizedBox(height: 8.h),
-            _HintChip(label: '关闭电池优化可提升息屏续录稳定性', onTap: onOpenBattery),
-          ],
-          if (showClipboardHint) ...[
-            SizedBox(height: 8.h),
-            _ClipboardAddressClockChip(address: clipboardAddress),
-          ],
-        ],
-      ),
-    );
-  }
-}
-
-class _ClipboardAddressClockChip extends StatefulWidget {
-  const _ClipboardAddressClockChip({required this.address});
-
-  final String address;
-
-  @override
-  State<_ClipboardAddressClockChip> createState() =>
-      _ClipboardAddressClockChipState();
-}
-
-class _ClipboardAddressClockChipState extends State<_ClipboardAddressClockChip> {
-  Timer? _clockTimer;
-
-  @override
-  void initState() {
-    super.initState();
-    _clockTimer = Timer.periodic(const Duration(seconds: 1), (_) {
-      if (mounted) setState(() {});
-    });
-  }
-
-  @override
-  void dispose() {
-    _clockTimer?.cancel();
-    _clockTimer = null;
-    super.dispose();
-  }
-
-  String _buildLabel() {
-    final nowText = DateTimeFormatter.format(
-      DateTime.now(),
-      pattern: 'yyyy-M-d-H:mm:ss',
-    );
-    if (widget.address.isEmpty) return nowText;
-    return '${widget.address}\n$nowText';
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    return _HintChip(label: _buildLabel(), onTap: () {});
-  }
-}
-
-class _HintChip extends StatelessWidget {
-  const _HintChip({required this.label, required this.onTap});
-
-  final String label;
-  final VoidCallback onTap;
-
-  @override
-  Widget build(BuildContext context) {
-    return GestureDetector(
-      onTap: onTap,
-      child: DecoratedBox(
-        decoration: BoxDecoration(
-          color: Colors.white12,
-          borderRadius: BorderRadius.circular(8.r),
-        ),
-        child: Padding(
-          padding: EdgeInsets.symmetric(horizontal: 12.r, vertical: 8.r),
-          child: Row(
-            children: [
-              Expanded(
-                child: Text(
-                  label,
-                  style: TextStyle(color: Colors.white70, fontSize: 12.sp),
-                ),
-              ),
-              Icon(Icons.chevron_right, color: Colors.white54, size: 18.r),
-            ],
-          ),
-        ),
-      ),
-    );
-  }
-}

lib/features/recording/recording_session_controller.dart

@@ -1,330 +0,0 @@
-import 'dart:async';
-import 'dart:io';
-
-import 'package:flutter/services.dart';
-import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:recording_tool/core/permission/permission_service.dart';
-import 'package:recording_tool/core/utils/rate_limiter.dart';
-import 'package:recording_tool/features/recording/recording_display_name.dart';
-import 'package:recording_tool/features/recording/recording_platform.dart';
-import 'package:recording_tool/features/recording/view-model/view_model_recording.dart';
-import 'package:permission_handler/permission_handler.dart';
-
-class RecordingSessionState {
-  const RecordingSessionState({
-    this.status = const RecordingStatus(state: RecordingState.idle),
-    this.isTouchLocked = true,
-    this.isPreviewReady = false,
-    this.isStartingRecording = false,
-    this.hasDndAccess = false,
-    this.isBatteryOptimizedIgnored = true,
-    this.notificationsGranted = true,
-    this.isMicrophoneGranted = false,
-    this.lastOutputPath,
-    this.lastSavedDisplayName,
-    this.errorMessage,
-    this.permissionWarning,
-    this.gallerySaveFailed = false,
-  });
-
-  final RecordingStatus status;
-  final bool isTouchLocked;
-  final bool isPreviewReady;
-  final bool isStartingRecording;
-  final bool hasDndAccess;
-  final bool isBatteryOptimizedIgnored;
-  final bool notificationsGranted;
-  final bool isMicrophoneGranted;
-  final String? lastOutputPath;
-  final String? lastSavedDisplayName;
-  final String? errorMessage;
-  final String? permissionWarning;
-  final bool gallerySaveFailed;
-
-  bool get isRecording => status.isRecording;
-
-  String get elapsedLabel {
-    final totalSeconds = status.elapsedMillis ~/ 1000;
-    final minutes = (totalSeconds ~/ 60).toString().padLeft(2, '0');
-    final seconds = (totalSeconds % 60).toString().padLeft(2, '0');
-    return '$minutes:$seconds';
-  }
-
-  RecordingSessionState copyWith({
-    RecordingStatus? status,
-    bool? isTouchLocked,
-    bool? isPreviewReady,
-    bool? isStartingRecording,
-    bool? hasDndAccess,
-    bool? isBatteryOptimizedIgnored,
-    bool? notificationsGranted,
-    bool? isMicrophoneGranted,
-    String? lastOutputPath,
-    String? lastSavedDisplayName,
-    String? errorMessage,
-    String? permissionWarning,
-    bool? gallerySaveFailed,
-    bool clearPermissionWarning = false,
-    bool clearLastSaved = false,
-  }) {
-    return RecordingSessionState(
-      status: status ?? this.status,
-      isTouchLocked: isTouchLocked ?? this.isTouchLocked,
-      isPreviewReady: isPreviewReady ?? this.isPreviewReady,
-      isStartingRecording: isStartingRecording ?? this.isStartingRecording,
-      hasDndAccess: hasDndAccess ?? this.hasDndAccess,
-      isBatteryOptimizedIgnored:
-          isBatteryOptimizedIgnored ?? this.isBatteryOptimizedIgnored,
-      notificationsGranted: notificationsGranted ?? this.notificationsGranted,
-      isMicrophoneGranted: isMicrophoneGranted ?? this.isMicrophoneGranted,
-      lastOutputPath: lastOutputPath ?? this.lastOutputPath,
-      lastSavedDisplayName: clearLastSaved
-          ? null
-          : (lastSavedDisplayName ?? this.lastSavedDisplayName),
-      errorMessage: errorMessage,
-      permissionWarning: clearPermissionWarning
-          ? null
-          : (permissionWarning ?? this.permissionWarning),
-      gallerySaveFailed: gallerySaveFailed ?? this.gallerySaveFailed,
-    );
-  }
-}
-
-final recordingSessionControllerProvider =
-    NotifierProvider<RecordingSessionController, RecordingSessionState>(
-      RecordingSessionController.new,
-    );
-
-class RecordingSessionController extends Notifier<RecordingSessionState> {
-  static const Duration _recordingActionInterval = Duration(milliseconds: 300);
-  static const Object _startRecordingThrottleKey = 'recording.session.start';
-  static const Object _stopRecordingThrottleKey = 'recording.session.stop';
-
-  StreamSubscription<RecordingStatus>? _statusSubscription;
-  final _rateLimit = RateLimitHub();
-
-  @override
-  RecordingSessionState build() {
-    ref.onDispose(_dispose);
-    return const RecordingSessionState();
-  }
-
-  Future<void> prepareSession() async {
-    if (!RecordingPlatform.isSupported) {
-      state = state.copyWith(errorMessage: '当前设备不支持录制');
-      return;
-    }
-
-    final permissions = await PermissionService.requestMissing([
-      Permission.camera,
-      Permission.microphone,
-      if (Platform.isAndroid) Permission.notification,
-      ..._galleryPermissions(),
-    ]);
-
-    final cameraGranted = permissions[Permission.camera]?.isGranted ?? false;
-    if (!cameraGranted) {
-      state = state.copyWith(errorMessage: '需要相机权限才能录制');
-      return;
-    }
-
-    final microphoneGranted =
-        permissions[Permission.microphone]?.isGranted ?? false;
-    final notificationsGranted = Platform.isAndroid
-        ? (permissions[Permission.notification]?.isGranted ?? false)
-        : true;
-
-    final warnings = <String>[];
-    if (Platform.isAndroid && !notificationsGranted) {
-      warnings.add('未授予通知权限，录制时可能看不到前台服务通知，系统更容易结束后台录制');
-    }
-    if (!microphoneGranted) {
-      warnings.add('未授予麦克风权限，当前将以静音模式录制');
-    }
-    if (!_isGalleryPermissionGranted(permissions)) {
-      warnings.add('未授予相册权限，录制结束后可能无法保存到相册');
-    }
-
-    final hasDnd = await RecordingPlatform.hasNotificationPolicyAccess();
-    final batteryIgnored =
-        await RecordingPlatform.isIgnoringBatteryOptimizations();
-
-    state = state.copyWith(
-      hasDndAccess: hasDnd,
-      isBatteryOptimizedIgnored: batteryIgnored,
-      isMicrophoneGranted: microphoneGranted,
-      notificationsGranted: notificationsGranted,
-      permissionWarning: warnings.isEmpty ? null : warnings.join('\n'),
-      errorMessage: null,
-      clearPermissionWarning: warnings.isEmpty,
-    );
-
-    await _listenStatus();
-    try {
-      final status = await _initializePreviewWithRetry();
-      state = state.copyWith(
-        status: status,
-        isPreviewReady: status.state == RecordingState.previewing,
-        errorMessage: status.state == RecordingState.previewing
-            ? null
-            : (status.message ?? '相机预览初始化失败'),
-      );
-    } on PlatformException catch (error) {
-      state = state.copyWith(
-        isPreviewReady: false,
-        errorMessage: error.message ?? '相机预览初始化失败',
-      );
-    }
-  }
-
-  Future<RecordingStatus> _initializePreviewWithRetry() async {
-    const maxAttempts = 8;
-    for (var attempt = 0; attempt < maxAttempts; attempt++) {
-      try {
-        return await RecordingPlatform.initializePreview();
-      } on PlatformException catch (error) {
-        final shouldRetry =
-            error.code == 'NO_PREVIEW' && attempt < maxAttempts - 1;
-        if (!shouldRetry) {
-          rethrow;
-        }
-        await Future<void>.delayed(Duration(milliseconds: 150 * (attempt + 1)));
-      }
-    }
-    throw StateError('initializePreview retry exhausted');
-  }
-
-  List<Permission> _galleryPermissions() {
-    if (Platform.isIOS) {
-      return [Permission.photosAddOnly, Permission.photos];
-    }
-    if (Platform.isAndroid) {
-      return [Permission.videos, Permission.storage];
-    }
-    return const [];
-  }
-
-  bool _isGalleryPermissionGranted(Map<Permission, PermissionStatus> permissions) {
-    for (final permission in _galleryPermissions()) {
-      if (permissions[permission]?.isGranted ?? false) {
-        return true;
-      }
-    }
-    return _galleryPermissions().isEmpty;
-  }
-
-  bool _tryAcquireRecordingAction(Object key) {
-    var executed = false;
-    _rateLimit.throttle<void>(
-      key: key,
-      value: null,
-      duration: _recordingActionInterval,
-      options: const ThrottleOptions(leading: true, trailing: false),
-      onCallback: (_) => executed = true,
-    );
-    return executed;
-  }
-
-  Future<void> startRecording({bool enableDoNotDisturb = true}) async {
-    if (!_tryAcquireRecordingAction(_startRecordingThrottleKey)) return;
-
-    if (!state.isPreviewReady ||
-        state.isRecording ||
-        state.isStartingRecording) {
-      return;
-    }
-
-    final clipboard = ref.read(recordingViewModelProvider).clipboardRecordingModel;
-    final displayName = recordingFileNameForPlatform(clipboard.filename);
-
-    state = state.copyWith(isStartingRecording: true, errorMessage: null);
-    try {
-      final result = await RecordingPlatform.startRecording(
-        enableDoNotDisturb: enableDoNotDisturb && state.hasDndAccess,
-        displayName: displayName,
-      );
-      state = state.copyWith(
-        status: result.status,
-        lastOutputPath: result.outputPath,
-        isTouchLocked: true,
-        errorMessage: null,
-        gallerySaveFailed: false,
-        clearLastSaved: true,
-      );
-    } on PlatformException catch (error) {
-      state = state.copyWith(errorMessage: error.message ?? '开始录制失败');
-    } finally {
-      state = state.copyWith(isStartingRecording: false);
-    }
-  }
-
-  Future<void> stopRecording() async {
-    if (!_tryAcquireRecordingAction(_stopRecordingThrottleKey)) return;
-
-    if (!state.isRecording) return;
-
-    try {
-      final result = await RecordingPlatform.stopRecording();
-      final galleryFailed = !result.gallerySaved;
-      final savedName = recordingFileNameForPlatform(
-        ref.read(recordingViewModelProvider).clipboardRecordingModel.filename,
-      );
-      state = state.copyWith(
-        status: result.status,
-        lastOutputPath: result.outputPath ?? state.lastOutputPath,
-        lastSavedDisplayName: galleryFailed ? null : savedName,
-        errorMessage: galleryFailed
-            ? (result.galleryErrorMessage ?? '保存到相册失败，请开启相册权限')
-            : null,
-        gallerySaveFailed: galleryFailed,
-      );
-    } on PlatformException catch (error) {
-      state = state.copyWith(errorMessage: error.message ?? '停止录制失败');
-    }
-  }
-
-  void setTouchLocked(bool locked) {
-    state = state.copyWith(isTouchLocked: locked);
-  }
-
-  void clearSavedRecordingResult() {
-    state = state.copyWith(clearLastSaved: true);
-  }
-
-  Future<void> openDndSettings() =>
-      RecordingPlatform.openNotificationPolicySettings();
-
-  Future<void> refreshDndAccess() async {
-    final hasDnd = await RecordingPlatform.hasNotificationPolicyAccess();
-    state = state.copyWith(hasDndAccess: hasDnd);
-  }
-
-  Future<void> openBatterySettings() =>
-      RecordingPlatform.openBatteryOptimizationSettings();
-
-  Future<void> refreshBatteryOptimization() async {
-    final ignored = await RecordingPlatform.isIgnoringBatteryOptimizations();
-    state = state.copyWith(isBatteryOptimizedIgnored: ignored);
-  }
-
-  Future<void> teardown() async {
-    await RecordingPlatform.setImmersiveMode(enabled: false);
-    await RecordingPlatform.disableDoNotDisturb();
-    await RecordingPlatform.disposePreview();
-    await _statusSubscription?.cancel();
-    _statusSubscription = null;
-    state = const RecordingSessionState();
-  }
-
-  Future<void> _listenStatus() async {
-    await _statusSubscription?.cancel();
-    _statusSubscription = RecordingPlatform.statusStream().listen((status) {
-      state = state.copyWith(status: status);
-    });
-  }
-
-  Future<void> _dispose() async {
-    _rateLimit.clear();
-    await _statusSubscription?.cancel();
-  }
-}

lib/features/recording/view-model/view_model_recording.dart

@@ -1,16 +1,24 @@
+import 'dart:async';
 import 'dart:convert';
+import 'dart:io';
 
 import 'package:flutter/services.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:flutter_riverpod/legacy.dart';
+import 'package:permission_handler/permission_handler.dart';
 import 'package:recording_tool/core/logging/app_logger.dart';
+import 'package:recording_tool/core/permission/permission_service.dart';
+import 'package:recording_tool/core/platform/app_platform_info.dart';
 import 'package:recording_tool/features/recording/model/model_clipboard.dart';
 import 'package:recording_tool/features/recording/model/model_recording.dart';
+import 'package:recording_tool/features/recording/model/model_recording_session.dart';
+import 'package:recording_tool/features/recording/platform/recording_platform.dart';
+import 'package:recording_tool/features/recording/utils/recording_display_name.dart';
 
+/// 录制页状态 Provider。
 final recordingViewModelProvider =
-    StateNotifierProvider<RecordingViewModel, RecordingModel>((ref) {
+    NotifierProvider<RecordingViewModel, RecordingModel>(
-      return RecordingViewModel(ref);
+      RecordingViewModel.new,
-    });
+    );
 
 /// 剪切板读取结果，供 UI 决定是否提示用户。
 enum ClipboardReadResult {
@@ -24,24 +32,60 @@ enum ClipboardReadResult {
   invalid,
 }
 
-class RecordingViewModel extends StateNotifier<RecordingModel> {
+List<Permission> recordingFileSavePermissionsForHost({
-  RecordingViewModel(this.ref)
+  required bool isIOS,
-    : super(
+  required bool isAndroid,
-        RecordingModel(
+  int? androidSdkInt,
-          clipboardRecordingModel: ClipboardRecordingModel(
+}) {
-            title: '',
+  if (isIOS) {
-            address: '',
+    return const [];
-          ),
+  }
-        ),
+  if (isAndroid) {
-      );
+    if (androidSdkInt != null && androidSdkInt >= 29) {
-  final Ref ref;
+      return const [];
+    }
+    return [Permission.storage];
+  }
+  return const [];
+}
 
+/// 开始录制所需的相机/麦克风权限检测结果。
+class RecordingRequiredPermissions {
+  const RecordingRequiredPermissions({
+    required this.cameraGranted,
+    required this.microphoneGranted,
+  });
+
+  final bool cameraGranted;
+  final bool microphoneGranted;
+
+  bool get allGranted => cameraGranted && microphoneGranted;
+}
+
+/// 录制页 ViewModel：剪贴板、权限、相机预览与录制流程。
+class RecordingViewModel extends Notifier<RecordingModel> {
   static final _defaultClipboard = ClipboardRecordingModel(
     title: '',
     address: '',
   );
 
-  /// 从剪切板获取小程序复制的录制信息。
+  StreamSubscription<RecordingStatus>? _statusSubscription;
+
+  /// 初始化状态并注册销毁回调。
+  @override
+  RecordingModel build() {
+    ref.onDispose(_dispose);
+    return RecordingModel(clipboardRecordingModel: _defaultClipboard);
+  }
+
+  /// 局部更新 session 子状态。
+  void _updateSession(
+    RecordingSessionState Function(RecordingSessionState session) update,
+  ) {
+    state = state.copyWith(session: update(state.session));
+  }
+
+  /// 读取并解析剪贴板中的小程序录制信息。
   Future<ClipboardReadResult> getClipboardContent() async {
     try {
       final clipboardData = await Clipboard.getData(Clipboard.kTextPlain);
@@ -85,14 +129,369 @@ class RecordingViewModel extends StateNotifier<RecordingModel> {
     }
   }
 
+  /// 清空剪贴板赛事信息（供 UI 调用）。
   void resetClipboardInfo() {
     _resetClipboardInfo();
   }
 
+  /// 重置剪贴板赛事信息为默认空值。
   void _resetClipboardInfo() {
     state = state.copyWith(
       clipboardRecordingModel: _defaultClipboard,
       hasValidClipboardInfo: false,
     );
   }
+
+  /// 申请权限、检查系统设置并初始化相机预览。
+  Future<void> prepareSession() async {
+    if (!RecordingPlatform.isSupported) {
+      _updateSession((s) => s.copyWith(errorMessage: '当前设备不支持录制'));
+      return;
+    }
+
+    final fileSavePermissions = await _fileSavePermissions();
+    final permissions = await PermissionService.requestMissing([
+      Permission.camera,
+      Permission.microphone,
+      if (Platform.isAndroid) Permission.notification,
+      ...fileSavePermissions,
+    ]);
+
+    final cameraGranted = permissions[Permission.camera]?.isGranted ?? false;
+    if (!cameraGranted) {
+      _updateSession((s) => s.copyWith(errorMessage: '需要相机权限才能录制'));
+      return;
+    }
+
+    final microphoneGranted =
+        permissions[Permission.microphone]?.isGranted ?? false;
+    final notificationsGranted = Platform.isAndroid
+        ? (permissions[Permission.notification]?.isGranted ?? false)
+        : true;
+
+    final warnings = <String>[];
+    if (Platform.isAndroid && !notificationsGranted) {
+      warnings.add('未授予通知权限，录制时可能看不到前台服务通知，系统更容易结束后台录制');
+    }
+    if (!microphoneGranted) {
+      warnings.add('未授予麦克风权限，当前将以静音模式录制');
+    }
+    if (!_isFileSavePermissionGranted(permissions, fileSavePermissions)) {
+      warnings.add('未授予文件保存权限，录制结束后可能无法保存到文件夹');
+    }
+
+    final hasDnd = await RecordingPlatform.hasNotificationPolicyAccess();
+    final batteryIgnored =
+        await RecordingPlatform.isIgnoringBatteryOptimizations();
+
+    _updateSession(
+      (s) => s.copyWith(
+        hasDndAccess: hasDnd,
+        isBatteryOptimizedIgnored: batteryIgnored,
+        isMicrophoneGranted: microphoneGranted,
+        notificationsGranted: notificationsGranted,
+        permissionWarning: warnings.isEmpty ? null : warnings.join('\n'),
+        errorMessage: null,
+        clearPermissionWarning: warnings.isEmpty,
+      ),
+    );
+
+    await _listenStatus();
+    try {
+      final status = await _initializePreviewWithRetry();
+      await _refreshZoomCapabilities();
+      _updateSession(
+        (s) => s.copyWith(
+          status: status,
+          isPreviewReady: status.state == RecordingState.previewing,
+          errorMessage: status.state == RecordingState.previewing
+              ? null
+              : (status.message ?? '相机预览初始化失败'),
+        ),
+      );
+    } on PlatformException catch (error) {
+      _updateSession(
+        (s) => s.copyWith(
+          isPreviewReady: false,
+          errorMessage: error.message ?? '相机预览初始化失败',
+        ),
+      );
+    }
+  }
+
+  /// 初始化相机预览，PlatformView 未就绪时自动重试。
+  Future<RecordingStatus> _initializePreviewWithRetry() async {
+    const maxAttempts = 8;
+    for (var attempt = 0; attempt < maxAttempts; attempt++) {
+      try {
+        return await RecordingPlatform.initializePreview();
+      } on PlatformException catch (error) {
+        final shouldRetry =
+            error.code == 'NO_PREVIEW' && attempt < maxAttempts - 1;
+        if (!shouldRetry) {
+          rethrow;
+        }
+        await Future<void>.delayed(Duration(milliseconds: 150 * (attempt + 1)));
+      }
+    }
+    throw StateError('initializePreview retry exhausted');
+  }
+
+  /// 停止录制后重新绑定相机预览，并显示加载遮罩。
+  Future<void> restorePreview() async {
+    if (!RecordingPlatform.isSupported) return;
+
+    _updateSession(
+      (s) => s.copyWith(isPreviewReady: false, errorMessage: null),
+    );
+    try {
+      final status = await _initializePreviewWithRetry();
+      await _refreshZoomCapabilities();
+      _updateSession(
+        (s) => s.copyWith(
+          status: status,
+          isPreviewReady: status.state == RecordingState.previewing,
+          errorMessage: status.state == RecordingState.previewing
+              ? null
+              : (status.message ?? '相机预览初始化失败'),
+        ),
+      );
+    } on PlatformException catch (error) {
+      _updateSession(
+        (s) => s.copyWith(
+          isPreviewReady: false,
+          errorMessage: error.message ?? '相机预览初始化失败',
+        ),
+      );
+    }
+  }
+
+  /// 当前平台所需的视频文件保存权限列表。
+  Future<List<Permission>> _fileSavePermissions() async {
+    int? androidSdkInt;
+    if (Platform.isAndroid) {
+      try {
+        androidSdkInt = int.tryParse(
+          (await AppPlatformInfo.deviceInfo()).values['sdkInt'] ?? '',
+        );
+      } on PlatformException {
+        androidSdkInt = null;
+      }
+    }
+    return recordingFileSavePermissionsForHost(
+      isIOS: Platform.isIOS,
+      isAndroid: Platform.isAndroid,
+      androidSdkInt: androidSdkInt,
+    );
+  }
+
+  /// 判断文件保存相关权限是否至少有一项已授予。
+  bool _isFileSavePermissionGranted(
+    Map<Permission, PermissionStatus> permissions,
+    List<Permission> fileSavePermissions,
+  ) {
+    for (final permission in fileSavePermissions) {
+      if (permissions[permission]?.isGranted ?? false) {
+        return true;
+      }
+    }
+    return fileSavePermissions.isEmpty;
+  }
+
+  /// 检测并尝试申请相机、麦克风权限，同步更新 session 中的 isMicrophoneGranted。
+  Future<RecordingRequiredPermissions>
+  ensureCameraAndMicrophonePermissions() async {
+    final permissions = await PermissionService.requestMissing([
+      Permission.camera,
+      Permission.microphone,
+    ]);
+
+    final cameraGranted = _isPermissionGranted(permissions[Permission.camera]);
+    final microphoneGranted = _isPermissionGranted(
+      permissions[Permission.microphone],
+    );
+
+    _updateSession((s) => s.copyWith(isMicrophoneGranted: microphoneGranted));
+
+    if (cameraGranted && !state.session.isPreviewReady) {
+      _updateSession((s) => s.copyWith(errorMessage: null));
+      await _listenStatus();
+      await restorePreview();
+    }
+
+    return RecordingRequiredPermissions(
+      cameraGranted: cameraGranted,
+      microphoneGranted: microphoneGranted,
+    );
+  }
+
+  bool _isPermissionGranted(PermissionStatus? status) {
+    return status?.isGranted == true || status?.isLimited == true;
+  }
+
+  /// 读取相机支持的倍距范围并同步当前倍距。
+  Future<void> _refreshZoomCapabilities() async {
+    try {
+      final zoom = await RecordingPlatform.getZoomCapabilities();
+      _updateSession(
+        (s) => s.copyWith(
+          zoomRatio: zoom.zoomRatio,
+          minZoomRatio: zoom.minZoomRatio,
+          maxZoomRatio: zoom.maxZoomRatio,
+          errorMessage: null,
+        ),
+      );
+    } on PlatformException catch (error) {
+      AppLogger.debug('读取相机倍距能力失败', error: error);
+    }
+  }
+
+  /// 设置相机倍距，原生层会返回设备实际应用后的倍距范围与当前值。
+  Future<void> setZoomRatio(double ratio) async {
+    final session = state.session;
+    final clamped = ratio
+        .clamp(session.minZoomRatio, session.maxZoomRatio)
+        .toDouble();
+
+    try {
+      final zoom = await RecordingPlatform.setZoomRatio(clamped);
+      _updateSession(
+        (s) => s.copyWith(
+          zoomRatio: zoom.zoomRatio,
+          minZoomRatio: zoom.minZoomRatio,
+          maxZoomRatio: zoom.maxZoomRatio,
+          errorMessage: null,
+        ),
+      );
+    } on PlatformException catch (error) {
+      _updateSession(
+        (s) => s.copyWith(errorMessage: error.message ?? '相机倍距设置失败'),
+      );
+    }
+  }
+
+  /// 开始录制，可选开启勿扰模式。
+  Future<void> startRecording({bool enableDoNotDisturb = true}) async {
+    final session = state.session;
+    if (session.isRecording || session.isStartingRecording) {
+      return;
+    }
+    if (!session.isPreviewReady) {
+      _updateSession((s) => s.copyWith(errorMessage: '相机预览未就绪，请稍后重试'));
+      return;
+    }
+
+    final displayName = recordingFileNameForPlatform(
+      state.clipboardRecordingModel.filename,
+    );
+
+    _updateSession(
+      (s) => s.copyWith(isStartingRecording: true, errorMessage: null),
+    );
+    try {
+      final result = await RecordingPlatform.startRecording(
+        enableDoNotDisturb: enableDoNotDisturb && state.session.hasDndAccess,
+        displayName: displayName,
+      );
+      _updateSession(
+        (s) => s.copyWith(
+          status: result.status,
+          lastOutputPath: result.outputPath,
+          isTouchLocked: true,
+          errorMessage: null,
+          fileSaveFailed: false,
+          clearLastSaved: true,
+        ),
+      );
+    } on PlatformException catch (error) {
+      _updateSession(
+        (s) => s.copyWith(errorMessage: error.message ?? '开始录制失败'),
+      );
+    } finally {
+      _updateSession((s) => s.copyWith(isStartingRecording: false));
+    }
+  }
+
+  /// 停止录制、保存到文件夹，并恢复相机预览。
+  Future<void> stopRecording() async {
+    if (!state.session.isRecording) return;
+
+    try {
+      final result = await RecordingPlatform.stopRecording();
+      final fileFailed = !result.fileSaved;
+      final savedName = recordingFileNameForPlatform(
+        state.clipboardRecordingModel.filename,
+      );
+      _updateSession(
+        (s) => s.copyWith(
+          status: result.status,
+          lastOutputPath: result.outputPath ?? s.lastOutputPath,
+          lastSavedDisplayName: fileFailed ? null : savedName,
+          errorMessage: fileFailed
+              ? (result.fileErrorMessage ?? '保存到文件夹失败，请检查文件保存权限')
+              : null,
+          fileSaveFailed: fileFailed,
+        ),
+      );
+    } on PlatformException catch (error) {
+      _updateSession(
+        (s) => s.copyWith(errorMessage: error.message ?? '停止录制失败'),
+      );
+    } finally {
+      await restorePreview();
+    }
+  }
+
+  /// 切换录制中触屏锁定状态。
+  void setTouchLocked(bool locked) {
+    _updateSession((s) => s.copyWith(isTouchLocked: locked));
+  }
+
+  /// 清除上次保存成功的录制结果标记。
+  void clearSavedRecordingResult() {
+    _updateSession((s) => s.copyWith(clearLastSaved: true));
+  }
+
+  /// 跳转系统勿扰/通知策略设置页。
+  Future<void> openDndSettings() =>
+      RecordingPlatform.openNotificationPolicySettings();
+
+  /// 重新检测勿扰模式权限并更新状态。
+  Future<void> refreshDndAccess() async {
+    final hasDnd = await RecordingPlatform.hasNotificationPolicyAccess();
+    _updateSession((s) => s.copyWith(hasDndAccess: hasDnd));
+  }
+
+  /// 跳转电池优化白名单设置页。
+  Future<void> openBatterySettings() =>
+      RecordingPlatform.openBatteryOptimizationSettings();
+
+  /// 重新检测是否已忽略电池优化并更新状态。
+  Future<void> refreshBatteryOptimization() async {
+    final ignored = await RecordingPlatform.isIgnoringBatteryOptimizations();
+    _updateSession((s) => s.copyWith(isBatteryOptimizedIgnored: ignored));
+  }
+
+  /// 退出录制页时释放相机、勿扰和状态订阅。
+  Future<void> teardown() async {
+    await RecordingPlatform.setImmersiveMode(enabled: false);
+    await RecordingPlatform.disableDoNotDisturb();
+    await RecordingPlatform.disposePreview();
+    await _statusSubscription?.cancel();
+    _statusSubscription = null;
+    state = state.copyWith(session: const RecordingSessionState());
+  }
+
+  /// 订阅原生层录制状态流并同步到 session。
+  Future<void> _listenStatus() async {
+    await _statusSubscription?.cancel();
+    _statusSubscription = RecordingPlatform.statusStream().listen((status) {
+      _updateSession((s) => s.copyWith(status: status));
+    });
+  }
+
+  /// Provider 销毁时取消状态流订阅。
+  Future<void> _dispose() async {
+    await _statusSubscription?.cancel();
+  }
 }

lib/features/recording/widgets/record_content_transition.dart

@@ -0,0 +1,49 @@
+import 'package:flutter/material.dart';
+
+/// 录制页内容切换时的统一过渡动画。
+class RecordContentTransition {
+  RecordContentTransition._();
+
+  static const duration = Duration(milliseconds: 600);
+
+  static Widget builder(Widget child, Animation<double> animation) {
+    final curved = CurvedAnimation(
+      parent: animation,
+      curve: Curves.easeOutCubic,
+      reverseCurve: Curves.easeInCubic,
+    );
+
+    return FadeTransition(
+      opacity: curved,
+      child: SlideTransition(
+        position: Tween<Offset>(
+          begin: const Offset(0, 0.12),
+          end: Offset.zero,
+        ).animate(curved),
+        child: child,
+      ),
+    );
+  }
+
+  static Widget stackLayoutBuilder(
+    Widget? currentChild,
+    List<Widget> previousChildren,
+  ) {
+    return Stack(
+      alignment: Alignment.center,
+      clipBehavior: Clip.none,
+      children: [...previousChildren, ?currentChild],
+    );
+  }
+
+  static Widget bottomStackLayoutBuilder(
+    Widget? currentChild,
+    List<Widget> previousChildren,
+  ) {
+    return Stack(
+      alignment: Alignment.bottomLeft,
+      clipBehavior: Clip.none,
+      children: [...previousChildren, ?currentChild],
+    );
+  }
+}

lib/features/recording/widgets/recording_saved_dialog.dart

@@ -1,120 +0,0 @@
-import 'package:flutter/material.dart';
-import 'package:flutter_screenutil/flutter_screenutil.dart';
-
-/// 录制结束并保存到相册后的后续操作弹窗。
-Future<void> showRecordingSavedDialog(
-  BuildContext context, {
-  required String sessionTitle,
-  required VoidCallback onContinueRound,
-  required VoidCallback onRecordNewRound,
-}) {
-  return showDialog<void>(
-    context: context,
-    barrierDismissible: false,
-    builder: (dialogContext) {
-      return _RecordingSavedDialog(
-        sessionTitle: sessionTitle,
-        onContinueRound: () {
-          Navigator.of(dialogContext).pop();
-          onContinueRound();
-        },
-        onRecordNewRound: () {
-          Navigator.of(dialogContext).pop();
-          onRecordNewRound();
-        },
-      );
-    },
-  );
-}
-
-class _RecordingSavedDialog extends StatelessWidget {
-  const _RecordingSavedDialog({
-    required this.sessionTitle,
-    required this.onContinueRound,
-    required this.onRecordNewRound,
-  });
-
-  final String sessionTitle;
-  final VoidCallback onContinueRound;
-  final VoidCallback onRecordNewRound;
-
-  @override
-  Widget build(BuildContext context) {
-    return Dialog(
-      backgroundColor: Colors.white,
-      shape: RoundedRectangleBorder(
-        borderRadius: BorderRadius.circular(4.r),
-        side: const BorderSide(color: Colors.black, width: 1),
-      ),
-      insetPadding: EdgeInsets.symmetric(horizontal: 32.w),
-      child: Padding(
-        padding: EdgeInsets.fromLTRB(20.w, 20.h, 20.w, 16.h),
-        child: Column(
-          mainAxisSize: MainAxisSize.min,
-          children: [
-            Text(
-              sessionTitle,
-              style: TextStyle(
-                fontSize: 15.sp,
-                fontWeight: FontWeight.w600,
-                color: Colors.black87,
-              ),
-              textAlign: TextAlign.center,
-            ),
-            SizedBox(height: 16.h),
-            Text(
-              '本轮比赛视频已保存到相册',
-              style: TextStyle(fontSize: 14.sp, color: Colors.black87),
-              textAlign: TextAlign.center,
-            ),
-            SizedBox(height: 8.h),
-            // Text(
-            //   '请选择后续录制信息',
-            //   style: TextStyle(fontSize: 14.sp, color: Colors.black87),
-            //   textAlign: TextAlign.center,
-            // ),
-            SizedBox(height: 20.h),
-            Row(
-              children: [
-                Expanded(
-                  child: _DialogActionButton(
-                    label: '继续本轮',
-                    onPressed: onContinueRound,
-                  ),
-                ),
-                SizedBox(width: 12.w),
-                Expanded(
-                  child: _DialogActionButton(
-                    label: '录制新轮',
-                    onPressed: onRecordNewRound,
-                  ),
-                ),
-              ],
-            ),
-          ],
-        ),
-      ),
-    );
-  }
-}
-
-class _DialogActionButton extends StatelessWidget {
-  const _DialogActionButton({required this.label, required this.onPressed});
-
-  final String label;
-  final VoidCallback onPressed;
-
-  @override
-  Widget build(BuildContext context) {
-    return TextButton(
-      onPressed: onPressed,
-      style: TextButton.styleFrom(
-        backgroundColor: const Color(0xFFE8E8E8),
-        foregroundColor: Colors.black87,
-        padding: EdgeInsets.symmetric(vertical: 10.h),
-        shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(6.r)),
-      ),
-      child: Text(label, style: TextStyle(fontSize: 14.sp)),
-    );
-  }
-}

lib/features/recording/widgets/recording_touch_lock_overlay.dart

@@ -1,101 +0,0 @@
-import 'dart:async';
-
-import 'package:flutter/material.dart';
-import 'package:flutter_screenutil/flutter_screenutil.dart';
-
-class RecordingTouchLockOverlay extends StatefulWidget {
-  const RecordingTouchLockOverlay({
-    super.key,
-    required this.enabled,
-    required this.onUnlocked,
-    this.unlockHoldDuration = const Duration(seconds: 2),
-  });
-
-  final bool enabled;
-  final VoidCallback onUnlocked;
-  final Duration unlockHoldDuration;
-
-  @override
-  State<RecordingTouchLockOverlay> createState() =>
-      _RecordingTouchLockOverlayState();
-}
-
-class _RecordingTouchLockOverlayState extends State<RecordingTouchLockOverlay> {
-  Timer? _holdTimer;
-  bool _isHolding = false;
-
-  @override
-  void didUpdateWidget(RecordingTouchLockOverlay oldWidget) {
-    super.didUpdateWidget(oldWidget);
-    if (!widget.enabled) {
-      _cancelHold();
-    }
-  }
-
-  @override
-  void dispose() {
-    _cancelHold();
-    super.dispose();
-  }
-
-  void _cancelHold() {
-    _holdTimer?.cancel();
-    _holdTimer = null;
-    _isHolding = false;
-  }
-
-  void _startHold() {
-    if (!widget.enabled) return;
-    setState(() => _isHolding = true);
-    _holdTimer?.cancel();
-    _holdTimer = Timer(widget.unlockHoldDuration, () {
-      if (!mounted) return;
-      _cancelHold();
-      widget.onUnlocked();
-      setState(() {});
-    });
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    if (!widget.enabled) {
-      return const SizedBox.shrink();
-    }
-
-    return Positioned.fill(
-      child: Listener(
-        behavior: HitTestBehavior.opaque,
-        onPointerDown: (_) => _startHold(),
-        onPointerUp: (_) => _cancelHold(),
-        onPointerCancel: (_) => _cancelHold(),
-        child: ColoredBox(
-          color: Colors.black.withValues(alpha: 0.01),
-          child: Align(
-            alignment: Alignment.topCenter,
-            child: Padding(
-              padding: EdgeInsets.only(top: 48.r),
-              child: DecoratedBox(
-                decoration: BoxDecoration(
-                  color: Colors.black54,
-                  borderRadius: BorderRadius.circular(24.r),
-                ),
-                child: Padding(
-                  padding: EdgeInsets.symmetric(
-                    horizontal: 16.r,
-                    vertical: 8.r,
-                  ),
-                  child: Text(
-                    _isHolding
-                        ? '保持按住 ${widget.unlockHoldDuration.inSeconds}s 解锁…'
-                        : '防误触已开启，按住 ${widget.unlockHoldDuration.inSeconds}s 解锁',
-                    style: TextStyle(color: Colors.white, fontSize: 13.sp),
-                  ),
-                ),
-              ),
-            ),
-          ),
-        ),
-      ),
-    );
-  }
-}

lib/features/recording/widgets/widget_clipboard_address_clock_chip.dart

@@ -0,0 +1,80 @@
+import 'dart:async';
+
+import 'package:flutter/material.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:recording_tool/core/utils/date_time_formatter.dart';
+import 'package:recording_tool/features/recording/widgets/record_content_transition.dart';
+
+/// 左下角实时时钟与剪贴板地址
+class ClipboardAddressClockChipWidget extends StatefulWidget {
+  const ClipboardAddressClockChipWidget({super.key, required this.address});
+
+  final String address;
+
+  @override
+  State<ClipboardAddressClockChipWidget> createState() =>
+      _ClipboardAddressClockChipWidgetState();
+}
+
+class _ClipboardAddressClockChipWidgetState
+    extends State<ClipboardAddressClockChipWidget> {
+  Timer? _clockTimer;
+
+  static TextStyle get _textStyle => TextStyle(
+    color: Colors.white,
+    fontSize: 12.sp,
+    height: 1.4,
+    shadows: [Shadow(color: Colors.black54, blurRadius: 6.r)],
+  );
+
+  @override
+  void initState() {
+    super.initState();
+    _clockTimer = Timer.periodic(const Duration(seconds: 1), (_) {
+      if (mounted) setState(() {});
+    });
+  }
+
+  @override
+  void dispose() {
+    _clockTimer?.cancel();
+    _clockTimer = null;
+    super.dispose();
+  }
+
+  String get _nowText => DateTimeFormatter.format(
+    DateTime.now(),
+    pattern: 'yyyy-M-d-H:mm:ss',
+  );
+
+  @override
+  Widget build(BuildContext context) {
+    return AnimatedSize(
+      duration: RecordContentTransition.duration,
+      curve: Curves.easeOutCubic,
+      alignment: Alignment.topLeft,
+      clipBehavior: Clip.none,
+      child: Column(
+        crossAxisAlignment: CrossAxisAlignment.start,
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          Text(_nowText, style: _textStyle),
+          AnimatedSwitcher(
+            duration: RecordContentTransition.duration,
+            switchInCurve: Curves.easeOutCubic,
+            switchOutCurve: Curves.easeInCubic,
+            layoutBuilder: RecordContentTransition.bottomStackLayoutBuilder,
+            transitionBuilder: RecordContentTransition.builder,
+            child: widget.address.isNotEmpty
+                ? Text(
+                    widget.address,
+                    key: ValueKey(widget.address),
+                    style: _textStyle,
+                  )
+                : const SizedBox.shrink(key: ValueKey('clipboard-address-empty')),
+          ),
+        ],
+      ),
+    );
+  }
+}

lib/features/recording/widgets/widget_record_footer.dart

@@ -0,0 +1,16 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+
+class RecordFooter extends StatefulWidget {
+  const RecordFooter({super.key});
+
+  @override
+  State<RecordFooter> createState() => _RecordFooterState();
+}
+
+class _RecordFooterState extends State<RecordFooter> {
+  @override
+  Widget build(BuildContext context) {
+    return SizedBox(height: 65.r, width: double.infinity);
+  }
+}

lib/features/recording/widgets/widget_record_header.dart

@@ -0,0 +1,221 @@
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:recording_tool/features/recording/widgets/record_content_transition.dart';
+import 'package:recording_tool/gen/assets.gen.dart';
+import 'package:recording_tool/shared/widgets/app_toast.dart';
+
+/// 录制页顶部：Logo、粘贴赛事、赛事标题
+class RecordHeaderWidget extends StatelessWidget {
+  const RecordHeaderWidget({
+    super.key,
+    required this.hasValidClipboardInfo,
+    this.eventTitle,
+    required this.isRecording,
+    required this.onPasteEventInfo,
+    required this.onClearEventInfo,
+  });
+
+  final bool hasValidClipboardInfo;
+  final String? eventTitle;
+  final bool isRecording;
+  final Future<void> Function() onPasteEventInfo;
+  final VoidCallback onClearEventInfo;
+
+  bool get _showPasteButtons => !hasValidClipboardInfo && !isRecording;
+
+  bool get _showEventTitle => hasValidClipboardInfo;
+
+  Widget _buildAnimatedHeaderContent() {
+    if (_showEventTitle) {
+      return _HeaderEventTitleRow(
+        key: ValueKey('title-${eventTitle ?? ''}'),
+        title: eventTitle ?? '',
+        isRecording: isRecording,
+        onClearEventInfo: onClearEventInfo,
+      );
+    }
+
+    return const SizedBox.shrink(key: ValueKey('header-empty'));
+  }
+
+  void _mockCopyEventInfo() {
+    const strTemp =
+        '{"title":"蔡依婷vs夏志豪 空中格斗赛 初中组","address":"黑龙江省鹤岗市11111","filename":"蔡依婷_夏志豪_测试循环赛-7_空中格斗赛"}';
+    Clipboard.setData(const ClipboardData(text: strTemp));
+    AppToast.show('模拟复制赛事信息成功');
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return SafeArea(
+      bottom: false,
+      child: SizedBox(
+        height: 56.h,
+        width: double.maxFinite,
+        child: Padding(
+          padding: EdgeInsets.symmetric(horizontal: 12.w),
+          child: Row(
+            children: [
+              Image.asset(
+                Assets.images.imageLogo.path,
+                width: 24.r,
+                height: 24.r,
+                fit: BoxFit.contain,
+              ),
+              Expanded(
+                child: Stack(
+                  alignment: Alignment.center,
+                  children: [
+                    AnimatedSwitcher(
+                      duration: RecordContentTransition.duration,
+                      switchInCurve: Curves.easeOutCubic,
+                      switchOutCurve: Curves.easeInCubic,
+                      layoutBuilder: RecordContentTransition.stackLayoutBuilder,
+                      transitionBuilder: RecordContentTransition.builder,
+                      child: _buildAnimatedHeaderContent(),
+                    ),
+                    if (_showPasteButtons)
+                      Align(
+                        alignment: Alignment.centerRight,
+                        child: _HeaderPasteActions(
+                          onMockCopy: _mockCopyEventInfo,
+                          onPasteEventInfo: onPasteEventInfo,
+                        ),
+                      ),
+                  ],
+                ),
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+class _HeaderEventTitleRow extends StatelessWidget {
+  const _HeaderEventTitleRow({
+    super.key,
+    required this.title,
+    required this.isRecording,
+    required this.onClearEventInfo,
+  });
+
+  final String title;
+  final bool isRecording;
+  final VoidCallback onClearEventInfo;
+
+  static TextStyle get _overlayTextStyle => TextStyle(
+    color: Colors.white,
+    shadows: [Shadow(color: Colors.black54, blurRadius: 6.r)],
+  );
+
+  @override
+  Widget build(BuildContext context) {
+    return Row(
+      mainAxisAlignment: MainAxisAlignment.center,
+      children: [
+        Expanded(
+          child: AnimatedSwitcher(
+            duration: RecordContentTransition.duration,
+            switchInCurve: Curves.easeOutCubic,
+            switchOutCurve: Curves.easeInCubic,
+            transitionBuilder: RecordContentTransition.builder,
+            child: Text(
+              title,
+              key: ValueKey(title),
+              style: _overlayTextStyle.copyWith(
+                fontSize: 12.sp,
+                fontWeight: FontWeight.w600,
+              ),
+              textAlign: TextAlign.center,
+              maxLines: 3,
+              overflow: TextOverflow.ellipsis,
+            ),
+          ),
+        ),
+        !isRecording
+            ? IconButton(
+                key: const ValueKey('clear-event-info'),
+                onPressed: onClearEventInfo,
+                icon: Assets.images.imageDelete.image(
+                  width: 15.r,
+                  height: 15.r,
+                  fit: BoxFit.contain,
+                  excludeFromSemantics: true,
+                ),
+                padding: EdgeInsets.zero,
+                constraints: BoxConstraints(minWidth: 40.r, minHeight: 40.r),
+                alignment: Alignment.centerRight,
+                tooltip: '删除',
+              )
+            : const SizedBox.shrink(key: ValueKey('clear-event-info-hidden')),
+      ],
+    );
+  }
+}
+
+class _HeaderPasteActions extends StatelessWidget {
+  const _HeaderPasteActions({
+    required this.onMockCopy,
+    required this.onPasteEventInfo,
+  });
+
+  final VoidCallback onMockCopy;
+  final Future<void> Function() onPasteEventInfo;
+
+  @override
+  Widget build(BuildContext context) {
+    return Row(
+      mainAxisAlignment: MainAxisAlignment.end,
+      children: [
+        // _HeaderActionButton(label: 'mock', onPressed: onMockCopy),
+        _HeaderActionButton(
+          label: '粘贴选手信息',
+          onPressed: () => onPasteEventInfo(),
+          icon: Assets.images.imageCopy.image(
+            width: 10.r,
+            height: 10.r,
+            fit: BoxFit.contain,
+            excludeFromSemantics: true,
+          ),
+        ),
+      ],
+    );
+  }
+}
+
+class _HeaderActionButton extends StatelessWidget {
+  const _HeaderActionButton({
+    required this.label,
+    required this.onPressed,
+    this.icon,
+  });
+
+  final String label;
+  final VoidCallback onPressed;
+  final Widget? icon;
+
+  @override
+  Widget build(BuildContext context) {
+    return TextButton.icon(
+      onPressed: onPressed,
+      icon: icon ?? Icon(Icons.content_paste, size: 10.r),
+      label: Text(label),
+
+      style: TextButton.styleFrom(
+        minimumSize: Size.zero, // 取消 40dp 最小高度
+        tapTargetSize: MaterialTapTargetSize.shrinkWrap, // 取消额外点击热区
+        foregroundColor: Colors.white,
+        backgroundColor: Colors.black.withValues(alpha: 0.5),
+        textStyle: TextStyle(fontSize: 10.sp),
+        padding: EdgeInsets.symmetric(horizontal: 7.r, vertical: 4.r),
+        shape: RoundedRectangleBorder(
+          borderRadius: BorderRadius.circular(25.r),
+          side: const BorderSide(color: Colors.white30),
+        ),
+      ),
+    );
+  }
+}

lib/features/recording/widgets/widget_record_timer.dart

@@ -0,0 +1,49 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:recording_tool/features/recording/view-model/view_model_recording.dart';
+
+class RecordTimerWidget extends ConsumerStatefulWidget {
+  const RecordTimerWidget({super.key});
+
+  @override
+  ConsumerState<RecordTimerWidget> createState() => _RecordTimerWidgetState();
+}
+
+class _RecordTimerWidgetState extends ConsumerState<RecordTimerWidget> {
+  @override
+  Widget build(BuildContext context) {
+    final timerState = ref.watch(
+      recordingViewModelProvider.select(
+        (m) => (m.session.isRecording, m.session.elapsedLabel),
+      ),
+    );
+    final (isRecording, elapsedLabel) = timerState;
+    final displayTime = isRecording ? elapsedLabel : '00:00:00';
+
+    return Positioned(
+      top: 13.r,
+      left: 0,
+      right: 0,
+      child: Center(
+        child: AnimatedContainer(
+          duration: const Duration(milliseconds: 380),
+          curve: Curves.easeOutCubic,
+          padding: EdgeInsets.symmetric(horizontal: 5.r, vertical: 0.r),
+          decoration: BoxDecoration(
+            color: isRecording ? Colors.red : Colors.transparent,
+            borderRadius: BorderRadius.circular(6.r),
+          ),
+          child: Text(
+            displayTime,
+            style: TextStyle(
+              color: Colors.white,
+              fontSize: 20.sp,
+              shadows: [Shadow(color: Colors.black54, blurRadius: 6.r)],
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+}

lib/features/recording/widgets/widget_recording_button.dart

@@ -0,0 +1,165 @@
+import 'dart:ui' show lerpDouble;
+
+import 'package:flutter/material.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+
+/// 录制控制按钮：白圈 + 红色内芯，录制中为圆角矩形。
+class RecordingControlButton extends StatefulWidget {
+  const RecordingControlButton({
+    super.key,
+    required this.isRecording,
+    required this.onTap,
+    this.isStartingRecording = false,
+    this.enabled = true,
+    this.size,
+  });
+
+  final bool isRecording;
+  final bool isStartingRecording;
+  final VoidCallback? onTap;
+  final bool enabled;
+  final double? size;
+
+  @override
+  State<RecordingControlButton> createState() => _RecordingControlButtonState();
+}
+
+class _RecordingControlButtonState extends State<RecordingControlButton>
+    with TickerProviderStateMixin {
+  static const _morphDuration = Duration(milliseconds: 380);
+  static const _pressDownDuration = Duration(milliseconds: 120);
+  static const _pressUpDuration = Duration(milliseconds: 180);
+
+  late final AnimationController _morphController;
+  late final AnimationController _pressController;
+  late final CurvedAnimation _morphAnimation;
+  late final Animation<double> _pressScale;
+
+  bool get _targetIsRecording =>
+      widget.isRecording || widget.isStartingRecording;
+
+  @override
+  void initState() {
+    super.initState();
+    _morphController = AnimationController(
+      vsync: this,
+      duration: _morphDuration,
+      value: _targetIsRecording ? 1 : 0,
+    );
+    _morphAnimation = CurvedAnimation(
+      parent: _morphController,
+      curve: Curves.easeOutCubic,
+      reverseCurve: Curves.easeInCubic,
+    );
+    _pressController = AnimationController(
+      vsync: this,
+      duration: _pressDownDuration,
+    );
+    _pressScale = Tween<double>(begin: 1, end: 0.94).animate(
+      CurvedAnimation(
+        parent: _pressController,
+        curve: Curves.easeOut,
+        reverseCurve: Curves.easeOutBack,
+      ),
+    );
+  }
+
+  @override
+  void didUpdateWidget(covariant RecordingControlButton oldWidget) {
+    super.didUpdateWidget(oldWidget);
+    final oldTarget =
+        oldWidget.isRecording || oldWidget.isStartingRecording;
+    final newTarget = _targetIsRecording;
+    if (oldTarget != newTarget) {
+      if (newTarget) {
+        _morphController.forward();
+      } else {
+        _morphController.reverse();
+      }
+    }
+  }
+
+  @override
+  void dispose() {
+    _morphAnimation.dispose();
+    _morphController.dispose();
+    _pressController.dispose();
+    super.dispose();
+  }
+
+  void _handlePressDown() {
+    if (!widget.enabled) return;
+    _pressController.duration = _pressDownDuration;
+    _pressController.forward();
+  }
+
+  void _handlePressUp() {
+    if (!widget.enabled) return;
+    _pressController.duration = _pressUpDuration;
+    _pressController.reverse();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final buttonSize = widget.size ?? 70.r;
+    final borderWidth = 4.r;
+    final idleInnerSize = 62.r;
+    final recordingInnerSize = 22.r;
+    final idleCornerRadius = idleInnerSize / 2;
+    final recordingCornerRadius = 6.r;
+
+    return GestureDetector(
+      behavior: HitTestBehavior.opaque,
+      onTapDown: (_) => _handlePressDown(),
+      onTapUp: (_) => _handlePressUp(),
+      onTapCancel: _handlePressUp,
+      onTap: widget.enabled ? widget.onTap : null,
+      child: AnimatedBuilder(
+        animation: Listenable.merge([_morphController, _pressController]),
+        builder: (context, child) {
+          final morph = _morphAnimation.value;
+
+          final innerSize = lerpDouble(
+            idleInnerSize,
+            recordingInnerSize,
+            morph,
+          )!;
+          final cornerRadius = lerpDouble(
+            idleCornerRadius,
+            recordingCornerRadius,
+            morph,
+          )!;
+
+          return Transform.scale(
+            scale: _pressScale.value,
+            child: SizedBox(
+              width: buttonSize,
+              height: buttonSize,
+              child: Stack(
+                alignment: Alignment.center,
+                children: [
+                  Container(
+                    width: buttonSize,
+                    height: buttonSize,
+                    decoration: BoxDecoration(
+                      shape: BoxShape.circle,
+                      border: Border.all(color: Colors.white, width: borderWidth),
+                    ),
+                  ),
+                  Container(
+                    width: innerSize,
+                    height: innerSize,
+                    decoration: BoxDecoration(
+                      color: Colors.red,
+                      borderRadius: BorderRadius.circular(cornerRadius),
+                    ),
+                  ),
+                ],
+              ),
+            ),
+          );
+        },
+      ),
+    );
+  }
+}

lib/features/recording/widgets/widget_recording_hint_chip.dart

@@ -0,0 +1,42 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+
+/// 可点击的提示条组件
+class RecordingHintChipWidget extends StatelessWidget {
+  const RecordingHintChipWidget({
+    super.key,
+    required this.label,
+    required this.onTap,
+  });
+
+  final String label;
+  final VoidCallback onTap;
+
+  @override
+  /// 构建提示条 UI
+  Widget build(BuildContext context) {
+    return GestureDetector(
+      onTap: onTap,
+      child: DecoratedBox(
+        decoration: BoxDecoration(
+          color: Colors.white12,
+          borderRadius: BorderRadius.circular(8.r),
+        ),
+        child: Padding(
+          padding: EdgeInsets.symmetric(horizontal: 12.r, vertical: 8.r),
+          child: Row(
+            children: [
+              Expanded(
+                child: Text(
+                  label,
+                  style: TextStyle(color: Colors.white70, fontSize: 12.sp),
+                ),
+              ),
+              Icon(Icons.chevron_right, color: Colors.white54, size: 18.r),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}

lib/features/recording/widgets/widget_recording_hud.dart

@@ -0,0 +1,323 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:permission_handler/permission_handler.dart';
+import 'package:recording_tool/core/utils/rate_limiter.dart';
+import 'package:recording_tool/features/recording/widgets/record_content_transition.dart';
+import 'package:recording_tool/features/recording/widgets/widget_clipboard_address_clock_chip.dart';
+import 'package:recording_tool/features/recording/widgets/widget_recording_button.dart';
+import 'package:recording_tool/features/recording/widgets/widget_recording_setup_hints.dart';
+
+/// 录制页 HUD 层（状态提示、录制控制）
+class RecordingHudWidget extends StatelessWidget {
+  const RecordingHudWidget({
+    super.key,
+    this.errorMessage,
+    this.permissionWarning,
+    required this.hasDndAccess,
+    required this.isBatteryOptimizedIgnored,
+    required this.notificationsGranted,
+    required this.isRecording,
+    required this.isStartingRecording,
+    required this.isTouchLocked,
+    this.showClipboardHint = false,
+    this.clipboardAddress = '',
+    required this.zoomRatio,
+    required this.minZoomRatio,
+    required this.maxZoomRatio,
+    required this.onStart,
+    required this.onStop,
+    required this.onOpenDnd,
+    required this.onOpenBattery,
+    required this.onToggleTouchLock,
+    required this.onZoomSelected,
+  });
+
+  final String? errorMessage;
+  final String? permissionWarning;
+  final bool hasDndAccess;
+  final bool isBatteryOptimizedIgnored;
+  final bool notificationsGranted;
+  final bool isRecording;
+  final bool isStartingRecording;
+  final bool isTouchLocked;
+  final bool showClipboardHint;
+  final String clipboardAddress;
+  final double zoomRatio;
+  final double minZoomRatio;
+  final double maxZoomRatio;
+  final Future<void> Function() onStart;
+  final Future<void> Function() onStop;
+  final VoidCallback onOpenDnd;
+  final VoidCallback onOpenBattery;
+  final VoidCallback onToggleTouchLock;
+  final ValueChanged<double> onZoomSelected;
+
+  static double get _recordButtonSize => 70.r;
+  static double get _recordButtonBottom => 63.r;
+  static double get _overlayInfoLeft => 13.r;
+  static double get _overlayInfoBottom => 10.r;
+  static const List<double> _zoomPresets = [0.6, 1.0];
+
+  @override
+  Widget build(BuildContext context) {
+    return Stack(
+      fit: StackFit.expand,
+      children: [
+        Positioned(
+          left: 0,
+          right: 0,
+          top: 0,
+          bottom: _recordButtonBottom + _recordButtonSize + 16.h,
+          child: Column(
+            children: [
+              SizedBox(height: 8.h),
+              const Spacer(),
+              if (errorMessage != null)
+                Padding(
+                  padding: EdgeInsets.all(12.r),
+                  child: Text(
+                    errorMessage!,
+                    style: const TextStyle(color: Colors.amber),
+                    textAlign: TextAlign.center,
+                  ),
+                ),
+              if (permissionWarning != null)
+                Padding(
+                  padding: EdgeInsets.symmetric(
+                    horizontal: 16.r,
+                    vertical: 8.r,
+                  ),
+                  child: Text(
+                    permissionWarning!,
+                    style: TextStyle(
+                      color: Colors.orangeAccent,
+                      fontSize: 12.sp,
+                    ),
+                    textAlign: TextAlign.center,
+                  ),
+                ),
+              RecordingSetupHintsWidget(
+                hasDndAccess: hasDndAccess,
+                isBatteryIgnored: isBatteryOptimizedIgnored,
+                notificationsGranted: notificationsGranted,
+                onOpenDnd: onOpenDnd,
+                onOpenBattery: onOpenBattery,
+                onOpenNotificationSettings: openAppSettings,
+              ),
+            ],
+          ),
+        ),
+        Positioned(
+          left: _overlayInfoLeft,
+          bottom: _overlayInfoBottom,
+          child: AnimatedSwitcher(
+            duration: RecordContentTransition.duration,
+            switchInCurve: Curves.easeOutCubic,
+            switchOutCurve: Curves.easeInCubic,
+            layoutBuilder: RecordContentTransition.bottomStackLayoutBuilder,
+            transitionBuilder: RecordContentTransition.builder,
+            child: showClipboardHint
+                ? ClipboardAddressClockChipWidget(
+                    key: const ValueKey('clipboard-info'),
+                    address: clipboardAddress,
+                  )
+                : const SizedBox.shrink(key: ValueKey('clipboard-info-hidden')),
+          ),
+        ),
+        if (isRecording)
+          Positioned(
+            left: 16.r,
+            bottom: _recordButtonBottom,
+            child: SizedBox(
+              height: _recordButtonSize,
+              child: Center(
+                child: IconButton(
+                  onPressed: onToggleTouchLock,
+                  icon: Icon(
+                    isTouchLocked ? Icons.lock : Icons.lock_open,
+                    color: Colors.white,
+                    size: 28.r,
+                  ),
+                ),
+              ),
+            ),
+          ),
+        Positioned(
+          right: 16.r,
+          bottom: _recordButtonBottom + _recordButtonSize + 14.h,
+          child: _ZoomPresetControl(
+            isRecording: isRecording,
+            zoomRatio: zoomRatio,
+            minZoomRatio: minZoomRatio,
+            maxZoomRatio: maxZoomRatio,
+            presets: _zoomPresets,
+            onSelected: onZoomSelected,
+          ),
+        ),
+        Positioned(
+          left: 0,
+          right: 0,
+          bottom: _recordButtonBottom,
+          child: Center(
+            child: RecordingControlButton(
+              isRecording: isRecording,
+              isStartingRecording: isStartingRecording,
+              enabled: !isStartingRecording,
+              size: _recordButtonSize,
+              onTap: () {
+                if (isRecording) {
+                  RateLimit.instance.debounce<void>(
+                    key: 'recording.session.stop',
+                    value: null,
+                    duration: Duration(milliseconds: 300),
+                    onCallback: (_) async {
+                      await onStop();
+                    },
+                  );
+                } else {
+                  RateLimit.instance.debounce<void>(
+                    key: 'recording.session.start',
+                    value: null,
+                    duration: Duration(milliseconds: 300),
+                    onCallback: (_) async {
+                      await onStart();
+                    },
+                  );
+                }
+              },
+            ),
+          ),
+        ),
+      ],
+    );
+  }
+}
+
+class _ZoomPresetControl extends StatelessWidget {
+  const _ZoomPresetControl({
+    required this.isRecording,
+    required this.zoomRatio,
+    required this.minZoomRatio,
+    required this.maxZoomRatio,
+    required this.presets,
+    required this.onSelected,
+  });
+
+  final bool isRecording;
+  final double zoomRatio;
+  final double minZoomRatio;
+  final double maxZoomRatio;
+  final List<double> presets;
+  final ValueChanged<double> onSelected;
+
+  @override
+  Widget build(BuildContext context) {
+    final availablePresets = presets
+        .where(_isPresetAvailable)
+        .toList(growable: false);
+
+    if (availablePresets.isEmpty) {
+      return const SizedBox.shrink();
+    }
+
+    return DecoratedBox(
+      decoration: BoxDecoration(
+        color: Colors.black.withValues(alpha: 0.46),
+        borderRadius: BorderRadius.circular(18.r),
+        border: Border.all(color: Colors.white.withValues(alpha: 0.18)),
+      ),
+      child: Padding(
+        padding: EdgeInsets.all(3.r),
+        child: Row(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            for (final preset in availablePresets)
+              _ZoomPresetButton(
+                displayRatio: preset,
+                requestRatio: preset,
+                selected: _isPresetSelected(preset),
+                enabled: !_wouldSwitchPhysicalCamera(preset),
+                onSelected: onSelected,
+              ),
+          ],
+        ),
+      ),
+    );
+  }
+
+  bool _isPresetAvailable(double preset) {
+    if (preset < 1.0) {
+      return minZoomRatio <= preset && maxZoomRatio >= preset;
+    }
+    return preset >= minZoomRatio && preset <= maxZoomRatio;
+  }
+
+  bool _isPresetSelected(double preset) {
+    if (preset < 1.0) {
+      return zoomRatio < 1.0;
+    }
+    return (zoomRatio - preset).abs() < 0.05;
+  }
+
+  bool _wouldSwitchPhysicalCamera(double preset) {
+    if (!isRecording) {
+      return false;
+    }
+    final currentIsUltraWide = zoomRatio < 1.0;
+    final targetIsUltraWide = preset < 1.0;
+    return currentIsUltraWide != targetIsUltraWide;
+  }
+}
+
+class _ZoomPresetButton extends StatelessWidget {
+  const _ZoomPresetButton({
+    required this.displayRatio,
+    required this.requestRatio,
+    required this.selected,
+    required this.enabled,
+    required this.onSelected,
+  });
+
+  final double displayRatio;
+  final double requestRatio;
+  final bool selected;
+  final bool enabled;
+  final ValueChanged<double> onSelected;
+
+  @override
+  Widget build(BuildContext context) {
+    return Padding(
+      padding: EdgeInsets.symmetric(horizontal: 1.r),
+      child: TextButton(
+        onPressed: selected || !enabled ? null : () => onSelected(requestRatio),
+        style: TextButton.styleFrom(
+          minimumSize: Size(38.r, 32.r),
+          padding: EdgeInsets.zero,
+          tapTargetSize: MaterialTapTargetSize.shrinkWrap,
+          foregroundColor: selected ? Colors.black : Colors.white,
+          disabledForegroundColor: Colors.black,
+          backgroundColor: selected ? Colors.white : Colors.transparent,
+          disabledBackgroundColor: Colors.white,
+          shape: RoundedRectangleBorder(
+            borderRadius: BorderRadius.circular(15.r),
+          ),
+        ),
+        child: Text(
+          '${_formatZoomRatio(displayRatio)}x',
+          style: TextStyle(
+            fontSize: 13.sp,
+            fontWeight: FontWeight.w700,
+            letterSpacing: 0,
+          ),
+        ),
+      ),
+    );
+  }
+
+  String _formatZoomRatio(double ratio) {
+    if (ratio == ratio.roundToDouble()) {
+      return ratio.toStringAsFixed(0);
+    }
+    return ratio.toStringAsFixed(1);
+  }
+}

lib/features/recording/widgets/widget_recording_loading_overlay.dart

@@ -0,0 +1,41 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+
+/// 录制加载遮罩（相机启动/开始录制）
+class RecordingLoadingOverlayWidget extends StatelessWidget {
+  const RecordingLoadingOverlayWidget({
+    super.key,
+    required this.message,
+    this.backgroundColor = Colors.black,
+  });
+
+  final String message;
+  final Color backgroundColor;
+
+  @override
+  /// 显示加载动画与提示文案
+  Widget build(BuildContext context) {
+    return ColoredBox(
+      color: backgroundColor,
+      child: Center(
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            SizedBox.square(
+              dimension: 32.r,
+              child: CircularProgressIndicator(
+                strokeWidth: 2.5.r,
+                color: Colors.white70,
+              ),
+            ),
+            SizedBox(height: 14.h),
+            Text(
+              message,
+              style: TextStyle(color: Colors.white70, fontSize: 14.sp),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}

lib/features/recording/widgets/widget_recording_saved_dialog.dart

@@ -0,0 +1,20 @@
+import 'package:flutter/material.dart';
+import 'package:recording_tool/features/dialog/dialog-record.dart';
+
+/// 录制结束并保存到文件夹后的后续操作弹窗。
+Future<void> showRecordingSavedDialog(
+  BuildContext context, {
+  required String sessionTitle,
+  required VoidCallback onContinueRound,
+  required VoidCallback onRecordNewRound,
+}) {
+  return RecordDialog.showDouble(
+    context,
+    title: '本轮比赛视频已保存到文件夹\n请选择后续录制信息',
+    leftText: '继续本轮',
+    rightText: '录制新轮',
+    onLeftPressed: onContinueRound,
+    onRightPressed: onRecordNewRound,
+    barrierDismissible: false,
+  );
+}

lib/features/recording/widgets/widget_recording_setup_hints.dart

@@ -0,0 +1,56 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:recording_tool/features/recording/widgets/widget_recording_hint_chip.dart';
+
+/// 权限相关设置提示条
+class RecordingSetupHintsWidget extends StatelessWidget {
+  const RecordingSetupHintsWidget({
+    super.key,
+    required this.hasDndAccess,
+    required this.isBatteryIgnored,
+    required this.notificationsGranted,
+    required this.onOpenDnd,
+    required this.onOpenBattery,
+    required this.onOpenNotificationSettings,
+  });
+
+  final bool hasDndAccess;
+  final bool isBatteryIgnored;
+  final bool notificationsGranted;
+  final VoidCallback onOpenDnd;
+  final VoidCallback onOpenBattery;
+  final VoidCallback onOpenNotificationSettings;
+
+  @override
+  Widget build(BuildContext context) {
+    final showPermissionHints =
+        !hasDndAccess || !isBatteryIgnored || !notificationsGranted;
+    if (!showPermissionHints) {
+      return const SizedBox.shrink();
+    }
+
+    return Padding(
+      padding: EdgeInsets.symmetric(horizontal: 16.r, vertical: 8.r),
+      child: Column(
+        children: [
+          if (!notificationsGranted) ...[
+            RecordingHintChipWidget(
+              label: '开启通知权限以显示录制前台服务',
+              onTap: onOpenNotificationSettings,
+            ),
+            SizedBox(height: 8.h),
+          ],
+          if (!hasDndAccess)
+            RecordingHintChipWidget(label: '开启勿扰权限可减少录制中断', onTap: onOpenDnd),
+          if (!isBatteryIgnored) ...[
+            SizedBox(height: 8.h),
+            RecordingHintChipWidget(
+              label: '关闭电池优化可提升息屏续录稳定性',
+              onTap: onOpenBattery,
+            ),
+          ],
+        ],
+      ),
+    );
+  }
+}

lib/features/recording/widgets/widget_recording_touch_lock_overlay.dart

@@ -0,0 +1,218 @@
+import 'dart:async';
+
+import 'package:flutter/material.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+
+enum RecordingTouchLockUnlockIntent { unlockOnly, stopRecording }
+
+RecordingTouchLockUnlockIntent resolveRecordingTouchLockUnlockIntent({
+  required Offset position,
+  required Size size,
+  double stopZoneFraction = 0.3,
+}) {
+  if (size.width <= 0 || size.height <= 0 || stopZoneFraction <= 0) {
+    return RecordingTouchLockUnlockIntent.unlockOnly;
+  }
+
+  final normalizedStopZone = stopZoneFraction.clamp(0.0, 1.0);
+  if (size.width <= size.height) {
+    final stopZoneTop = size.height * (1 - normalizedStopZone);
+    return position.dy >= stopZoneTop
+        ? RecordingTouchLockUnlockIntent.stopRecording
+        : RecordingTouchLockUnlockIntent.unlockOnly;
+  }
+
+  final stopZoneLeft = size.width * (1 - normalizedStopZone);
+  return position.dx >= stopZoneLeft
+      ? RecordingTouchLockUnlockIntent.stopRecording
+      : RecordingTouchLockUnlockIntent.unlockOnly;
+}
+
+class RecordingTouchLockOverlayWidget extends StatefulWidget {
+  const RecordingTouchLockOverlayWidget({
+    super.key,
+    required this.enabled,
+    required this.onUnlocked,
+    this.unlockHoldDuration = const Duration(seconds: 2),
+  });
+
+  final bool enabled;
+  final ValueChanged<RecordingTouchLockUnlockIntent> onUnlocked;
+  final Duration unlockHoldDuration;
+
+  @override
+  State<RecordingTouchLockOverlayWidget> createState() =>
+      _RecordingTouchLockOverlayWidgetState();
+}
+
+class _RecordingTouchLockOverlayWidgetState
+    extends State<RecordingTouchLockOverlayWidget> {
+  Timer? _holdTimer;
+  bool _isHolding = false;
+  int? _remainingSeconds;
+  Offset? _holdStartPosition;
+  Size? _holdStartSize;
+
+  @override
+  void didUpdateWidget(RecordingTouchLockOverlayWidget oldWidget) {
+    super.didUpdateWidget(oldWidget);
+    if (!widget.enabled) {
+      _cancelHold();
+    }
+  }
+
+  @override
+  void dispose() {
+    _holdTimer?.cancel();
+    _holdTimer = null;
+    super.dispose();
+  }
+
+  void _cancelHold() {
+    _holdTimer?.cancel();
+    _holdTimer = null;
+    if (!_isHolding && _remainingSeconds == null) return;
+    setState(() {
+      _isHolding = false;
+      _remainingSeconds = null;
+      _holdStartPosition = null;
+      _holdStartSize = null;
+    });
+  }
+
+  void _startHold(Offset position, Size size) {
+    if (!widget.enabled) return;
+    final totalSeconds = widget.unlockHoldDuration.inSeconds;
+    _holdTimer?.cancel();
+    setState(() {
+      _isHolding = true;
+      _remainingSeconds = totalSeconds;
+      _holdStartPosition = position;
+      _holdStartSize = size;
+    });
+
+    var elapsed = 0;
+    _holdTimer = Timer.periodic(const Duration(seconds: 1), (timer) {
+      elapsed += 1;
+      if (!mounted) {
+        timer.cancel();
+        return;
+      }
+      if (elapsed >= totalSeconds) {
+        timer.cancel();
+        _holdTimer = null;
+        final intent = resolveRecordingTouchLockUnlockIntent(
+          position: _holdStartPosition ?? Offset.zero,
+          size: _holdStartSize ?? Size.zero,
+        );
+        setState(() {
+          _isHolding = false;
+          _remainingSeconds = null;
+          _holdStartPosition = null;
+          _holdStartSize = null;
+        });
+        widget.onUnlocked(intent);
+        return;
+      }
+      setState(() => _remainingSeconds = totalSeconds - elapsed);
+    });
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    if (!widget.enabled) {
+      return const SizedBox.shrink();
+    }
+
+    return Positioned.fill(
+      child: LayoutBuilder(
+        builder: (context, constraints) {
+          final overlaySize = Size(constraints.maxWidth, constraints.maxHeight);
+          return Listener(
+            behavior: HitTestBehavior.opaque,
+            onPointerDown: (event) =>
+                _startHold(event.localPosition, overlaySize),
+            onPointerUp: (_) => _cancelHold(),
+            onPointerCancel: (_) => _cancelHold(),
+            child: ColoredBox(
+              color: Colors.black.withValues(alpha: 0.01),
+              child: Align(
+                alignment: Alignment.topCenter,
+                child: Padding(
+                  padding: EdgeInsets.only(top: 68.r),
+                  child: DecoratedBox(
+                    decoration: BoxDecoration(
+                      color: Colors.black54,
+                      borderRadius: BorderRadius.circular(24.r),
+                    ),
+                    child: Padding(
+                      padding: EdgeInsets.symmetric(
+                        horizontal: 16.r,
+                        vertical: 8.r,
+                      ),
+                      child: _isHolding && _remainingSeconds != null
+                          ? Builder(
+                              builder: (context) {
+                                final remainingSeconds = _remainingSeconds!;
+                                return Column(
+                                  mainAxisSize: MainAxisSize.min,
+                                  children: [
+                                    AnimatedSwitcher(
+                                      duration: const Duration(
+                                        milliseconds: 280,
+                                      ),
+                                      switchInCurve: Curves.easeOut,
+                                      switchOutCurve: Curves.easeIn,
+                                      transitionBuilder: (child, animation) {
+                                        return ScaleTransition(
+                                          scale: Tween<double>(
+                                            begin: 0.6,
+                                            end: 1,
+                                          ).animate(animation),
+                                          child: FadeTransition(
+                                            opacity: animation,
+                                            child: child,
+                                          ),
+                                        );
+                                      },
+                                      child: Text(
+                                        '${remainingSeconds}s',
+                                        key: ValueKey<int>(remainingSeconds),
+                                        style: TextStyle(
+                                          color: Colors.white,
+                                          fontSize: 18.sp,
+                                          fontWeight: FontWeight.w600,
+                                          height: 1.1,
+                                        ),
+                                      ),
+                                    ),
+                                    SizedBox(height: 2.r),
+                                    Text(
+                                      '保持按住解锁',
+                                      style: TextStyle(
+                                        color: Colors.white70,
+                                        fontSize: 10.sp,
+                                      ),
+                                    ),
+                                  ],
+                                );
+                              },
+                            )
+                          : Text(
+                              '防误触已开启，按住 ${widget.unlockHoldDuration.inSeconds}s 解锁',
+                              style: TextStyle(
+                                color: Colors.white,
+                                fontSize: 10.sp,
+                              ),
+                            ),
+                    ),
+                  ),
+                ),
+              ),
+            ),
+          );
+        },
+      ),
+    );
+  }
+}

lib/gen/assets.gen.dart

@@ -0,0 +1,134 @@
+// dart format width=80
+
+/// GENERATED CODE - DO NOT MODIFY BY HAND
+/// *****************************************************
+///  FlutterGen
+/// *****************************************************
+
+// coverage:ignore-file
+// ignore_for_file: type=lint
+// ignore_for_file: deprecated_member_use,directives_ordering,implicit_dynamic_list_literal,unnecessary_import
+
+import 'package:flutter/widgets.dart';
+
+class $AssetsImagesGen {
+  const $AssetsImagesGen();
+
+  /// File path: assets/images/image_copy.png
+  AssetGenImage get imageCopy =>
+      const AssetGenImage('assets/images/image_copy.png');
+
+  /// File path: assets/images/image_delete.png
+  AssetGenImage get imageDelete =>
+      const AssetGenImage('assets/images/image_delete.png');
+
+  /// File path: assets/images/image_dialog_bg.png
+  AssetGenImage get imageDialogBg =>
+      const AssetGenImage('assets/images/image_dialog_bg.png');
+
+  /// File path: assets/images/image_logo.png
+  AssetGenImage get imageLogo =>
+      const AssetGenImage('assets/images/image_logo.png');
+
+  /// List of all assets
+  List<AssetGenImage> get values => [
+    imageCopy,
+    imageDelete,
+    imageDialogBg,
+    imageLogo,
+  ];
+}
+
+class Assets {
+  const Assets._();
+
+  static const $AssetsImagesGen images = $AssetsImagesGen();
+}
+
+class AssetGenImage {
+  const AssetGenImage(
+    this._assetName, {
+    this.size,
+    this.flavors = const {},
+    this.animation,
+  });
+
+  final String _assetName;
+
+  final Size? size;
+  final Set<String> flavors;
+  final AssetGenImageAnimation? animation;
+
+  Image image({
+    Key? key,
+    AssetBundle? bundle,
+    ImageFrameBuilder? frameBuilder,
+    ImageErrorWidgetBuilder? errorBuilder,
+    String? semanticLabel,
+    bool excludeFromSemantics = false,
+    double? scale,
+    double? width,
+    double? height,
+    Color? color,
+    Animation<double>? opacity,
+    BlendMode? colorBlendMode,
+    BoxFit? fit,
+    AlignmentGeometry alignment = Alignment.center,
+    ImageRepeat repeat = ImageRepeat.noRepeat,
+    Rect? centerSlice,
+    bool matchTextDirection = false,
+    bool gaplessPlayback = true,
+    bool isAntiAlias = false,
+    String? package,
+    FilterQuality filterQuality = FilterQuality.medium,
+    int? cacheWidth,
+    int? cacheHeight,
+  }) {
+    return Image.asset(
+      _assetName,
+      key: key,
+      bundle: bundle,
+      frameBuilder: frameBuilder,
+      errorBuilder: errorBuilder,
+      semanticLabel: semanticLabel,
+      excludeFromSemantics: excludeFromSemantics,
+      scale: scale,
+      width: width,
+      height: height,
+      color: color,
+      opacity: opacity,
+      colorBlendMode: colorBlendMode,
+      fit: fit,
+      alignment: alignment,
+      repeat: repeat,
+      centerSlice: centerSlice,
+      matchTextDirection: matchTextDirection,
+      gaplessPlayback: gaplessPlayback,
+      isAntiAlias: isAntiAlias,
+      package: package,
+      filterQuality: filterQuality,
+      cacheWidth: cacheWidth,
+      cacheHeight: cacheHeight,
+    );
+  }
+
+  ImageProvider provider({AssetBundle? bundle, String? package}) {
+    return AssetImage(_assetName, bundle: bundle, package: package);
+  }
+
+  String get path => _assetName;
+
+  String get keyName => _assetName;
+}
+
+class AssetGenImageAnimation {
+  const AssetGenImageAnimation({
+    required this.isAnimation,
+    required this.duration,
+    required this.frames,
+  });
+
+  final bool isAnimation;
+  final Duration duration;
+  final int frames;
+}

pubspec.yaml

@@ -16,7 +16,7 @@ publish_to: "none" # Remove this line if you wish to publish to pub.dev
 # https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
 # In Windows, build-name is used as the major, minor, and patch parts
 # of the product and file versions while build-number is used as the build suffix.
-version: 1.0.0+2002
+version: 1.0.0
 
 environment:
   sdk: ^3.9.0
@@ -58,6 +58,8 @@ dev_dependencies:
   # package. See that file for information about deactivating specific lint
   # rules and activating additional ones.
   flutter_lints: ^6.0.0
+  build_runner: ^2.15.0
+  flutter_gen_runner: ^5.14.1
 
 # For information on the generic Dart part of this file, see the
 # following page: https://dart.dev/tools/pub/pubspec
@@ -68,7 +70,11 @@ flutter:
   # included with your application, so that you can use the icons in
   # the material Icons class.
   uses-material-design: true
+  generate: true
 
+  # To add assets to your application, add an assets section, like this:
+  assets:
+    - assets/images/
   # To add assets to your application, add an assets section, like this:
   # assets:
   #   - images/a_dot_burr.jpeg
@@ -99,3 +105,8 @@ flutter:
   #
   # For details regarding fonts from package dependencies,
   # see https://flutter.dev/to/font-from-package
+
+flutter_gen:
+  output: lib/gen/
+  integrations:
+    flutter_svg: true

test/core/permission/permission_service_test.dart

@@ -71,7 +71,7 @@ void main() {
   });
 
   group('iOS permission configuration', () {
-    test('Podfile enables camera, microphone and photos permission macros', () {
+    test('Podfile enables camera and microphone permission macros only', () {
       final podfile = File('ios/Podfile').readAsStringSync();
 
       expect(
@@ -80,8 +80,8 @@ void main() {
       );
       expect(podfile, contains("'PERMISSION_CAMERA=1'"));
       expect(podfile, contains("'PERMISSION_MICROPHONE=1'"));
-      expect(podfile, contains("'PERMISSION_PHOTOS=1'"));
+      expect(podfile, isNot(contains("'PERMISSION_PHOTOS=1'")));
-      expect(podfile, contains("'PERMISSION_PHOTOS_ADD_ONLY=1'"));
+      expect(podfile, isNot(contains("'PERMISSION_PHOTOS_ADD_ONLY=1'")));
     });
   });
 }

test/features/dialog/record_dialog_test.dart

@@ -0,0 +1,130 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:recording_tool/features/dialog/dialog-record.dart';
+import 'package:recording_tool/features/recording/widgets/widget_recording_saved_dialog.dart';
+import 'package:recording_tool/gen/assets.gen.dart';
+
+void main() {
+  Future<void> pumpDialogHost(WidgetTester tester, Widget child) async {
+    await tester.pumpWidget(
+      ScreenUtilInit(
+        designSize: const Size(375, 812),
+        builder: (context, _) {
+          return MaterialApp(home: Scaffold(body: child));
+        },
+      ),
+    );
+  }
+
+  testWidgets('single button dialog shows configured content and closes', (
+    tester,
+  ) async {
+    var tapped = false;
+
+    await pumpDialogHost(
+      tester,
+      Builder(
+        builder: (context) {
+          return TextButton(
+            onPressed: () {
+              RecordDialog.showSingle(
+                context,
+                title: '无选手信息！',
+                buttonText: '粘贴',
+                onPressed: () => tapped = true,
+              );
+            },
+            child: const Text('show'),
+          );
+        },
+      ),
+    );
+
+    await tester.tap(find.text('show'));
+    await tester.pumpAndSettle();
+
+    expect(find.byType(Image), findsOneWidget);
+    expect(find.image(AssetImage(Assets.images.imageDialogBg.path)), findsOne);
+    expect(find.text('无选手信息！'), findsOneWidget);
+    expect(find.text('粘贴'), findsOneWidget);
+
+    await tester.tap(find.text('粘贴'));
+    await tester.pumpAndSettle();
+
+    expect(tapped, isTrue);
+    expect(find.text('无选手信息！'), findsNothing);
+  });
+
+  testWidgets('double button dialog dispatches each action', (tester) async {
+    var leftTapped = false;
+    var rightTapped = false;
+
+    await pumpDialogHost(
+      tester,
+      Builder(
+        builder: (context) {
+          return TextButton(
+            onPressed: () {
+              RecordDialog.showDouble(
+                context,
+                title: '本轮比赛视频已保存到文件夹\n请选择后续录制信息',
+                leftText: '继续本轮',
+                rightText: '录制新轮',
+                onLeftPressed: () => leftTapped = true,
+                onRightPressed: () => rightTapped = true,
+              );
+            },
+            child: const Text('show'),
+          );
+        },
+      ),
+    );
+
+    await tester.tap(find.text('show'));
+    await tester.pumpAndSettle();
+    await tester.tap(find.text('继续本轮'));
+    await tester.pumpAndSettle();
+
+    expect(leftTapped, isTrue);
+    expect(rightTapped, isFalse);
+
+    await tester.tap(find.text('show'));
+    await tester.pumpAndSettle();
+    await tester.tap(find.text('录制新轮'));
+    await tester.pumpAndSettle();
+
+    expect(rightTapped, isTrue);
+  });
+
+  testWidgets('recording saved dialog follows design title only', (
+    tester,
+  ) async {
+    await pumpDialogHost(
+      tester,
+      Builder(
+        builder: (context) {
+          return TextButton(
+            onPressed: () {
+              showRecordingSavedDialog(
+                context,
+                sessionTitle: '王东方 丨李想 空中格斗赛',
+                onContinueRound: () {},
+                onRecordNewRound: () {},
+              );
+            },
+            child: const Text('show'),
+          );
+        },
+      ),
+    );
+
+    await tester.tap(find.text('show'));
+    await tester.pumpAndSettle();
+
+    expect(find.text('王东方 丨李想 空中格斗赛'), findsNothing);
+    expect(find.text('本轮比赛视频已保存到文件夹\n请选择后续录制信息'), findsOneWidget);
+    expect(find.text('继续本轮'), findsOneWidget);
+    expect(find.text('录制新轮'), findsOneWidget);
+  });
+}

test/features/recording/recording_display_name_test.dart

@@ -1,5 +1,5 @@
 import 'package:flutter_test/flutter_test.dart';
-import 'package:recording_tool/features/recording/recording_display_name.dart';
+import 'package:recording_tool/features/recording/utils/recording_display_name.dart';
 
 void main() {
   group('sanitizeRecordingBaseName', () {

test/features/recording/recording_platform_test.dart

@@ -1,5 +1,5 @@
 import 'package:flutter_test/flutter_test.dart';
-import 'package:recording_tool/features/recording/recording_platform.dart';
+import 'package:recording_tool/features/recording/platform/recording_platform.dart';
 
 void main() {
   group('RecordingPlatform support', () {
@@ -18,4 +18,20 @@ void main() {
       );
     });
   });
+
+  group('RecordingStopResult', () {
+    test('parses file save result fields from platform payload', () {
+      final result = RecordingStopResult.fromMap(<String, dynamic>{
+        'outputPath': '/Documents/recordings/test.mov',
+        'status': <String, dynamic>{'state': 'previewing'},
+        'fileSaved': false,
+        'fileErrorMessage': '保存到文件夹失败',
+      });
+
+      expect(result.outputPath, '/Documents/recordings/test.mov');
+      expect(result.status.state, RecordingState.previewing);
+      expect(result.fileSaved, isFalse);
+      expect(result.fileErrorMessage, '保存到文件夹失败');
+    });
+  });
 }

test/features/recording/view_model_recording_test.dart

@@ -1,6 +1,9 @@
 import 'package:flutter/services.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:flutter_test/flutter_test.dart';
+import 'package:permission_handler/permission_handler.dart';
+import 'package:recording_tool/features/recording/model/model_recording_session.dart';
+import 'package:recording_tool/features/recording/platform/recording_channel_names.dart';
 import 'package:recording_tool/features/recording/view-model/view_model_recording.dart';
 
 void main() {
@@ -23,6 +26,246 @@ void main() {
   tearDown(() {
     TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger
         .setMockMethodCallHandler(SystemChannels.platform, null);
+    TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger
+        .setMockMethodCallHandler(
+          const MethodChannel(RecordingChannelNames.method),
+          null,
+        );
+  });
+
+  group('RecordingViewModel', () {
+    test('initializes with default clipboard and session state', () {
+      final container = ProviderContainer();
+      addTearDown(container.dispose);
+
+      final model = container.read(recordingViewModelProvider);
+      expect(model.hasValidClipboardInfo, isFalse);
+      expect(model.clipboardRecordingModel.title, defaultClipboardTitle);
+      expect(model.session.isPreviewReady, isFalse);
+      expect(model.session.isRecording, isFalse);
+      expect(model.session.zoomRatio, 1.0);
+      expect(model.session.minZoomRatio, 1.0);
+      expect(model.session.maxZoomRatio, 3.0);
+    });
+  });
+
+  group('RecordingViewModel.setZoomRatio', () {
+    test('updates zoom ratio from native response', () async {
+      TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger
+          .setMockMethodCallHandler(
+            const MethodChannel(RecordingChannelNames.method),
+            (call) async {
+              expect(call.method, 'setZoomRatio');
+              expect(call.arguments, <String, dynamic>{'zoomRatio': 2.0});
+              return <String, dynamic>{
+                'zoomRatio': 2.0,
+                'minZoomRatio': 1.0,
+                'maxZoomRatio': 3.0,
+              };
+            },
+          );
+      final container = ProviderContainer();
+      addTearDown(container.dispose);
+
+      await container.read(recordingViewModelProvider.notifier).setZoomRatio(2);
+
+      final session = container.read(recordingViewModelProvider).session;
+      expect(session.zoomRatio, 2.0);
+      expect(session.minZoomRatio, 1.0);
+      expect(session.maxZoomRatio, 3.0);
+      expect(session.errorMessage, isNull);
+    });
+
+    test(
+      'clamps legacy 0.5x request to 0.6x ultra-wide ratio',
+      () async {
+        final calls = <MethodCall>[];
+        TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger
+            .setMockMethodCallHandler(
+              const MethodChannel(RecordingChannelNames.method),
+              (call) async {
+                calls.add(call);
+                return <String, dynamic>{
+                  'zoomRatio': 0.6,
+                  'minZoomRatio': 0.6,
+                  'maxZoomRatio': 3.0,
+                };
+              },
+            );
+        final container = ProviderContainer();
+        addTearDown(container.dispose);
+        final notifier = container.read(recordingViewModelProvider.notifier);
+        // ignore: invalid_use_of_protected_member
+        notifier.state = container
+            .read(recordingViewModelProvider)
+            .copyWith(
+              session: const RecordingSessionState(
+                zoomRatio: 1.0,
+                minZoomRatio: 0.6,
+                maxZoomRatio: 3.0,
+              ),
+            );
+
+        await notifier.setZoomRatio(0.5);
+
+        expect(calls.single.arguments, <String, dynamic>{'zoomRatio': 0.6});
+        final session = container.read(recordingViewModelProvider).session;
+        expect(session.zoomRatio, 0.6);
+        expect(session.minZoomRatio, 0.6);
+        expect(session.maxZoomRatio, 3.0);
+      },
+    );
+
+    test('passes 0.6x to native when camera capabilities allow it', () async {
+      final calls = <MethodCall>[];
+      TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger
+          .setMockMethodCallHandler(
+            const MethodChannel(RecordingChannelNames.method),
+            (call) async {
+              calls.add(call);
+              return <String, dynamic>{
+                'zoomRatio': 0.6,
+                'minZoomRatio': 0.6,
+                'maxZoomRatio': 3.0,
+              };
+            },
+          );
+      final container = ProviderContainer();
+      addTearDown(container.dispose);
+      final notifier = container.read(recordingViewModelProvider.notifier);
+      // ignore: invalid_use_of_protected_member
+      notifier.state = container
+          .read(recordingViewModelProvider)
+          .copyWith(
+            session: const RecordingSessionState(
+              zoomRatio: 1.0,
+              minZoomRatio: 0.6,
+              maxZoomRatio: 3.0,
+            ),
+          );
+
+      await notifier.setZoomRatio(0.6);
+
+      expect(calls.single.arguments, <String, dynamic>{'zoomRatio': 0.6});
+      final session = container.read(recordingViewModelProvider).session;
+      expect(session.zoomRatio, 0.6);
+      expect(session.minZoomRatio, 0.6);
+      expect(session.maxZoomRatio, 3.0);
+    });
+
+    test('clamps requested zoom ratio before invoking native', () async {
+      final calls = <MethodCall>[];
+      TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger
+          .setMockMethodCallHandler(
+            const MethodChannel(RecordingChannelNames.method),
+            (call) async {
+              calls.add(call);
+              return <String, dynamic>{
+                'zoomRatio': 1.0,
+                'minZoomRatio': 1.0,
+                'maxZoomRatio': 1.0,
+              };
+            },
+          );
+      final container = ProviderContainer();
+      addTearDown(container.dispose);
+
+      await container.read(recordingViewModelProvider.notifier).setZoomRatio(4);
+
+      expect(calls.single.arguments, <String, dynamic>{'zoomRatio': 3.0});
+      expect(container.read(recordingViewModelProvider).session.zoomRatio, 1.0);
+    });
+
+    test(
+      'clamps 0.6x to 1x when camera capabilities do not allow it',
+      () async {
+        final calls = <MethodCall>[];
+        TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger
+            .setMockMethodCallHandler(
+              const MethodChannel(RecordingChannelNames.method),
+              (call) async {
+                calls.add(call);
+                return <String, dynamic>{
+                  'zoomRatio': 1.0,
+                  'minZoomRatio': 1.0,
+                  'maxZoomRatio': 3.0,
+                };
+              },
+            );
+        final container = ProviderContainer();
+        addTearDown(container.dispose);
+
+        await container
+            .read(recordingViewModelProvider.notifier)
+            .setZoomRatio(0.6);
+
+        expect(calls.single.arguments, <String, dynamic>{'zoomRatio': 1.0});
+        expect(
+          container.read(recordingViewModelProvider).session.zoomRatio,
+          1.0,
+        );
+      },
+    );
+
+    test(
+      'keeps previous zoom ratio and stores error when native fails',
+      () async {
+        TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger
+            .setMockMethodCallHandler(
+              const MethodChannel(RecordingChannelNames.method),
+              (call) async {
+                throw PlatformException(
+                  code: 'ZOOM_FAILED',
+                  message: 'Zoom is unavailable',
+                );
+              },
+            );
+        final container = ProviderContainer();
+        addTearDown(container.dispose);
+
+        await container
+            .read(recordingViewModelProvider.notifier)
+            .setZoomRatio(2);
+
+        final session = container.read(recordingViewModelProvider).session;
+        expect(session.zoomRatio, 1.0);
+        expect(session.errorMessage, 'Zoom is unavailable');
+      },
+    );
+  });
+
+  group('recordingFileSavePermissionsForHost', () {
+    test('does not request photo permission on iOS', () {
+      final permissions = recordingFileSavePermissionsForHost(
+        isIOS: true,
+        isAndroid: false,
+      );
+
+      expect(permissions, isEmpty);
+      expect(permissions, isNot(contains(Permission.photosAddOnly)));
+      expect(permissions, isNot(contains(Permission.photos)));
+    });
+
+    test('requests storage permission on Android 9 and below', () {
+      final permissions = recordingFileSavePermissionsForHost(
+        isIOS: false,
+        isAndroid: true,
+        androidSdkInt: 28,
+      );
+
+      expect(permissions, <Permission>[Permission.storage]);
+      expect(permissions, isNot(contains(Permission.videos)));
+    });
+
+    test('does not request file save permission on Android 10 and above', () {
+      final permissions = recordingFileSavePermissionsForHost(
+        isIOS: false,
+        isAndroid: true,
+        androidSdkInt: 29,
+      );
+
+      expect(permissions, isEmpty);
+    });
   });
 
   group('RecordingViewModel.getClipboardContent', () {
@@ -43,14 +286,8 @@ void main() {
         expect(model.clipboardRecordingModel.title, '王东方 丨李想 空中格斗赛');
         expect(model.clipboardRecordingModel.startTimestamp, 1717334400);
         expect(model.clipboardRecordingModel.endTimestamp, 1717334400);
-        expect(
+        expect(model.clipboardRecordingModel.address, '广州市番禺区·粤港澳大湾区青年人才双创小镇');
-          model.clipboardRecordingModel.address,
+        expect(model.clipboardRecordingModel.filename, '选手名称_选手ID_赛事名称_赛项');
-          '广州市番禺区·粤港澳大湾区青年人才双创小镇',
-        );
-        expect(
-          model.clipboardRecordingModel.filename,
-          '选手名称_选手ID_赛事名称_赛项',
-        );
       },
     );
 
@@ -80,7 +317,10 @@ void main() {
 
       expect(result, ClipboardReadResult.invalid);
       expect(
-        container.read(recordingViewModelProvider).clipboardRecordingModel.title,
+        container
+            .read(recordingViewModelProvider)
+            .clipboardRecordingModel
+            .title,
         defaultClipboardTitle,
       );
       expect(
@@ -100,12 +340,17 @@ void main() {
 
       expect(result, ClipboardReadResult.invalid);
       expect(
-        container.read(recordingViewModelProvider).clipboardRecordingModel.title,
+        container
+            .read(recordingViewModelProvider)
+            .clipboardRecordingModel
+            .title,
         defaultClipboardTitle,
       );
     });
 
-    test('returns invalid when clipboard JSON misses required address', () async {
+    test(
+      'returns invalid when clipboard JSON misses required address',
+      () async {
         await setClipboardText('{"title":"王东方 丨李想 空中格斗赛"}');
         final container = ProviderContainer();
         addTearDown(container.dispose);
@@ -116,14 +361,16 @@ void main() {
 
         expect(result, ClipboardReadResult.invalid);
         expect(
-        container.read(recordingViewModelProvider).clipboardRecordingModel.title,
+          container
+              .read(recordingViewModelProvider)
+              .clipboardRecordingModel
+              .title,
           defaultClipboardTitle,
         );
-    });
+      },
+    );
 
-    test(
+    test('updates state when clipboard omits optional timestamps', () async {
-      'updates state when clipboard omits optional timestamps',
-      () async {
       await setClipboardText(
         '{"title":"郑昌梦 丨黄伟依 空中格斗赛 小学组","address":"广东省汕头市番禺区青蓝街 111 号","filename":"郑昌梦_黄伟依_6月3日测试-1_空中格斗赛"}',
       );
@@ -139,12 +386,8 @@ void main() {
       expect(model.hasValidClipboardInfo, isTrue);
       expect(model.clipboardRecordingModel.startTimestamp, isNull);
       expect(model.clipboardRecordingModel.endTimestamp, isNull);
-        expect(
+      expect(model.clipboardRecordingModel.filename, '郑昌梦_黄伟依_6月3日测试-1_空中格斗赛');
-          model.clipboardRecordingModel.filename,
+    });
-          '郑昌梦_黄伟依_6月3日测试-1_空中格斗赛',
-        );
-      },
-    );
 
     test('returns invalid when clipboard JSON has wrong field type', () async {
       await setClipboardText(
@@ -159,7 +402,10 @@ void main() {
 
       expect(result, ClipboardReadResult.invalid);
       expect(
-        container.read(recordingViewModelProvider).clipboardRecordingModel.title,
+        container
+            .read(recordingViewModelProvider)
+            .clipboardRecordingModel
+            .title,
         defaultClipboardTitle,
       );
     });

test/features/recording/widget_record_header_test.dart

@@ -0,0 +1,52 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_screenutil/flutter_screenutil.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:recording_tool/features/recording/widgets/widget_record_header.dart';
+import 'package:recording_tool/gen/assets.gen.dart';
+
+void main() {
+  Future<void> pumpHeader(
+    WidgetTester tester, {
+    required bool hasValidClipboardInfo,
+    String? eventTitle,
+  }) async {
+    await tester.pumpWidget(
+      ScreenUtilInit(
+        designSize: const Size(375, 812),
+        builder: (context, _) {
+          return MaterialApp(
+            home: Scaffold(
+              body: RecordHeaderWidget(
+                hasValidClipboardInfo: hasValidClipboardInfo,
+                eventTitle: eventTitle,
+                isRecording: false,
+                onPasteEventInfo: () async {},
+                onClearEventInfo: () {},
+              ),
+            ),
+          );
+        },
+      ),
+    );
+  }
+
+  testWidgets('paste player info button uses copy image asset', (tester) async {
+    await pumpHeader(tester, hasValidClipboardInfo: false);
+
+    expect(find.text('粘贴选手信息'), findsOneWidget);
+    expect(find.image(AssetImage(Assets.images.imageCopy.path)), findsOne);
+  });
+
+  testWidgets('clear player info button uses delete image asset', (
+    tester,
+  ) async {
+    await pumpHeader(
+      tester,
+      hasValidClipboardInfo: true,
+      eventTitle: '王东方 丨李想 空中格斗赛',
+    );
+
+    expect(find.text('王东方 丨李想 空中格斗赛'), findsOneWidget);
+    expect(find.image(AssetImage(Assets.images.imageDelete.path)), findsOne);
+  });
+}