更新记录

1.0.0（2026-10-28）

• 新增实况照片与普通图片统一展示组件，支持封面展示、点按播放动态视频和播放结束回到封面。
• 新增自动播放、单次播放、循环、静音、等比显示与填满模式，以及 play、stop、reload 控制方法。
• 新增内容流同组互斥播放、active 状态控制，以及滚动、页面隐藏、换源和卸载时的停止与资源释放处理。
• 新增 Android、iOS、Harmony 系统播放器适配，具体宿主支持范围见使用说明。
• 新增 App 原生黑底全屏预览，支持图片等比居中、实况播放按钮、普通图预览和关闭入口。
• 新增 openLivePhotoPreview、closeLivePhotoPreview 与一次性 onClose 回执，支持预览会话管理、重复关闭识别和真实错误反馈。
• 新增封面加载、视频开始、停止、结束和失败事件，提供请求关联编号及可序列化错误快照。
• 新增按操作查询的能力检测、统一错误码和有界脱敏诊断快照，明确区分可用能力与未实现业务。
• 新增 uni-app Vue2/Vue3 与 uni-app x 单页示例，集中提供展示播放、全屏预览和接口诊断。
• 新增完整诊断报告、一键复制日志、固定快照分段及复制失败的手动回退，保留环境信息、操作记录和错误详情。

平台兼容性

uni-app(5.33)

uni-app x(5.33)

实况照片展示与全屏预览

介绍

lizhao-live-photo 为 uni-app 与 uni-app x 提供实况照片内容流展示和 App 本地媒体全屏预览。传入已有的封面与动态视频，即可实现点按播放、同组互斥、循环、静音，以及黑底全屏查看；普通图片也可使用同一套展示组件。

当前能力集中在展示与预览，不提供系统相册选择、原件识别与提取、拍摄、保存或分享。相关预留接口的可用状态、参数和失败处理统一列在“API 用途速查”，宿主与平台范围见“注意事项”。

功能特色

适合哪些场景

系统相册选取、实况拍摄、原件提取、保存到图库、系统分享及普通视频转实况不在当前可用功能范围内。远端资源的下载、缓存和业务上传由接入方自行处理。

下载与导入

全屏预览由插件直接呈现，不需要另建预览页面或增加全屏路由。示例的自动播放、静音和循环开关会真实传入 API。普通资源热更新或 WGT 无法把缺失的原生插件加入旧基座，出现 undefined class 时应先核对当前基座是否包含插件。

从基础到进阶：按业务模块使用

模块一：运行内容流展示

先运行“下载与导入”中对应宿主的示例入口，在“展示播放”中核对实况 A/B、普通图、替换、移除恢复和同组停止。以下是可复制到已注册页面的最小组件示例；样本 helper 只提供随包媒体描述，业务接入时将 sample 替换为自己的 LivePhotoMediaItem。

uni-app x 页面：

<template>
  <view>
    <lizhao-live-photo :media="sample" group-id="sample-preview" :active="active"
      @load="viewEvent" @play="viewEvent" @stop="viewEvent"
      @ended="viewEvent" @error="viewEvent" />
  </view>
</template>
<script setup lang="uts">
import { ref } from 'vue'
import { LivePhotoMediaItem, LivePhotoViewEvent } from '@/uni_modules/lizhao-live-photo'
import { getLivePhotoFeedSample } from '@/uni_modules/lizhao-live-photo/example/sample-media.uts'

const sample = ref<LivePhotoMediaItem>(getLivePhotoFeedSample('展示样本'))
const active = ref(true)
function viewEvent(event: LivePhotoViewEvent): void {
  console.log(event.name, event.requestId, event.reason)
  const error = event.error
  if (error != null) console.error(error.errCode, error.errMsg, error.nativeCause)
}
onHide(() => { active.value = false })
onShow(() => { active.value = true })
</script>

uni-app Vue2/Vue3 页面：

<template>
  <view>
    <lizhao-live-photo :media="sample" group-id="sample-preview" :active="active"
      @load="viewEvent" @play="viewEvent" @stop="viewEvent"
      @ended="viewEvent" @error="viewEvent" />
  </view>
</template>
<script>
import { getLivePhotoFeedSample } from '@/uni_modules/lizhao-live-photo/static/sample-media.js'
export default {
  data() { return { sample: getLivePhotoFeedSample('展示样本'), active: true } },
  onHide() { this.active = false },
  onShow() { this.active = true },
  methods: {
    viewEvent(event) {
      console.log(event.name, event.requestId, event.reason)
      if (event.error != null) console.error(event.error.errCode, event.error.errMsg, event.error.nativeCause)
    }
  }
}
</script>

