{"id":105600,"date":"2026-09-15T17:24:37","date_gmt":"2026-09-15T09:24:37","guid":{"rendered":"https:\/\/www.wsisp.com\/helps\/105600.html"},"modified":"2026-09-15T17:24:37","modified_gmt":"2026-09-15T09:24:37","slug":"harmonyos-7-%e6%96%b0%e7%89%b9%e6%80%a7%ef%bc%88%e4%b8%83%e5%8d%81%e4%b9%9d%ef%bc%89%ef%bd%9c%e6%89%a9%e5%b1%95%e5%85%83%e6%95%b0%e6%8d%ae%e5%af%b9%e8%b1%a1%ef%bc%9a%e8%83%bd%e5%8a%9b%e6%9f%a5","status":"publish","type":"post","link":"https:\/\/www.wsisp.com\/helps\/105600.html","title":{"rendered":"HarmonyOS 7 \u65b0\u7279\u6027\uff08\u4e03\u5341\u4e5d\uff09\uff5c\u6269\u5c55\u5143\u6570\u636e\u5bf9\u8c61\uff1a\u80fd\u529b\u67e5\u8be2\u4e0e\u5e27\u5173\u8054"},"content":{"rendered":"

HarmonyOS 7 \u5df2\u8fdb\u5165 26.0.0 Release \u9636\u6bb5\u3002Camera Kit \u7684\u672c\u6b21\u80fd\u529b\u9002\u5408\u89e3\u51b3\u201c\u4e13\u4e1a\u76f8\u673a\u5e94\u7528\u9700\u8981\u6d88\u8d39\u5382\u5546\u6216\u7b97\u6cd5\u6269\u5c55\u7684\u5143\u6570\u636e\u8f85\u52a9\u66dd\u5149\u4e0e\u8d28\u91cf\u8bca\u65ad\u201d\u8fd9\u4e00\u7c7b\u771f\u5b9e\u95ee\u9898，\u4f46\u9ad8\u8d28\u91cf\u63a5\u5165\u7edd\u4e0d\u662f\u590d\u5236\u4e00\u6bb5 API \u8c03\u7528：\u8fd8\u8981\u8865\u9f50\u80fd\u529b\u95e8\u7981\u3001\u9886\u57df\u5951\u7ea6\u3001\u72b6\u6001\u673a\u3001\u5f02\u5e38\u6062\u590d\u3001\u5b89\u5168\u9690\u79c1\u3001\u6027\u80fd\u9884\u7b97\u4e0e\u771f\u673a\u9a8c\u6536\u3002<\/p>\n

\u672c\u6587\u56f4\u7ed5 \u6269\u5c55\u5143\u6570\u636e\u5bf9\u8c61：\u80fd\u529b\u67e5\u8be2\u4e0e\u5e27\u5173\u8054 \u7ed9\u51fa\u4e00\u5957\u5de5\u7a0b\u5316\u65b9\u6848\u3002\u4ee3\u7801\u4ee5\u5e94\u7528\u5c42\u62bd\u8c61\u4e3a\u4e3b，\u771f\u5b9e\u7cfb\u7edf\u63a5\u53e3\u540d\u79f0\u3001\u679a\u4e3e\u548c\u503c\u57df\u5fc5\u987b\u4ee5\u5f53\u524d 26.0.0 SDK \u7684 d.ts\/\u5934\u6587\u4ef6\u53ca\u5b98\u65b9\u6307\u5357\u4e3a\u51c6\u3002<\/p>\n

\u4e00\u3001\u5148\u5398\u6e05\u7248\u672c\u4e0e\u80fd\u529b\u8fb9\u754c<\/h3>\n

26.0.0 Beta2 \u9636\u6bb5\u7684 Camera Kit C API \u65b0\u589e\u5143\u6570\u636e\u5bf9\u8c61\u6269\u5c55\u6982\u5ff5\u58f0\u660e，\u5177\u4f53\u7ed3\u6784\u4ee5 Release \u5934\u6587\u4ef6\u4e3a\u51c6\u3002<\/p>\n

\u201c\u51fa\u73b0\u5728\u7248\u672c\u8bf4\u660e\u91cc\u201d\u4e0d\u7b49\u4e8e\u6240\u6709\u8bbe\u5907\u3001\u5730\u533a\u3001\u5e94\u7528\u5f62\u6001\u90fd\u65e0\u6761\u4ef6\u652f\u6301\u3002\u6b63\u5f0f\u5f00\u53d1\u524d\u8981\u8bb0\u5f55 DevEco Studio\u3001SDK\u3001\u7cfb\u7edf\u5c0f\u7248\u672c\u3001\u8bbe\u5907\u578b\u53f7\u548c\u7b7e\u540d\u914d\u7f6e，\u5e76\u901a\u8fc7\u7cfb\u7edf\u80fd\u529b\u3001\u6743\u9650\u4e0e\u8fd0\u884c\u65f6\u63a2\u6d4b\u51b3\u5b9a\u5165\u53e3\u662f\u5426\u53ef\u7528\u3002Beta \u9636\u6bb5\u5f15\u5165\u7684\u80fd\u529b\u8fd8\u8981\u518d\u6b21\u6838\u5bf9 Release \u662f\u5426\u6539\u540d\u3001\u8c03\u6574\u53c2\u6570\u6216\u6539\u53d8\u9519\u8bef\u7801\u3002<\/p>\n

interface<\/span> CapabilitySnapshot<\/span> {<\/span>
\n apiVersion:<\/span> number<\/span>
\n releaseVersion:<\/span> string<\/span>
\n systemCapability:<\/span> boolean<\/span>
\n permissionGranted:<\/span> boolean<\/span>
\n deviceEligible:<\/span> boolean<\/span>
\n}<\/span><\/p>\n

function<\/span> isReady<\/span>(<\/span>value:<\/span> CapabilitySnapshot)<\/span>:<\/span> boolean<\/span> {<\/span>
\n return<\/span> value.<\/span>apiVersion >=<\/span> 26<\/span> &&<\/span> value.<\/span>systemCapability &&<\/span>
\n value.<\/span>permissionGranted &&<\/span> value.<\/span>deviceEligible
\n}<\/span><\/p>\n

\u4e0d\u652f\u6301\u3001\u6743\u9650\u62d2\u7edd\u3001\u7b56\u7565\u7981\u6b62\u548c\u4e34\u65f6\u5931\u8d25\u8981\u5206\u522b\u8868\u8fbe\u3002\u7528\u6237\u5e94\u770b\u5230\u771f\u5b9e\u539f\u56e0\u4e0e\u66ff\u4ee3\u8def\u5f84，\u800c\u4e0d\u662f\u7edf\u4e00\u7684\u201c\u64cd\u4f5c\u5931\u8d25\u201d\u3002<\/p>\n

\u4e8c\u3001\u4ece\u4e1a\u52a1\u4efb\u52a1\u5361\u5b9a\u4e49\u6210\u529f<\/h3>\n

\u672c\u6587\u4e1a\u52a1\u573a\u666f\u662f：\u4e13\u4e1a\u76f8\u673a\u5e94\u7528\u9700\u8981\u6d88\u8d39\u5382\u5546\u6216\u7b97\u6cd5\u6269\u5c55\u7684\u5143\u6570\u636e\u8f85\u52a9\u66dd\u5149\u4e0e\u8d28\u91cf\u8bca\u65ad\u3002\u4e3b\u64cd\u4f5c\u4e3a\u201c\u89e3\u6790\u76f8\u673a\u6269\u5c55\u5143\u6570\u636e\u5e76\u4e0e\u5bf9\u5e94\u7167\u7247\u6216\u89c6\u9891\u5e27\u7ed1\u5b9a\u201d\u3002\u6210\u529f\u6807\u51c6\u81f3\u5c11\u5305\u62ec：\u76ee\u6807\u7ed3\u679c\u6b63\u786e\u3001\u7528\u6237\u53ef\u53d6\u6d88\u3001\u8fdb\u7a0b\u91cd\u542f\u53ef\u6062\u590d\u3001\u91cd\u590d\u56de\u8c03\u4e0d\u7834\u574f\u7ec8\u6001\u3001\u6027\u80fd\u6307\u6807\u53ef\u5ea6\u91cf\u3001\u9690\u79c1\u6570\u636e\u672a\u8d8a\u754c\u3002<\/p>\n

interface<\/span> CameraMetadataPacketSpec<\/span> {<\/span>
\n captureId:<\/span> string<\/span>
\n frameNumber:<\/span> string<\/span>
\n metadataType:<\/span> string<\/span>
\n timestampNs:<\/span> number<\/span>
\n requestId:<\/span> string<\/span>
\n createdAt:<\/span> number<\/span>
\n}<\/span><\/p>\n

interface<\/span> DomainResult<<\/span>T<\/span>><\/span><\/span> {<\/span>
\n ok:<\/span> boolean<\/span>
\n value?<\/span>:<\/span> T<\/span>
\n errorCode?<\/span>:<\/span> string<\/span>
\n retryable:<\/span> boolean<\/span>
\n}<\/span><\/p>\n

\u975e\u76ee\u6807\u4e5f\u8981\u5199\u6e05：\u4e0d\u7ed5\u8fc7\u7cfb\u7edf\u6743\u9650，\u4e0d\u5728\u4e0d\u652f\u6301\u8bbe\u5907\u4f2a\u9020\u6210\u529f，\u4e0d\u628a\u5e73\u53f0\u5bf9\u8c61\u76f4\u63a5\u66b4\u9732\u7ed9\u9875\u9762，\u4e0d\u7528\u7528\u6237\u539f\u59cb\u6570\u636e\u6362\u53d6\u66f4\u65b9\u4fbf\u7684\u8c03\u8bd5\u3002<\/p>\n

\u4e09\u3001\u9886\u57df\u5c42\u9694\u79bb\u7cfb\u7edf API \u53d8\u5316<\/h3>\n

\u9875\u9762\u53ea\u4f9d\u8d56\u7a33\u5b9a\u7684\u9886\u57df\u7aef\u53e3，\u5e73\u53f0\u9002\u914d\u5668\u8d1f\u8d23\u80fd\u529b\u67e5\u8be2\u3001\u6743\u9650\u3001\u7cfb\u7edf API\u3001\u9519\u8bef\u7801\u7ffb\u8bd1\u548c\u8d44\u6e90\u91ca\u653e\u3002\u8fd9\u6837 SDK \u5c0f\u7248\u672c\u53d8\u5316\u65f6，\u4e0d\u5fc5\u4fee\u6539\u6240\u6709\u4e1a\u52a1\u9875\u9762\u3002<\/p>\n

interface<\/span> CameraMetadataPacketPort<\/span> {<\/span>
\n probe<\/span>(<\/span>)<\/span>:<\/span> Promise<\/span><<\/span>CapabilitySnapshot><\/span>
\n start<\/span>(<\/span>spec:<\/span> CameraMetadataPacketSpec,<\/span> signal:<\/span> AbortSignal)<\/span>:<\/span> Promise<\/span><<\/span>DomainResult<<\/span>string<\/span>>><\/span>
\n stop<\/span>(<\/span>sessionId:<\/span> string<\/span>,<\/span> reason:<\/span> string<\/span>)<\/span>:<\/span> Promise<\/span><<\/span>void<\/span>><\/span>
\n release<\/span>(<\/span>)<\/span>:<\/span> Promise<\/span><<\/span>void<\/span>><\/span>
\n}<\/span><\/p>\n

class<\/span> UnsupportedCameraMetadataPacketPort<\/span> implements<\/span> CameraMetadataPacketPort<\/span> {<\/span>
\n async<\/span> probe<\/span>(<\/span>)<\/span>:<\/span> Promise<\/span><<\/span>CapabilitySnapshot><\/span> {<\/span>
\n return<\/span> {<\/span> apiVersion:<\/span> 0<\/span>,<\/span> releaseVersion:<\/span> 'unknown'<\/span>,<\/span> systemCapability:<\/span> false<\/span>,<\/span>
\n permissionGranted:<\/span> false<\/span>,<\/span> deviceEligible:<\/span> false<\/span> }<\/span>
\n }<\/span>
\n async<\/span> start<\/span>(<\/span>)<\/span>:<\/span> Promise<\/span><<\/span>DomainResult<<\/span>string<\/span>>><\/span> {<\/span>
\n return<\/span> {<\/span> ok:<\/span> false<\/span>,<\/span> errorCode:<\/span> 'UNSUPPORTED'<\/span>,<\/span> retryable:<\/span> false<\/span> }<\/span>
\n }<\/span>
\n async<\/span> stop<\/span>(<\/span>)<\/span>:<\/span> Promise<\/span><<\/span>void<\/span>><\/span> {<\/span>}<\/span>
\n async<\/span> release<\/span>(<\/span>)<\/span>:<\/span> Promise<\/span><<\/span>void<\/span>><\/span> {<\/span>}<\/span>
\n}<\/span><\/p>\n

\u9002\u914d\u5668\u5fc5\u987b\u5c0f\u800c\u53ef\u66ff\u6362\u3002\u4e0d\u8981\u628a UI \u6587\u6848\u3001\u7f51\u7edc\u8bf7\u6c42\u3001\u6301\u4e45\u5316\u548c\u7cfb\u7edf\u56de\u8c03\u5168\u90e8\u585e\u8fdb\u4e00\u4e2a\u201cManager\u201d\u7c7b，\u5426\u5219\u5f02\u5e38\u6062\u590d\u4e0e\u6d4b\u8bd5\u90fd\u4f1a\u53d8\u5f97\u56f0\u96be\u3002<\/p>\n

\u56db\u3001\u7528\u663e\u5f0f\u72b6\u6001\u673a\u7ea6\u675f\u5f02\u6b65\u6d41\u7a0b<\/h3>\n

Camera Kit \u7684\u8c03\u7528\u53ef\u80fd\u8de8\u7ebf\u7a0b\u3001\u8de8\u8fdb\u7a0b\u6216\u8de8\u8bbe\u5907，\u56de\u8c03\u53ef\u80fd\u91cd\u590d\u3001\u4e71\u5e8f，\u751a\u81f3\u5728\u9875\u9762\u9500\u6bc1\u540e\u624d\u5230\u8fbe\u3002\u72b6\u6001\u673a\u8981\u660e\u786e\u5141\u8bb8\u7684\u8fc1\u79fb\u3001\u7ec8\u6001\u548c\u6062\u590d\u70b9\u3002<\/p>\n

type<\/span> CameraMetadataPacketState<\/span> =<\/span> 'PROBING'<\/span> |<\/span> 'CONFIGURED'<\/span> |<\/span> 'CAPTURING'<\/span> |<\/span> 'MATCHING'<\/span> |<\/span> 'DELIVERED'<\/span> |<\/span> 'DROPPED'<\/span><\/p>\n

interface<\/span> SessionSnapshot<\/span> {<\/span>
\n state:<\/span> CameraMetadataPacketState
\n revision:<\/span> number<\/span>
\n requestId:<\/span> string<\/span>
\n updatedAt:<\/span> number<\/span>
\n errorCode?<\/span>:<\/span> string<\/span>
\n}<\/span><\/p>\n

function<\/span> accepts<\/span>(<\/span>current:<\/span> SessionSnapshot,<\/span> incomingRevision:<\/span> number<\/span>)<\/span>:<\/span> boolean<\/span> {<\/span>
\n return<\/span> incomingRevision ><\/span> current.<\/span>revision
\n}<\/span><\/p>\n

\u7ec8\u6001\u53ea\u80fd\u63d0\u4ea4\u4e00\u6b21\u3002\u7528\u6237\u53d6\u6d88\u540e，\u665a\u5230\u7684\u6210\u529f\u56de\u8c03\u4e0d\u5f97\u91cd\u65b0\u6fc0\u6d3b\u4f1a\u8bdd；\u65e7 revision \u4e0d\u5f97\u8986\u76d6\u65b0\u72b6\u6001\u3002\u6bcf\u6b21\u8fc1\u79fb\u8bb0\u5f55\u539f\u56e0，\u624d\u80fd\u533a\u5206\u7528\u6237\u53d6\u6d88\u3001\u7cfb\u7edf\u62d2\u7edd\u3001\u8d85\u65f6\u4e0e\u8d44\u6e90\u538b\u529b\u3002<\/p>\n

\u4e94\u3001\u5e42\u7b49\u53f0\u8d26\u9632\u6b62\u91cd\u590d\u526f\u4f5c\u7528<\/h3>\n

\u8bbe\u5907\u8fde\u63a5\u3001\u6587\u4ef6\u5199\u5165\u3001\u7f51\u7edc\u91cd\u8bd5\u4e0e\u7cfb\u7edf\u670d\u52a1\u90fd\u6709\u91cd\u590d\u8c03\u7528\u7684\u53ef\u80fd\u3002\u7a33\u5b9a requestId \u7528\u4e8e\u67e5\u627e\u5df2\u5b8c\u6210\u7ed3\u679c；\u9700\u8981\u6062\u590d\u7684\u6700\u5c0f\u72b6\u6001\u6301\u4e45\u5316，\u5e76\u8bbe\u7f6e\u660e\u786e\u8fc7\u671f\u65f6\u95f4\u3002<\/p>\n

class<\/span> IdempotencyLedger<<\/span>T<\/span>><\/span><\/span> {<\/span>
\n private<\/span> values =<\/span> new<\/span> Map<<\/span>string<\/span>,<\/span> DomainResult<<\/span>T<\/span>>><\/span><\/span>(<\/span>)<\/span><\/p>\n

lookup<\/span>(<\/span>requestId:<\/span> string<\/span>)<\/span>:<\/span> DomainResult<<\/span>T<\/span>><\/span> |<\/span> undefined<\/span> {<\/span>
\n return<\/span> this<\/span>.<\/span>values.<\/span>get<\/span>(<\/span>requestId)<\/span>
\n }<\/span><\/p>\n

commit<\/span>(<\/span>requestId:<\/span> string<\/span>,<\/span> result:<\/span> DomainResult<<\/span>T<\/span>><\/span>)<\/span>:<\/span> void<\/span> {<\/span>
\n if<\/span> (<\/span>!<\/span>this<\/span>.<\/span>values.<\/span>has<\/span>(<\/span>requestId)<\/span>)<\/span> this<\/span>.<\/span>values.<\/span>set<\/span>(<\/span>requestId,<\/span> result)<\/span>
\n }<\/span>
\n}<\/span><\/p>\n

\u8d26\u53f7\u9000\u51fa\u3001\u4e1a\u52a1\u5bf9\u8c61\u5220\u9664\u3001\u6388\u6743\u64a4\u56de\u540e，\u5e94\u6e05\u7406\u5bf9\u5e94\u6062\u590d\u4ee4\u724c\u3002\u53f0\u8d26\u4e0d\u80fd\u6210\u4e3a\u65e0\u9650\u589e\u957f\u7684\u5f71\u5b50\u6570\u636e\u5e93\u3002<\/p>\n

\u516d\u3001\u53d6\u6d88\u3001\u8d85\u65f6\u4e0e\u91ca\u653e\u5fc5\u987b\u6210\u5bf9<\/h3>\n

\u6700\u5927\u5de5\u7a0b\u98ce\u9669\u662f：\u6309\u56fa\u5b9a\u504f\u79fb\u89e3\u6790\u672a\u77e5\u5143\u6570\u636e\u4f1a\u8d8a\u754c，\u5143\u6570\u636e\u65f6\u95f4\u6233\u548c\u56fe\u50cf\u5e27\u4e0d\u4e00\u81f4\u4f1a\u9020\u6210\u9519\u8bef\u5224\u65ad\u3002\u56e0\u6b64\u6bcf\u4e2a\u957f\u4efb\u52a1\u90fd\u8981\u7ed1\u5b9a\u53d6\u6d88\u4fe1\u53f7\u3001\u8d85\u65f6\u3001\u8d44\u6e90\u6240\u6709\u8005\u548c finally \u6e05\u7406；\u9875\u9762\u751f\u547d\u5468\u671f\u53ea\u662f\u53d6\u6d88\u6765\u6e90\u4e4b\u4e00，\u4e0d\u80fd\u4ee3\u66ff\u5e95\u5c42\u8d44\u6e90\u7ba1\u7406\u3002<\/p>\n

async<\/span> function<\/span> withTimeout<\/span><<\/span>T<\/span>><\/span><\/span><\/span>(<\/span>
\n timeoutMs:<\/span> number<\/span>,<\/span>
\n task<\/span>:<\/span> (<\/span>signal:<\/span> AbortSignal)<\/span> =><\/span> Promise<\/span><<\/span>T<\/span>><\/span>
\n)<\/span>:<\/span> Promise<\/span><<\/span>T<\/span>><\/span> {<\/span>
\n const<\/span> controller =<\/span> new<\/span> AbortController<\/span>(<\/span>)<\/span>
\n const<\/span> timer =<\/span> setTimeout<\/span>(<\/span>(<\/span>)<\/span> =><\/span> controller.<\/span>abort<\/span>(<\/span>'TIMEOUT'<\/span>)<\/span>,<\/span> timeoutMs)<\/span>
\n try<\/span> {<\/span>
\n return<\/span> await<\/span> task<\/span>(<\/span>controller.<\/span>signal)<\/span>
\n }<\/span> finally<\/span> {<\/span>
\n clearTimeout<\/span>(<\/span>timer)<\/span>
\n }<\/span>
\n}<\/span><\/p>\n

\u6587\u4ef6\u53e5\u67c4\u3001\u8ba2\u9605\u3001\u7f13\u51b2\u533a\u3001\u7eb9\u7406\u3001\u4f1a\u8bdd\u548c\u56de\u8c03\u6ce8\u518c\u90fd\u8981\u6210\u5bf9\u91ca\u653e\u3002\u540e\u53f0\u5207\u6362\u3001\u7a97\u53e3\u5173\u95ed\u548c\u8fdb\u7a0b\u6062\u590d\u9700\u8981\u5355\u72ec\u6d4b\u8bd5\u3002<\/p>\n

\u4e03\u3001\u9519\u8bef\u5206\u7c7b\u51b3\u5b9a\u6062\u590d\u7b56\u7565<\/h3>\n

\u53c2\u6570\u9519\u8bef\u4e0d\u80fd\u76f2\u76ee\u91cd\u8bd5；\u8d44\u6e90\u538b\u529b\u9700\u8981\u964d\u7ea7；\u7f51\u7edc\u6216\u8bbe\u5907\u77ac\u65f6\u6545\u969c\u53ef\u4ee5\u6307\u6570\u9000\u907f；\u6743\u9650\u62d2\u7edd\u5e94\u4ea4\u8fd8\u7528\u6237\u51b3\u7b56\u3002\u6240\u6709\u91cd\u8bd5\u90fd\u8981\u6709\u6b21\u6570\u4e0a\u9650\u548c\u968f\u673a\u6296\u52a8\u3002<\/p>\n

type<\/span> FailureKind<\/span> =<\/span>
\n |<\/span> 'INVALID_INPUT'<\/span> |<\/span> 'UNSUPPORTED'<\/span> |<\/span> 'PERMISSION_DENIED'<\/span>
\n |<\/span> 'TRANSIENT'<\/span> |<\/span> 'RESOURCE_PRESSURE'<\/span> |<\/span> 'POLICY_BLOCKED'<\/span><\/p>\n

function<\/span> retryDelay<\/span>(<\/span>attempt:<\/span> number<\/span>)<\/span>:<\/span> number<\/span> {<\/span>
\n const<\/span> base =<\/span> Math.<\/span>min<\/span>(<\/span>30_000<\/span>,<\/span> 500<\/span> *<\/span> 2<\/span> **<\/span> attempt)<\/span>
\n return<\/span> base +<\/span> Math.<\/span>floor<\/span>(<\/span>Math.<\/span>random<\/span>(<\/span>)<\/span> *<\/span> 250<\/span>)<\/span>
\n}<\/span><\/p>\n

\u6062\u590d\u524d\u91cd\u65b0\u67e5\u8be2\u80fd\u529b\u3001\u6743\u9650\u548c\u4e1a\u52a1\u5bf9\u8c61\u65b0\u9c9c\u5ea6，\u4e0d\u80fd\u590d\u7528\u65e7\u7cfb\u7edf\u53e5\u67c4\u3002\u8fbe\u5230\u91cd\u8bd5\u4e0a\u9650\u540e\u505c\u6b62\u540e\u53f0\u6d88\u8017，\u5c55\u793a\u4eba\u5de5\u6062\u590d\u5165\u53e3\u3002<\/p>\n

\u516b\u3001\u5b89\u5168\u4e0e\u9690\u79c1\u6700\u5c0f\u5316<\/h3>\n

\u65e5\u5fd7\u53ea\u8bb0\u5f55\u54c8\u5e0c\u6807\u8bc6\u3001\u72b6\u6001\u3001\u7248\u672c\u3001\u9519\u8bef\u7801\u548c\u8017\u65f6\u3002Cookie\u3001\u6587\u4ef6\u5185\u5bb9\u3001\u8054\u7cfb\u4eba\u3001\u8d26\u53f7\u3001\u7f51\u7edc\u4e94\u5143\u7ec4\u3001\u97f3\u89c6\u9891\u3001\u539f\u59cb\u8bbe\u5907\u6807\u8bc6\u7b49\u654f\u611f\u6570\u636e\u4e0d\u80fd\u8fdb\u5165\u666e\u901a\u65e5\u5fd7\u3001URL \u53c2\u6570\u3001\u5d29\u6e83\u9644\u4ef6\u6216\u622a\u56fe\u3002<\/p>\n

interface<\/span> SafeAuditEvent<\/span> {<\/span>
\n eventName:<\/span> string<\/span>
\n resourceHash:<\/span> string<\/span>
\n revision:<\/span> number<\/span>
\n state:<\/span> CameraMetadataPacketState
\n durationMs:<\/span> number<\/span>
\n errorCode?<\/span>:<\/span> string<\/span>
\n buildId:<\/span> string<\/span>
\n}<\/span><\/p>\n

function<\/span> shouldPersist<\/span>(<\/span>event:<\/span> SafeAuditEvent)<\/span>:<\/span> boolean<\/span> {<\/span>
\n return<\/span> event.<\/span>resourceHash.<\/span>length ><\/span> 0<\/span> &&<\/span> event.<\/span>durationMs >=<\/span> 0<\/span>
\n}<\/span><\/p>\n

\u8bca\u65ad\u5305\u5fc5\u987b\u7531\u7528\u6237\u6216\u7ba1\u7406\u5458\u4e3b\u52a8\u5bfc\u51fa，\u5e76\u8bbe\u6709\u6548\u671f\u3002\u9ad8\u98ce\u9669\u64cd\u4f5c\u7684\u786e\u8ba4\u6587\u6848\u548c\u6700\u7ec8\u63d0\u4ea4\u5185\u5bb9\u5e94\u6765\u81ea\u540c\u4e00\u4efd\u4e0d\u53ef\u53d8\u6458\u8981，\u9632\u6b62\u201c\u786e\u8ba4 A\u3001\u6267\u884c B\u201d\u3002<\/p>\n

\u4e5d\u3001\u6027\u80fd\u8981\u770b\u5206\u4f4d\u6570\u548c\u526f\u4f5c\u7528<\/h3>\n

\u672c\u6587\u4e3b\u6307\u6807\u662f camera_metadata_match_rate\u3002\u540c\u65f6\u8bb0\u5f55\u6210\u529f\u7387\u3001\u53d6\u6d88\u7387\u3001\u8d85\u65f6\u7387\u3001\u5185\u5b58\/\u663e\u5b58\u5cf0\u503c\u3001I\/O\u3001\u8017\u7535\u3001\u6e29\u5347\u548c\u964d\u7ea7\u7387\u3002\u5e73\u5747\u503c\u4e0d\u80fd\u4ee3\u8868\u5c3e\u90e8\u4f53\u9a8c，\u81f3\u5c11\u8ba1\u7b97 P50\u3001P90\u3001P99\u3002<\/p>\n

interface<\/span> MetricPoint<\/span> {<\/span>
\n name:<\/span> 'camera_metadata_match_rate'<\/span>
\n value:<\/span> number<\/span>
\n deviceClass:<\/span> string<\/span>
\n osVersion:<\/span> string<\/span>
\n sdkVersion:<\/span> string<\/span>
\n buildId:<\/span> string<\/span>
\n degraded:<\/span> boolean<\/span>
\n}<\/span><\/p>\n

function<\/span> percentile<\/span>(<\/span>values:<\/span> number<\/span>[<\/span>]<\/span>,<\/span> ratio:<\/span> number<\/span>)<\/span>:<\/span> number<\/span> {<\/span>
\n const<\/span> sorted =<\/span> [<\/span>…<\/span>values]<\/span>.<\/span>sort<\/span>(<\/span>(<\/span>a,<\/span> b)<\/span> =><\/span> a –<\/span> b)<\/span>
\n const<\/span> index =<\/span> Math.<\/span>min<\/span>(<\/span>sorted.<\/span>length –<\/span> 1<\/span>,<\/span> Math.<\/span>floor<\/span>(<\/span>sorted.<\/span>length *<\/span> ratio)<\/span>)<\/span>
\n return<\/span> sorted[<\/span>index]<\/span> ??<\/span> 0<\/span>
\n}<\/span><\/p>\n

\u5bf9\u7167\u5b9e\u9a8c\u4f7f\u7528\u76f8\u540c\u8bbe\u5907\u3001\u6570\u636e\u548c\u811a\u672c，\u4e00\u6b21\u53ea\u6539\u4e00\u4e2a\u4e3b\u8981\u53d8\u91cf\u3002\u5ef6\u8fdf\u4e0b\u964d\u4f46\u9519\u8bef\u3001\u8017\u7535\u6216\u6e29\u5347\u6076\u5316\u65f6，\u4e0d\u5e94\u76f4\u63a5\u6269\u5927\u7070\u5ea6\u3002<\/p>\n

\u5341\u3001UI \u6295\u5f71\u5fc5\u987b\u5fe0\u4e8e\u9886\u57df\u72b6\u6001<\/h3>\n

UI \u4e0d\u62e5\u6709\u4efb\u52a1，\u53ea\u6295\u5f71\u9886\u57df\u5feb\u7167\u3002\u52a0\u8f7d\u6001\u5e94\u8bf4\u660e\u5f53\u524d\u9636\u6bb5\u5e76\u5141\u8bb8\u53d6\u6d88；\u9519\u8bef\u6001\u533a\u5206\u53ef\u91cd\u8bd5\u548c\u4e0d\u53ef\u91cd\u8bd5；\u7ec8\u6001\u5c55\u793a\u53ef\u6838\u9a8c\u7ed3\u679c\u3002\u4e0d\u8981\u63d0\u524d\u663e\u793a 100%，\u4e5f\u4e0d\u8981\u8ba9\u65e7\u9875\u9762\u56de\u8c03\u8986\u76d6\u65b0\u4efb\u52a1\u3002<\/p>\n

interface<\/span> UiState<\/span> {<\/span>
\n title:<\/span> string<\/span>
\n detail:<\/span> string<\/span>
\n progress?<\/span>:<\/span> number<\/span>
\n action?<\/span>:<\/span> 'RETRY'<\/span> |<\/span> 'CANCEL'<\/span> |<\/span> 'OPEN_SETTINGS'<\/span> |<\/span> 'USE_FALLBACK'<\/span>
\n terminal:<\/span> boolean<\/span>
\n}<\/span><\/p>\n

function<\/span> projectUi<\/span>(<\/span>snapshot:<\/span> SessionSnapshot)<\/span>:<\/span> UiState {<\/span>
\n return<\/span> {<\/span>
\n title:<\/span> String<\/span>(<\/span>snapshot.<\/span>state)<\/span>,<\/span>
\n detail:<\/span> snapshot.<\/span>errorCode ??<\/span> '\u4efb\u52a1\u5904\u7406\u4e2d'<\/span>,<\/span>
\n terminal:<\/span> false<\/span>
\n }<\/span>
\n}<\/span><\/p>\n

\u72b6\u6001\u53d8\u5316\u8981\u80fd\u88ab\u8bfb\u5c4f\u611f\u77e5，\u989c\u8272\u4e0d\u80fd\u6210\u4e3a\u552f\u4e00\u4fe1\u53f7\u3002\u8de8\u7a97\u53e3\u3001\u9501\u5c4f\u3001\u901a\u77e5\u548c\u8de8\u8bbe\u5907\u5165\u53e3\u5171\u4eab\u540c\u4e00\u4e1a\u52a1\u72b6\u6001\u6e90\u3002<\/p>\n

\u5341\u4e00\u3001\u964d\u7ea7\u662f\u4e00\u6761\u6b63\u5f0f\u4ea7\u54c1\u8def\u5f84<\/h3>\n

\u4e3b\u80fd\u529b\u4e0d\u53ef\u7528\u65f6，\u5e94\u4fdd\u7559\u80fd\u5b8c\u6210\u6838\u5fc3\u76ee\u6807\u7684\u7a33\u5b9a\u8def\u5f84，\u4f8b\u5982\u51cf\u5c11\u6548\u679c\u3001\u6539\u7528\u672c\u5730\u5904\u7406\u3001\u8ba9\u7528\u6237\u7a0d\u540e\u91cd\u8bd5\u6216\u8f6c\u4e3a\u624b\u52a8\u64cd\u4f5c\u3002\u964d\u7ea7\u8981\u6709\u660e\u786e\u89e6\u53d1\u6761\u4ef6\u3001\u7528\u6237\u8bf4\u660e\u548c\u6062\u590d\u6761\u4ef6\u3002<\/p>\n

interface<\/span> DegradeDecision<\/span> {<\/span>
\n reason:<\/span> 'UNSUPPORTED'<\/span> |<\/span> 'PERMISSION'<\/span> |<\/span> 'TIMEOUT'<\/span> |<\/span> 'PRESSURE'<\/span> |<\/span> 'POLICY'<\/span>
\n preserveUserWork:<\/span> boolean<\/span>
\n retryAfterMs?<\/span>:<\/span> number<\/span>
\n userMessageKey:<\/span> string<\/span>
\n}<\/span><\/p>\n

function<\/span> safeFallback<\/span>(<\/span>reason:<\/span> DegradeDecision[<\/span>'reason'<\/span>]<\/span>)<\/span>:<\/span> DegradeDecision {<\/span>
\n return<\/span> {<\/span> reason,<\/span> preserveUserWork:<\/span> true<\/span>,<\/span> userMessageKey:<\/span> 'feature_degraded'<\/span> }<\/span>
\n}<\/span><\/p>\n

\u964d\u7ea7\u540e\u4fdd\u5b58\u7528\u6237\u8f93\u5165，\u907f\u514d\u91cd\u590d\u52b3\u52a8；\u6062\u590d\u4e3b\u80fd\u529b\u65f6\u91cd\u65b0\u5efa\u7acb\u4f1a\u8bdd，\u4e0d\u80fd\u6cbf\u7528\u5df2\u91ca\u653e\u8d44\u6e90\u3002<\/p>\n

\u5341\u4e8c\u3001\u6d4b\u8bd5\u77e9\u9635\u4e0e\u8bc1\u636e<\/h3>\n