feat(audio): 添加音频播放功能支持

- 新增 AudioPlayerUtil 工具类，支持 Assets、本地文件和网络音频播放
- 在 ASJavascriptInterfaceAsync 中实现 audioPlayFromFile 和 audioStop 方法
- 扩展 CallMethod 类，增加 audioPlayFromFile 和 audioStop 常量- 更新 OverlayBasic 示例，恢复注释掉的测试代码逻辑
- 移除 OverlayBasic 中的 download 方法实现
- 添加音频播放相关的完整回调接口和状态管理
- 支持相对音量和绝对音量控制模式
- 实现播放完成后的系统音量自动恢复功能
- 提供详细的音频播放调试信息接口- 集成协程支持，优化异步播放体验

Author: ven-coder

assists-web/src/main/java/com/ven/assists/web/ASJavascriptInterfaceAsync.kt

@@ -66,7 +66,9 @@ import java.nio.charset.StandardCharsets
 import java.util.concurrent.TimeUnit
 import androidx.core.net.toUri
 import com.blankj.utilcode.util.ActivityUtils
+import com.ven.assists.utils.AudioPlayerUtil
 import com.ven.assists.utils.FileDownloadUtil
+import kotlinx.coroutines.CompletableDeferred
 
 class ASJavascriptInterfaceAsync(val webView: WebView) {
     var callIntercept: ((json: String) -> CallInterceptResult)? = null
@@ -117,6 +119,42 @@ class ASJavascriptInterfaceAsync(val webView: WebView) {
         val request = GsonUtils.fromJson<CallRequest<JsonObject>>(requestJson, object : TypeToken<CallRequest<JsonObject>>() {}.type)
         runCatching {
             val response = when (request.method) {
+                CallMethod.audioStop -> {
+                    AudioPlayerUtil.stop()
+                    val response = request.createResponse(0, data = null)
+                    response
+                }
+
+                CallMethod.audioPlayFromFile -> {
+                    val filePath = request.arguments?.get("filePath")?.asString ?: ""
+                    val volume = request.arguments?.get("volume")?.asFloat
+                    val useAbsoluteVolume = request.arguments?.get("useAbsoluteVolume")?.asBoolean ?: false
+                    AssistsService.instance?.let {
+                        val completableDeferred = CompletableDeferred<Exception?>()
+                        AudioPlayerUtil.playFromFile(
+                            it, filePath, volume = volume,
+                            useAbsoluteVolume = useAbsoluteVolume,
+                            listener = object : AudioPlayerUtil.PlayListener {
+                                override fun onError(error: String) {
+                                    completableDeferred.complete(RuntimeException(error))
+                                }
+
+                                override fun onCompletion() {
+                                    completableDeferred.complete(null)
+                                }
+                            })
+                        val result = completableDeferred.await()
+                        val response = request.createResponse(
+                            if (result == null) 0 else -1,
+                            data = if (result == null) "播放完成" else "播放失败: ${result.message}"
+                        )
+                        response
+                    } ?: let {
+                        val response = request.createResponse(-1, data = "无障碍服务无效")
+                        response
+                    }
+                }
+
                 CallMethod.download -> {
                     val url = request.arguments?.get("url")?.asString ?: ""
                     AssistsService.instance?.let {

assists-web/src/main/java/com/ven/assists/web/CallMethod.kt

@@ -65,5 +65,7 @@ object CallMethod {
     const val keepScreenOn = "keepScreenOn"
     const val clearKeepScreenOn = "clearKeepScreenOn"
     const val download = "download"
+    const val audioPlayFromFile = "audioPlayFromFile"
+    const val audioStop = "audioStop"
 
 }