load 只证明封面实际读入，不能证明视频可播放或原件可保存；play 等待视频真实进度或原生首帧。样本没有音轨，切换 muted=false 也不会产生声音。样本的 fixture-display-* 标识不是业务注册句柄，originalResources 为空，不可用于保存、上传或恢复实况。

列表滚动与页面隐藏时应把对应条目的 active 设为 false。uni-app x App 当前没有通用自动可视观察，完整示例用滚动事件停止播放、滚动结束后恢复可点击状态，并在页面隐藏时持续停止；业务应结合自己的列表可见性更新 active。恢复 active 不会自动恢复此前已停止的播放。

模块二：调用 App 原生全屏预览

下面是接收已准备媒体的uni-app x调用函数；下文提供双宿主打开/关闭代码及生命周期说明，完整可运行页面是 uni_modules/lizhao-live-photo/example/uniappx/index.uvue 与 uni_modules/lizhao-live-photo/example/uniapp/index.vue。

import { openLivePhotoPreview, closeLivePhotoPreview, OpenLivePhotoPreviewOptions, LivePhotoMediaItem } from '@/uni_modules/lizhao-live-photo'

let currentPreviewId = ''
let previewPageDisposed = false
function showFullscreen(media: LivePhotoMediaItem): string {
  const options: OpenLivePhotoPreviewOptions = {
    media, autoplay: false, muted: true, loop: false,
    success: (result) => {
      if (previewPageDisposed) {
        closeLivePhotoPreview({ previewId: result.previewId,
          fail: (error) => { console.error(error.errCode, error.errMsg) } })
        return
      }
      currentPreviewId = result.previewId
      console.log('窗口与封面已就绪', result.previewId)
    },
    fail: (error) => { console.error(error.requestId, error.errCode, error.errMsg) },
    complete: (summary) => { console.log(summary.requestId, summary.status) },
    onClose: (event) => {
      if (currentPreviewId == event.previewId) currentPreviewId = ''
      console.log('预览已关闭', event.previewId, event.reason)
    }
  }
  return openLivePhotoPreview(options)
}
function closeFullscreen(): string | null {
  if (currentPreviewId.length == 0) return null
  const id = currentPreviewId
  return closeLivePhotoPreview({
    previewId: id,
    success: (result) => {
      if (currentPreviewId == result.previewId) currentPreviewId = ''
      console.log(result.closed, result.alreadyClosed)
    },
    fail: (error) => { console.error(error.errCode, error.errMsg) },
    complete: (summary) => { console.log(summary.requestId, summary.status) }
  })
}
onUnload(() => { previewPageDisposed = true; closeFullscreen() })

调用前停止列表播放；完整示例会结合页面是否仍可见、是否已卸载、是否仍有预览来恢复active，避免返回或迟到回调重启列表。API默认autoplay=true，上例显式false，让用户点左下实况按钮播放；muted默认true、loop默认false。普通图只展示封面。open的success只表示全屏可见且封面真实加载，不代表视频已播放或实况原件有效；complete是此次打开的终态，onClose是打开成功后实际关闭的一次通知。

media与source恰传一个非空来源；不要给上例再加source。media不执行原件识别、资源注册或远端下载，fixture-display-*仍只是展示关联标识，不可拿来保存/上传。source分支校验后仍返回未实现错误。Web、小程序不提供原生全屏；Harmony提供本地media预览。

普通uni-app Vue2/Vue3可在已有选项式页面使用以下方法；实参media复用业务已有的LivePhotoMediaItem，三个播放开关显式传值。完整生命周期、列表active与日志处理见对应宿主的示例入口。

import { openLivePhotoPreview, closeLivePhotoPreview } from '@/uni_modules/lizhao-live-photo'
export default {
  data() { return { previewId: '', previewDisposed: false } },
  onUnload() { this.previewDisposed = true; this.closePreview() },
  methods: {
    preview(media) {
      return openLivePhotoPreview({
        media, autoplay: false, muted: true, loop: false,
        success: (result) => {
          if (this.previewDisposed) {
            closeLivePhotoPreview({ previewId: result.previewId,
              fail: error => console.error(error.errCode, error.errMsg) })
            return
          }
          this.previewId = result.previewId
        },
        fail: error => console.error(error.errCode, error.errMsg),
        onClose: event => {
          if (this.previewId === event.previewId) this.previewId = ''
        }
      })
    },
    closePreview() {
      if (this.previewId.length === 0) return null
      return closeLivePhotoPreview({
        previewId: this.previewId,
        success: result => { if (this.previewId === result.previewId) this.previewId = '' },
        fail: error => console.error(error.errCode, error.errMsg)
      })
    }
  }
}

