获取指定云手机实例的预签名访问链接。

注意

该接口仅对部分机房开放。如需使用，请提交工单联系技术支持团队。

## 请求说明 * 请求方式：POST * 请求地址：https://open.volcengineapi.com?Action=GetPreSignedEdgeURL&Version=2025\-05\-01 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见 [公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Query |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |`GetPreSignedEdgeURL` |接口名称。当前 API 的名称为 `GetPreSignedEdgeURL`。 | |Version |String |是 |`2025-05-01` |接口版本。当前 API 的版本为 `2025-05-01`。 | ### Body |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |ProductId |String |是 |1749281594201xxxxxx |业务 ID，管理云手机资源、开展云手机业务的标识。可登录 [云手机控制台](https://console.volcengine.com/ACEP)，在已创建的业务卡片中获取。 | |PodId |String |是 |7294157141458xxxxxx |实例 ID，用于指定具体的云手机实例。 | |APIType |String |是 |TakeScreenshot |API 请求方法类型。用于指定生成预签名直连链接所对应的 API 调用类型。当前已支持的类型如下：

* TakeScreenshot：获取指定云手机实例进行截屏的预签名直连链接，用于对实例发起截屏并返回截图，请求参数请参见 [TakeScreenshot](https://www.volcengine.com/docs/6394/2533260#4oYSOcVE)。

* RunSyncCommand：获取指定云手机实例中执行命令的预签名直连链接，用于对实例发起命令执行，请求参数请参见 [RunSyncCommand](https://www.volcengine.com/docs/6394/2533260#zaUHRC6G)。

* UploadFile：获取指定云手机实例的预签名直连上传链接，用于将文件上传至实例，请求参数请参见 [UploadFile](https://www.volcengine.com/docs/6394/2533260#uCCwZzlf)。

* DownloadFile：获取指定云手机实例的预签名直连下载链接，用于从实例中下载文件，请求参数请参见 [DownloadFile](https://www.volcengine.com/docs/6394/2533260#qEeicKbR)。 | |APIPayload |JSON Map |否 |{

"Key": "Value"

} |API 请求参数。用于传递 API 调用所需的参数，键为参数名称，值为参数值。具体需传递的参数内容取决于 APIType 对应的接口要求，最终以 Query 参数形式参与预签名链接的生成与签名。 | |APIBodyHash |String |否 |2cf24dba5fbxxxxxx |API 请求体的 SHA256 哈希值，可选参数。当 APIType 对应功能的请求类型为 POST、PUT、PATCH 时：

* 若请求体参与签名计算，则此参数需填写为请求体内容的 SHA256 哈希值。

* 若请求体不参与签名计算，则此参数必须填写为 `UNSIGNED-PAYLOAD`（即请求体不参与签名计算）。 | |TTL |Integer |否 |3600 |直连链接的有效时长，单位为秒。默认值为 3600 秒（即 1 小时），最大值为 86400 秒（即 24 小时）。 | |Timeout |Integer |否 |10 |直连链接的请求超时时间，单位：秒。可选参数，未指定时使用系统默认配置。 | ### TakeScreeshot 获取指定云手机实例进行截屏的预签名直连链接，用于对实例发起截屏并返回截图。 * 请求方法：GET * 协议：HTTPS #### APIPayload 单次截图参数说明 |**参数** |**数据类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |width |Integer |否 |720 |截图目标宽度，参考客户端屏幕比例，默认值为 0，取值范围为 [200, 2560]。 | |height |Integer |否 |1280 |截图目标高度，参考客户端屏幕比例，默认值为 0，取值范围为 [200, 2560]。 | |mimeType |String |否 |jpg |截图格式，支持的类型如下：

* `png`

* `jpg` （默认值） | |isSavedOnPod |Boolean |否 |true |是否将截图同步保存至实例中。

* `true`：是。

* `false`：否。 | |isBroadcasted |Boolean

|否 |true |是否广播截图事件。

* `true`：（默认值）广播。

* `false`：非广播。 | |rotation

|Integer

|否 |1 |截图画面横竖屏的旋转方向。

* `0`：（默认值）截图方向不做处理。

* `1`：截图画面旋转为竖屏。

* 手机竖屏的截图，不做处理。

* 手机横屏的截图，截图顺时针旋转 90 度。 | |resizeMode

|Integer |否 |1 |截图图片缩放模式。

* `0`：（默认值）等比缩放，缩略图限制在指定w与h的矩形内的最大图片。

* `1`：等比缩放，缩略图为延伸出指定w与h的矩形框外的最小图片。

* `2`：等比缩放，缩略图为延伸出指定w与h的矩形框外的最小图片，之后按照固定宽高进行裁剪。

* `3`：等比缩放，缩略图限制在指定w与h的矩形内的最大图片再按照固定宽高进行颜色填充。

* `4`：按照固定宽高强制缩放，若宽高与原图宽高比例不同，则会导致图片变形。 | |roundId

|String

|否 |2027703615530995712_17xxx |每次截图的标识 ID，用于标识本次截图任务。 | |quality |Integer |否 |100 |截图质量，取值范围为 [1, 100]，默认值为 `100`。 | |scale |Double |否 |1.0 |截图同比缩放的比例，取值范围为 [0.1, 1.0]，默认值为 `1.0`。 | #### APIPayload 连续截图参数说明 |**参数** |**数据类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |mode |String |是 |sse |连续截图的推送模式，不填则使用默认模式。

* sse：启用 SSE（Server\-Sent Events）模式推送截图结果。 | |mimeType |String |否 |jpg |截图格式，支持的类型如下：

* `png`

* `jpg` （默认值） | |interval

|Integer |否 |1000 |截图时间间隔，单位为毫秒。上一次截图完成后，间隔指定时长再执行下一次截图。取值范围为 [100, 43200000]，默认值为 `1000`（即每 1 秒截图一次）。 | |durationLimit |Integer |否

|100 |连续截图操作的最大持续时长，单位为毫秒。取值范围：[100, 43200000]，默认值为 `1000`（即持续 1 秒）。 | |rotation

|Integer

|否 |1 |截图画面横竖屏的旋转方向。

* `0`：（默认值）截图方向不做处理。

* `1`：截图画面旋转为竖屏。

* 手机竖屏的截图，不做处理。

* 手机横屏的截图，截图顺时针旋转 90 度。 | |quality |Integer |否 |100 |截图质量，取值范围为 [1, 100]，默认值为 `100`。 | |scale |Double |否 |1.0 |截图同比缩放的比率，取值范围为 [0.1, 1.0]，默认值为 `1.0`。 | #### TakeScreeshot 请求示例 ```JSON { "ProductId": "202770361553xxx", "PodId": "76390376848xxx", "APIType": "TakeScreenshot", "APIPayload": { "RoundId": "2027703615530995712_17xxx" } } ``` #### TakeScreeshot 返回示例 ```JSON { "ResponseMetadata": { "Action": "GetPreSignedEdgeURL", "Region": "cn-north-1", "RequestId": "202605181227***1A4E908587940B2", "Service": "ACEP", "Version": "2025-05-01" }, "Result": { "PreSignedEdgeURL": "https://tjtj-ctcucm-xx.vegamews.volces.com:9924/clusters/boe-tjtj-ctcucm-06-o33xxxxx/cloudphone-external-openapi/apis/v1/proxy/namespaces/20277036155309xxxxx/androids/76390376848494xxxxx/screenshot?xxxxx" } } ``` #### TakeScreeshot HTTP 状态码说明 |**HTTP 状态码** |**message** |**含义** |**处理建议** | |---|---|---|---| |200 |success |截图成功。 |以响应体为准判断命令结果。 | |400 |Invalid timestamp format |请求时间戳格式不合法。 |校验 timestamp 是否为合法数字字符串，并按签名规范重新发起请求。 | |401 |Missing auth headers / Missing signature headers |请求缺少必要的鉴权信息。 |补齐签名相关请求头后重新发起请求。 | |403 |Replay detected / Invalid signature |请求鉴权失败，可能是重复请求或签名不正确。 |使用新的 nonce 和 timestamp 重新签名，并核对签名算法、密钥、请求路径及参数是否一致。 | |408 |Screenshot timeout |截图请求处理超时。 |建议稍后重试；如问题持续，检查设备状态并适当降低请求频率。 | |429 |Too many SSE connections |当前 SSE 截图连接数过多。 |关闭空闲连接、复用已有连接，或采用退避策略后重试。 | |500 |Auth secret not ready / Screenshot interrupted / Screenshot failed: ... / Screenshot image path is null / Screenshot file not found / Internal server error |服务端暂时无法完成截图请求。 |稍后重试；如问题持续，请联系服务端或设备侧排查。 | ### RunSyncCommand

注意

获取预签名链接后，发起实际请求时仍需携带原始请求体。云手机边缘网关不会将 APIBodyHash 参数解析为请求体内容，仅用于签名校验。

获取指定云手机实例中执行命令的预签名直连链接，用于对实例发起命令执行。 * 请求方法：POST * 协议：HTTPS #### APIBodyHash 参数说明 RunSyncCommand ** ** 支持以下请求参数。若需将请求体纳入签名计算，请在调用 GetPreSignedEdgeURL 时，参考 [计算方法](https://www.volcengine.com/docs/6394/2533260#GM81Rdpd) 计算请求体的哈希值，并将其设置为 APIBodyHash 参数。 |**参数** |**原始数据类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Command |String |是 |pm list packages |待执行的命令，不可为空。 | |PermissionType |String |否 |root |命令执行的权限类型，支持以下类型：

* `root`：（默认值）以 root 权限执行命令，可操作系统级资源。

* `shell`：以普通权限执行命令，适用于常规操作。 | |TimeoutSecond |Integer |否 |10 |命令执行的超时时间，单位为秒，取值范围为 [1, 3600]，默认值为 `3600`。 | |ResultLength |Integer |否 |1024 |命令执行结果（stdout / stderr）的最大返回长度，单位为字节，取值范围为 [1, 10485760]，默认值为 `10485760`，即 10 MiB。 | #### **RunSyncCommand 请求示例**

说明

如下示例中的 APIBodyHash 参数，是对请求体 {"Command":"ls -al","PermissionType":"root","TimeoutSecond":10,"ResultLength":10240} 计算所得的 SHA\-256 哈希值。携带该参数后，所获取的直连链接将仅限于执行该指定命令。出于安全考虑，建议在RunSyncCommand 场景下使用该参数传入请求体 SHA\-256 哈希值，避免使用 UNSIGNED-PAYLOAD。

```JSON { "ProductId": "20277036155309xxx", "PodId": "76445348790822xxx", "APIType": "RunSyncCommand", "APIBodyHash": "d4ac8239acf8fc72cfd55fdb1abe0edf9352d410e0816100dxxx" } ``` #### **RunSyncCommand 返回示例** ```JSON { "ResponseMetadata": { "Action": "GetPreSignedEdgeURL", "Region": "cn-north-1", "RequestId": "20260610153719A8EF4A77Fxxx", "Service": "ACEP", "Version": "2025-05-01" }, "Result": { "PreSignedEdgeURL": "https://tjtj-ctcucm-06.vegamews.volces.com:9924/clusters/boe-tjtj-ctcucm-xxxxxx/cloudphone-external-openapi/apis/v1/proxy/namespaces/xxxxxx/androids/xxxxxx/runsynccommand?xxxxxx" } } ``` #### **RunSyncCommand HTTP 状态码说明** |**HTTP 状态码** |**message** |**含义** |**处理建议** | |---|---|---|---| |200 |success |请求已处理完成，但命令本身不一定执行成功。 |以响应体为准判断命令结果，重点检查 Success、ExitCode、TimedOut、Stdout、Stderr 等字段。 | |400 |Invalid timestamp format / bad request |请求格式或参数不合法。 |校验请求体 JSON 格式，并确认命令、权限类型、超时时间、结果长度等参数符合接口要求。 | |401 |Missing auth headers / Missing signature headers |请求缺少必要的鉴权信息。 |补齐签名相关请求头后重新发起请求。 | |403 |Replay detected / Invalid signature |请求鉴权失败，可能是重复请求或签名不正确。 |使用新的 nonce 和 timestamp 重新签名，并核对签名方法、请求路径及参数是否一致。 | |500 |Auth secret not ready / internal error |服务端暂时无法完成命令执行请求。 |进行有限重试；若持续失败，记录请求参数、HTTP 状态码和响应体，并提交服务端或设备侧排查。 | ### UploadFile 获取指定云手机实例的预签名直连上传链接，用于将文件上传至实例。 * 请求方法：PUT * 协议：HTTPS #### APIPaylod 参数说明 |**参数** |**原始数据类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Path |String |是 |/sdcard/Download/test.zip |目标文件的完整路径，不可为目录。 | |AutoUnzip |String |否 |false |是否自动解压，仅对 .zip 文件有效。

* `true`：表示上传完成后自动解压。

* `false`：（默认值）表示不自动解压。 | |OverWrite |String |否 |true |是否覆盖已存在的目标文件。

* `true`：（默认值）允许覆盖。

* `false`：目标文件已存在，不允许覆盖。 | #### APIBodyHash 参数说明本接口为上传文件场景，不建议对 Body 参数进行签名计算，设置为 `UNSIGNED-PAYLOAD` 即可。 #### UploadFile 请求示例 ```JSON { "ProductId": "2027703615530xxx", "PodId": "7644534879082xxx", "APIType": "UploadFile", "APIBodyHash": "UNSIGNED-PAYLOAD", "APIPayload": { "Path": "/sdcard/Download/test.zip", "OverWrite": "true", "AutoUnzip": "false" } } ``` #### UploadFile 返回示例 ```JSON { "ResponseMetadata": { "Action": "GetPreSignedEdgeURL", "Region": "cn-north-1", "RequestId": "202606101553121xxxA1158B840DD", "Service": "ACEP", "Version": "2025-05-01" }, "Result": { "PreSignedEdgeURL": "https://tjtj-ctcucm-06.vegamews.volces.com:9924/clusters/boe-tjtj-ctcucm-xxxxxx/cloudphone-external-openapi/apis/v1/proxy/namespaces/xxxxxx/androids/xxxxxx/files/upload?xxxxxx" } } ``` #### UploadFile HTTP 状态码说明 |**HTTP 状态码** |**message** |**含义** |**处理建议** | |---|---|---|---| |200 |success |文件上传成功。 |解析响应体，确认文件路径、文件大小、MD5 校验结果及自动解压结果。 | |400 |Invalid timestamp format / Invalid target path / Missing or invalid Content\-Length / Empty upload body / Upload file too large / Upload body missing file content / Upload body truncated / Content\-MD5 mismatch / Invalid Content\-MD5 |请求参数、请求头或请求体不符合接口要求。 |校验 timestamp、目标路径、Content\-Length、请求体完整性、文件大小及 Content\-MD5 格式与内容一致性。 | |401 |Missing auth headers / Missing signature headers |请求缺少必要的鉴权信息。 |补齐签名相关请求头后重新发起请求。 | |403 |Replay detected / Invalid signature / Path not allowed |请求鉴权失败，或上传目标路径不被允许。 |使用新的 nonce/timestamp 重新签名，并确认签名路径、请求参数及上传路径权限配置正确。 | |408 |Upload timeout |文件上传处理超时。 |重新发起上传；如文件较大，建议拆分文件或优化网络稳定性后重试。 | |409 |File already exists |目标文件已存在，且当前请求不允许覆盖。 |若业务允许覆盖，请在设置覆盖参数后重试；否则更换目标文件名。 | |500 |Auth secret not ready / Permission denied for target path / Failed to create target directory / Failed to prepare temp upload file / Upload failed / Failed to finalize uploaded file / Failed to unzip file |服务端暂时无法完成上传或后处理。 |可进行有限重试；若持续失败，检查目标路径、文件权限、存储状态或压缩包内容。 | ### DownloadFile 获取指定云手机实例的预签名直连下载链接，用于从实例中下载文件。 * 请求方法：GET * 协议：HTTPS #### APIPaylod 参数说明 |**参数** |**原始数据类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Path |String |是 |/data/misc/logd/logcat |待下载文件在实例中的完整路径。 | #### DownloadFile 请求示例 ```JSON { "ProductId": "20277036155xxx", "PodId": "7644534879082xxx", "APIType": "DownloadFile", "APIPayload": { "Path": "/data/misc/logd/logcat" } } ``` #### DownloadFile 返回示例 ```JSON { "ResponseMetadata": { "Action": "GetPreSignedEdgeURL", "Region": "cn-north-1", "RequestId": "20260610155845***2FC5F928A51B7", "Service": "ACEP", "Version": "2025-05-01" }, "Result": { "PreSignedEdgeURL": "https://tjtj-ctcucm-06.vegamews.volces.com:9924/clusters/boe-tjtj-ctcucm-xxxxxx/cloudphone-external-openapi/apis/v1/proxy/namespaces/xxxxxx/androids/xxxxxx/files/download?xxxxxx" } } ``` #### DownloadFile HTTP 状态码说明 |**HTTP 状态码** |**message** |**含义** |**处理建议** | |---|---|---|---| |200 |无，返回文件流 |文件完整下载成功。 |按响应头接收并保存文件；如需校验完整性，可结合文件大小或业务侧校验信息进行确认。 | |206 |无，返回部分文件流 |Range 下载成功。 |按 Content\-Range 写入对应文件片段，确保本地续传偏移与服务端返回范围一致。 | |400 |Invalid timestamp format / file path is required / Path is not a file / Invalid range format |请求参数或 Range 请求格式不合法。 |检查 timestamp、Path 参数和 Range 头格式；Path 必须指向具体文件，Range 建议使用单段范围格式。 | |401 |Missing auth headers / Missing signature headers |请求缺少必要的鉴权信息。 |补齐签名相关请求头后重新发起请求。 | |403 |Replay detected / Invalid signature / Path not allowed |请求鉴权失败，或下载路径不被允许。 |使用新的 nonce 和 timestamp 重新生成签名；同时确认下载路径是否在允许访问范围内。 | |404 |File not found |请求下载的文件不存在。 |确认文件路径是否正确，并检查目标文件是否已生成或上传完成。 | |416 |Range not satisfiable |请求的下载范围无效。 |重新获取远端文件大小并修正本地续传偏移；必要时清理本地缓存后重新下载。 | |500 |Auth secret not ready / Failed to access logcat / Permission denied for target path / Failed to read file |服务端暂时无法读取目标文件。 |稍后重试；如持续失败，检查服务端密钥初始化、文件访问权限、目标路径配置及文件读取状态。 | ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见 [返回结构](https://www.volcengine.com/docs/6394/75748#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C)。 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |PreSignedEdgeURL |String |https://tjtj\-ctcucm\-xx.vegamews.volces.com:9924/clusters/boe\-tjtj\-ctcucm\-06\-wpgxxxxx/cloudphone\-external\-openapi/apis/v1/proxy/namespaces/20277036155309xxxxx/androids/76445348790822xxxxx/screenshot?xxxx |预签名直连链接 URL。 | ## 请求示例 ```JSON POST https://open.volcengineapi.com?Action=GetPreSignedEdgeURL&Version=2025-05-01 { "ProductId": "1749281594201xxx", "PodId": "7294157141458xxx", "APIType": "TakeScreenshot", "APIPayload": { "Key": "Value" }, "APIBodyHash": "2cf24dba5fbxxxxxx", "TTL": 3600, "Timeout": 10 } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "Action": "GetPreSignedEdgeURL", "Region": "cn-north-1", "Service": "ACEP", "Version": "2025-05-01", "RequestId": "20230604110420****100232280022D31" }, "Result": { "PreSignedEdgeURL": "https://tjtj-ctcucm-xx.vegamews.volces.com:9924/clusters/boe-tjtj-ctcucm-06-wpgxxxxx/cloudphone-external-openapi/apis/v1/proxy/namespaces/20277036155309xxxxx/androids/76445348790822xxxxx/screenshot?xxxxxx" } } ``` ## 错误码您可访问 [公共错误码](https://www.volcengine.com/docs/6394/1134303)，获取更多错误码信息。 ## 请求体 SHA256 哈希值计算方式 ### JAVA 方式 ```Java package edge.hmac; import java.io.IOException; import java.io.InputStream; import java.security.MessageDigest; import java.security.NoSuchAlgorithmException; public final class PayloadHasher { private static final char[] HEX = "0123456789abcdef".toCharArray(); private static final int BUFFER_SIZE = 8192; /** 用于 mark 时设置一个足够大的 readlimit，避免缓冲区被丢弃 */ private static final int MARK_READ_LIMIT = Integer.MAX_VALUE; private PayloadHasher() {} /** * 计算给定输入流的 SHA-256 哈希，并返回 64 位小写 hex 字符串。 * 若输入流支持 mark/reset（等价于 Go 中的 io.Seeker），读取完毕后会重置回原位置。 * * @param body 待哈希的输入流，可为 null（视为空数据） * @return 64 字符的小写十六进制 SHA-256 摘要 * @throws IOException 读取或回退失败 */ public static String generatePayloadHash(InputStream body) throws IOException { final MessageDigest digest; try { digest = MessageDigest.getInstance("SHA-256"); } catch (NoSuchAlgorithmException e) { throw new IOException("SHA-256 algorithm not available", e); } if (body != null) { if (body.markSupported()) { body.mark(MARK_READ_LIMIT); try { copyToDigest(body, digest); } catch (IOException e) { throw new IOException("failed to read body for hashing: " + e.getMessage(), e); } try { body.reset(); } catch (IOException e) { throw new IOException("failed to rewind body seeker after hashing: " + e.getMessage(), e); } } else { try { copyToDigest(body, digest); } catch (IOException e) { throw new IOException("failed to read body for hashing: " + e.getMessage(), e); } } } return toHex(digest.digest()); } private static void copyToDigest(InputStream in, MessageDigest digest) throws IOException { byte[] buf = new byte[BUFFER_SIZE]; int n; while ((n = in.read(buf)) != -1) { digest.update(buf, 0, n); } } private static String toHex(byte[] bytes) { char[] out = new char[bytes.length * 2]; for (int i = 0; i < bytes.length; i++) { int v = bytes[i] & 0xff; out[i * 2] = HEX[v >>> 4]; out[i * 2 + 1] = HEX[v & 0x0f]; } return new String(out); } } ``` ### Go 方式 ```Go func GeneratePayloadHash(body io.Reader) (string, error) { hash := sha256.New() if body != nil { // Attempt to rewind if the reader supports seeking if seeker, ok := body.(io.Seeker); ok { currentPos, err := seeker.Seek(0, io.SeekCurrent) if err == nil { if _, err := io.Copy(hash, body); err != nil { return "", fmt.Errorf("failed to read body for hashing: %w", err) } if _, err := seeker.Seek(currentPos, io.SeekStart); err != nil { return "", fmt.Errorf("failed to rewind body seeker after hashing: %w", err) } } else { if _, err := io.Copy(hash, body); err != nil { return "", fmt.Errorf("failed to read body for hashing: %w", err) } } } else { // If it doesn't support seeking, it will be consumed if _, err := io.Copy(hash, body); err != nil { return "", fmt.Errorf("failed to read body for hashing: %w", err) } } } return hex.EncodeToString(hash.Sum(nil)), nil } ``` ### Python 方式 ### ```Python from __future__ import annotations import hashlib from typing import BinaryIO, Optional _BUFFER_SIZE = 8192 def generate_payload_hash(body: Optional[BinaryIO]) -> str: """ 计算给定二进制可读对象的 SHA-256 摘要，返回 64 位小写 hex 字符串。若 body 为 None，则视为空数据；若 body 可 seek，读取完毕后会回退到原始位置；不可 seek 时会被消耗。 :param body: 类文件对象（具备 read 方法），可为 None :return: 64 字符的小写十六进制 SHA-256 摘要 :raises IOError: 读取或回退失败 """ h = hashlib.sha256() if body is None: return h.hexdigest() seekable = False try: seekable = bool(body.seekable()) except (AttributeError, OSError): seekable = False if seekable: try: current_pos = body.tell() except (AttributeError, OSError): # 取不到当前位置则按不可 seek 处理 _consume(body, h, "failed to read body for hashing") return h.hexdigest() _consume(body, h, "failed to read body for hashing") try: body.seek(current_pos) except OSError as e: raise IOError(f"failed to rewind body seeker after hashing: {e}") from e else: _consume(body, h, "failed to read body for hashing") return h.hexdigest() def _consume(body: BinaryIO, h, err_prefix: str) -> None: try: while True: chunk = body.read(_BUFFER_SIZE) if not chunk: break h.update(chunk) except OSError as e: raise IOError(f"{err_prefix}: {e}") from e ``` ### PHP 方式 ```PHP