模块三：先检查真实能力

在两种宿主页面的脚本中使用相同根入口：

import { getLivePhotoCapabilities } from '@/uni_modules/lizhao-live-photo'

const capability = getLivePhotoCapabilities()
console.log(capability.available, capability.reason)

Android/iOS/Harmony 的能力查询只检测原生全屏预览的呈现宿主：implementation=native-preview，具备有效前台宿主时 available 可为 true，operations 中的 preview 为 available。这不检测文件可读性、空闲状态或原件是否为实况，调用仍可能失败。其他操作为 unavailable，deviceSupport=unknown、permissionsChecked=false。Web/小程序的业务 API 为 contract-only 与 unsupported；Web 组件展示独立于此能力查询。Harmony 也只展示已准备的 media，不识别 MovingPhoto 原件。

模块四：读取诊断与复制完整报告

从插件根入口读取诊断快照。若要包含某次异步调用的终态，在该调用的 complete 中再次读取。

import { getLivePhotoDiagnostics } from '@/uni_modules/lizhao-live-photo'

const diagnostics = getLivePhotoDiagnostics()
console.log(diagnostics.pendingCount, diagnostics.droppedCount)

页面底部“一键复制日志”包含环境、插件诊断和本次会话全部保留记录，并非仅最近8条摘要；缓存上限1000条/1MiB，截断及丢弃会注明。完整报告带报告编号、生成时间/时区、条数、长度和首尾标记。长报告可在同一固定快照上逐段复制，仅实际成功才推进；复制失败显示真实原因及可手动全选的报告/分段，不清空原日志。三个Tab切换不重建报告或清复制位置。包内无法取得的HX/编译器/基座构建版本明确unknown，不用作者电脑信息冒充客户包版本；路径、URL、错误和参数在缓存、显示及复制前脱敏。

模块五：预留选择与权限入口的错误处理

uni-app 普通 Vue 页面可在 methods 中直接执行：

import { chooseLivePhoto } from '@/uni_modules/lizhao-live-photo'

const requestId = chooseLivePhoto({
  count: 9,
  sourceType: ['album'],
  allowNormalImage: true,
  timeoutMs: 120000,
  success(result) { console.log(result.requestId, result.tempFiles.length) },
  fail(error) { console.log(error.errSubject, error.errCode, error.errMsg) },
  complete(summary) { console.log(summary.requestId, summary.status) }
})
console.log('调用已返回', requestId)

uni-app x 页面先建立根导出的 Options 类型：

import { chooseLivePhoto, ChooseLivePhotoOptions } from '@/uni_modules/lizhao-live-photo'

const options: ChooseLivePhotoOptions = {
  count: 9,
  sourceType: ['album'],
  fail: (error) => { console.log(error.errCode, error.errMsg) },
  complete: (summary) => { console.log(summary.requestId, summary.status) }
}
const requestId = chooseLivePhoto(options)
console.log(requestId)

当前合法参数只会异步触发 fail，然后 complete；不会打开相册，不会调用 success。取消入口已提供参数与明确失败合同，尚不取消实际任务；原生实况资源与系统相册回读尚未接入。complete 是终态摘要，媒体成功结果只由 success 提供，不能把它当作 uni.chooseImage 的完整替代返回值。

后续实况结果将同时提供封面兼容路径 tempFilePaths 和完整媒体项 tempFiles。业务发布需保留动态视频、原始资源与关联信息，不能只上传封面；这些结果当前仅有类型合同，尚无生成实现。

权限入口同样保留明确失败处理，当前不会弹出授权窗口：

import { requestLivePhotoPermissions, getLivePhotoDiagnostics } from '@/uni_modules/lizhao-live-photo'

requestLivePhotoPermissions({
  operations: ['choose'],
  fail: (error) => { console.log(error.errCode, error.errMsg) },
  complete: (summary) => { console.log(summary.status) }
})
const diagnostics = getLivePhotoDiagnostics()
console.log(diagnostics.pendingCount)

需要本次失败终态后的诊断时，在 complete 回调中读取快照。

模块六：预留媒体业务的失败处理

下面的 UTS 代码可放在 uni_modules/lizhao-live-photo/example/uniappx/index.uvue 的脚本中按需调用；普通 uni-app 的 uni_modules/lizhao-live-photo/example/uniapp/index.vue 使用相同根 API，可去掉 UTS 类型注解。inspectExistingSource 的 source 必须来自客户实际持有的路径、完整 URI 或本插件后续生成的资源句柄。随包样本仅用于组件/全屏展示，不是inspect、保存或上传的成功业务资源。

import {
  inspectLivePhoto, captureLivePhoto, LivePhotoSource, InspectLivePhotoOptions,
  CaptureLivePhotoOptions
} from '@/uni_modules/lizhao-live-photo'

function inspectExistingSource(source: LivePhotoSource): string {
  const options: InspectLivePhotoOptions = {
    source: source,
    fail: (error) => { console.log(error.requestId, error.errCode, error.errMsg) },
    complete: (summary) => { console.log(summary.status) }
  }
  return inspectLivePhoto(options)
}

const captureOptions: CaptureLivePhotoOptions = {
  lens: 'back',
  audioMode: 'required',
  beforeMs: 1500,
  afterMs: 1500,
  allowPlatformDuration: true,
  fail: (error) => { console.log(error.requestId, error.errCode, error.errMsg) },
  complete: (summary) => { console.log(summary.status) }
}
const captureRequestId = captureLivePhoto(captureOptions)
console.log(captureRequestId)

当前拍摄入口不会打开相机或申请麦克风权限。识别、提取、清单、准备、保存、分享、取消和释放仍先校验，立即返回requestId，再异步fail、complete。传入结构合法的描述不会证明文件存在、配对有效或媒体可播放。全屏预览的media分支已接入App原生，见“调用 App 原生全屏预览”；source分支仍明确不可用。

模块七：安全处理同步 Outcome

下面代码同样只使用插件根入口。先检查 ok，再检查 result/error；不能把返回对象本身当作订阅成功或配置已生效。

import {
  onLivePhotoProgress, offLivePhotoProgress, setLivePhotoDiagnostics,
  LivePhotoProgressEvent
} from '@/uni_modules/lizhao-live-photo'

const subscription = onLivePhotoProgress((event: LivePhotoProgressEvent) => {
  console.log(event.requestId, event.stage, event.progress)
})
const subscribed = subscription.result
if (subscription.ok && subscribed != null) {
  const removal = offLivePhotoProgress(subscribed.subscriptionId)
  console.log(removal.ok)
} else {
  const error = subscription.error
  if (error != null) console.log(error.requestId, error.errCode, error.errMsg)
}

const configuration = setLivePhotoDiagnostics({ level: 'info', includeNativeDetails: false })
const configurationError = configuration.error
if (!configuration.ok && configurationError != null) {
  console.log(configurationError.requestId, configurationError.errCode, configurationError.errMsg)
}

当前这三个同步入口始终返回 ok=false、result=null、非空 error；合法参数得到不可用/不支持错误，非法参数得到参数错误。每次调用有独立的诊断关联 ID，可从 error.requestId 关联日志，但不会创建原生任务。cancelLivePhotoTask、releaseLivePhotoResources 也仍不可用：调用后不影响已排队选择/权限请求的终态，不删除文件，不假装已取消或已释放。

API 用途速查

内容流组件参数、方法与事件

标签为 lizhao-live-photo。组件原位展示与全屏API分别验收；能力快照只将已接入的App preview按有效宿主返回available，不因组件样本播放改变选择、识别、准备或保存等操作状态。

组件实例方法 play()、stop()、reload() 均无参数、无业务成功返回值：分别请求原位播放、停止回封面、重新读取当前来源；应以事件判断实际结果。普通图只加载封面，调用 play 不制造实况。media 替换、清空或组件卸载会失效旧播放代际，迟到回执不能恢复旧条目。

事件 load/play/stop/ended/error 的参数均为 LivePhotoViewEvent，字段是 name/mediaId/resourceId/requestId/reason/error。load 为封面读入，play 为真实视频进度/原生首帧，stop 为停止，ended 为非循环播放实际结束；error 为真实校验、读取、超时、解码或桥接失败。终态保留对应播放的 requestId，不能把 stop/ended/error 误关联到下一次播放。

error 为 null 或可序列化的 LivePhotoErrorSnapshot，不跨视图传递原生异常对象。其 operation 为 preview，包含 errSubject/errCode/errMsg/requestId/stage；可取得的原生安全分类、异常类型和数字错误码进入 nativeType/nativeCause，未采集堆栈明确标为 unknown。浏览器原始错误、媒体路径和 URL 签名不直接进入事件或报告。

通用异步参数与默认值

选择、权限、识别、提取与上传清单参数

来源与远端展示参数

远端 image 必须 protocol=none 且没有动态视频；live-photo 必须有展示视频并使用三种已知实况协议之一。签名 URL 的查询内容保持原值用于后续请求，不进入日志。上述检查只确认声明结构；HTTPS外形、角色齐全或摘要格式合法都不证明网络可达、真实字节匹配、格式正确或配对有效，后续必须按实际下载与原生识别结果核验。

拍摄与预览参数

media至少提供非空mediaId/resourceId、coverPath及明确mediaType/isLivePhoto：live-photo要求非空videoPath，image要求isLivePhoto=false、videoPath=null。传入完整LivePhotoMediaItem，不把描述合法当成原件已鉴定；App只处理可访问本地资源。open/close的timeoutMs均默认120000毫秒，范围1000–600000有限整数。

onClose事件包含previewId、resourceId、mediaId、reason，reason为user/api/background/destroyed/error。用户退出、程序关闭、后台和宿主销毁均停止并释放预览；播放结束只回封面，不等于关闭。打开前便关闭走9346004的fail及complete(cancelled)，不再派发onClose。成功打开后的播放错误进入Native状态诊断，不重新完成原open。

保存、分享、取消与释放参数

同步控制参数

返回值、回调与类型

13个异步入口同步返回本次唯一requestId，随后异步派发结果。success/fail互斥且各至多一次，complete随后至多一次；回调抛错隔离并记录安全分类，complete仍执行。非法参数优先9346001。尚未实现的业务和预览source分支，合法参数在App仍9346003、Web/小程序9346002；App预览media/关闭分支则按真实Native回执返回。

LivePhotoCompletion包含errSubject、errCode、errMsg、operation、requestId、status；status为success/failed/cancelled/unknown。App全屏可实际产生成功、失败、打开前取消和关闭结果未知；其他未实现入口仍failed。每个成功Result含errMsg与requestId；除全屏打开/关闭外，下表成功字段仍为后续合同，不代表已生成资源。

LivePhotoMediaItem 包含 resourceId、mediaId、path、coverPath、size、mediaType、isLivePhoto、videoPath、videoByteSize、durationMs、width、height、hasAudio、protocol、temporary、originalResources、pairing；path/coverPath 是封面兼容路径。LivePhotoOriginalResource 包含 role、path、mimeType、byteSize、sha256。字节、像素、毫秒各用对应单位，未知的可空字段返回 null。resourceId 是进程管理的本地句柄，不是 mediaId、assetId 或远端 URL。

LivePhotoUploadManifest 包含 schemaVersion、resourceId、mediaId、mediaType、protocol、pairing、width、height、durationMs、cover、playbackVideo、originalResources。cover 是必有封面描述；playbackVideo 可为 null；originalResources 保存原件，不因已上传展示视频而删除。客户上传完成后自行构造 LivePhotoRemoteMedia，业务存储和上传服务不由本插件提供。

同步 Outcome 都有 ok、result、error，error 为 LivePhotoErrorSnapshot。后续成功时订阅结果含 subscriptionId，解除结果含 subscriptionId/removed，诊断配置结果含 level/includeNativeDetails；当前全部 ok=false、result=null，错误优先级与异步入口一致。这三个调用不会抛出业务错误，不通过 success/fail/complete 派发结果，也不创建原生任务。

LivePhotoProgressEvent 包含 requestId、operation、stage、timeMs、progress、completedBytes、totalBytes；timeMs为真实事件时间，progress为0–1比例，未知进度/字节数为null。当前无订阅成功或业务进度事件。LivePhotoViewOptions/LivePhotoViewEvent用于内容流展示；组件事件、业务进度订阅和全屏的一次性onClose互相独立。

页面保存错误时可使用根入口导出的 LivePhotoErrorSnapshot 对象类型。LivePhotoFail 是插件内部错误实现接口，uvue 不直接导入该 interface 或对它做 instanceof。字段、参数、终态与资源约束见本节各表，原生接入要求见“注意事项”。

诊断默认最多1000条、1MiB估算预算，覆盖/丢弃累计droppedCount，快照独立于内部缓存。App诊断implementation为native-preview，entries记录全屏Native固定状态、打开/关闭终态及关闭原因；原生权限、完整堆栈和SDK快照未采集时明确unknown。两种宿主的单页示例把组件事件、全屏回调与关闭状态汇入完整报告。插件版本从package.json校验，客户包HX、编译器、基座等未知时保留unknown与来源。

全屏最多一个原生会话；重复打开可返回9346010。关闭成功ID由原生保留近期记录用于幂等（Android/iOS最近64项，Harmony最近32项），历史淘汰或跨进程后不能承诺alreadyClosed；未知ID为9346015。UTS关闭等待不到回执为9346016、complete(unknown)，不能当作已关闭或盲目重开；Native能确认仍可见的关闭超时可返回9346009。详细恢复条件见“调用 App 原生全屏预览”小节。

错误码说明

errSubject固定为 lizhao-live-photo。未实现业务仍主要返回参数/不支持/未实现错误；组件和App全屏可实际产生读取、取消、忙碌、超时、解码、桥接、未知预览ID及结果未知。标为保留的业务错误不表示对应能力已实现。

注意事项

宿主与平台范围

下表的支持范围仅指已有封面/视频的展示和预览，不包含系统相册、原件识别、拍摄、保存或分享。清单中“√”表示对应范围支持，“-”表示仍需验证，“x”表示不支持。

资源、权限与生命周期

• 组件与 App 全屏读取显式传入的封面/视频。App 使用本地可读资源，接入方负责资源来源、访问授权、远端下载和缓存；播放成功不能证明原件具有有效实况配对，也不能直接用于保存或恢复实况。
• 展示能力不自动扫描相册，不额外申请照片、相机、麦克风或存储权限，不自动上传媒体或日志。系统相册、拍摄和保存的权限接口仍未实现，不能用它们申请授权。
• 使用 Android/iOS/Harmony 系统播放器，没有第三方播放器 SDK 依赖；文件格式、编码、系统版本与实际设备能力仍需匹配。随包视频没有音轨，不能用它验证真实音轨的静音效果，也不承诺任意品牌图库或分享渠道兼容。
• 列表滚动或页面隐藏时将 active 设为 false；全屏打开前停止列表播放，实际关闭后再按页面状态恢复交互。换源、移除与卸载时保留停止/释放和错误处理；恢复 active 不会自动重播。
• 初次接入、更改原生 UTS、依赖或配置后，必须原生联编或重打自定义基座。appResource/WGT 只能更新资源，不能替换旧包中的原生实现；出现入口类缺失先核对基座是否包含本插件。
• 全屏关闭无回执时可能返回 9346016 与 complete(unknown)，先核实界面状态，不把结果未知当作关闭成功，不盲目重开或重复操作。
• 上传展示媒体时应由业务保留原始配对资源与关联信息；封面、展示视频和插件资源句柄不可相互替代。

预留接口与 iOS 参数限制

相册选择、识别、提取、上传清单、展示准备、拍摄、保存、分享、任务取消和资源释放接口仍未实现。进度订阅、解除订阅和诊断配置也仍返回失败 Outcome；组件自身的播放事件、原生资源释放和基础诊断不依赖这些预留入口。

iOS 的 Vue2 全屏调用应显式传入 autoplay、muted、loop，避免原生代理的缺省布尔值改变预期；uni-app x Vapor/Vue3 已配置默认值拦截。原生 VDOM 直接调用仍待验证。iOS 预留进度接口的缺省/null listener 在代理中可能被包装为闭包，参数错误的区分仍待验证；该业务入口保持不可用。

日志与验收边界

示例底部提供完整日志、固定快照分段和复制失败时的手动回退。报告的 unknown 表示信息未取得，不能当作检测成功；日志默认脱敏，不包含客户媒体内容，复制由用户主动触发。

平台表中的真机结果不代表其他设备、完整业务链或所有异常路径已验收。系统剪贴板完整回读、长报告分段重组和复制失败的设备路径仍需单独验证；Harmony 已取得一键复制的真实系统 API 成功回执。接入自己的项目后，应按实际宿主验证播放、关闭、错误和报告内容。

作者系列 UTS 插件

以下为作者已发布的其他 UTS 插件，可按能力方向查找。