视频
getVideoInfo
获取视频详细信息。
使用说明
| 客户端 | Android | iOS | PC |
|---|---|---|---|
| 支持说明 | 支持 | 支持 | 支持 |
window.ksoxz_sdk.getVideoInfo({ params, onSuccess, onError });参数说明
| 参数 | 类型 | 是否必须 | 描述 | 备注 |
|---|---|---|---|---|
| src | string | 是 | 视频的路径，支持本地文件系统（用户目录、临时目录、包目录）下的路径 | / |
返回结果
| 参数 | 类型 | 描述 | 备注 |
|---|---|---|---|
| type | string | 视频格式 | / |
| duration | number | 视频长度，单位：秒（s） | / |
| size | number | 视频大小，单位 kB | / |
| width | number | 视频的宽，单位 px | / |
| height | number | 视频的长，单位 px | / |
| path | string | 视频的本地路径 | / |
错误码
| errno | msg | 含义 |
|---|---|---|
| 1021005 | Read external storage permission not obtained | 用户未授予 App 文件读取权限（Android 特有） |
| 1042001 | no such file or directory | 找不到文件或目录 |
| 1704001 | unsupported video format | 不支持的视频格式 |
| 1704002 | can't get info from video file | 获取视频信息失败 |
chooseMedia
用于拍摄，或从系统相册中选择图片或视频。
使用说明
| 客户端 | Android | iOS | PC |
|---|---|---|---|
| 支持说明 | 支持 | 支持 | 支持 |
window.ksoxz_sdk.chooseMedia({ params, onSuccess, onError });参数说明
| 参数 | 类型 | 是否必须 | 描述 | 备注 |
|---|---|---|---|---|
| mediaType | string[] | 否 | 文件类型 | 可选值： image：图片。 video：视频。 "video", "image"：视频或图片，不分顺序。 默认值："image", "video" |
| sourceType | string[] | 否 | 指定视频来源。 | 可选值： album：相册。 camera：相机（PC 端不支持相机）。 "album", "camera"：相册或相机，不分顺序。 默认值："album", "camera" |
| count | number | 否 | 最多可以选择的文件数量。 | 支持选择多个图片或多个视频，最多支持 9 个文件。 默认值：9 使用相机拍照或拍视频时，该字段失效。 PC 端文件选择器无法限制选择数量，若设置了该值，会默认截取前 N 个。 |
| sizeType | string[] | 否 | 选择原图（或原视频），或进行压缩。 | 可选值： original：选择原图或原视频。 compressed：强制对图片或视频质量进行压缩。 "original","compressed"：默认开启压缩，但可手动选择原图或原视频。 默认值："original","compressed" Android 不支持视频压缩 |
| maxDuration | number | 否 | 拍摄视频时支持的最长拍摄时间。 | 单位为秒，时间范围为 3s 至 60s 之间。不限制相册。 默认值：60 |
| cameraDevice | string | 否 | 使用相机拍摄时，默认使用的摄像头。 | 可选值： front：前置摄像头。 back：后置摄像头。 默认值：back |
| isSaveToAlbum | string | 否 | 使用相机拍摄后图片是否保存到相册。 | 可选值： 0：不保存。 1：保存。 默认值：0 该字段仅 iOS 和 Android 支持 |
返回结果
| 类型 | 描述 | 备注 | |
|---|---|---|---|
| tempFiles | object[] | 临时文件数组。 | / |
| ∟ tempFilePath | string | 文件地址。 | / |
| ∟ type | string | 文件类型。可能值有 image（图片）、video（视频）。 | / |
| ∟ size | number | 图片/视频大小。单位：字节（Bytes） | / |
| ∟ duration | number | 视频时长，单位：秒（s）。选取文件类型为 video 时返回该字段。 | PC 端暂不支持返回该字段。 |
| ∟ width | number | 图片/视频宽度。选取文件类型为 video 时返回该字段。 | PC 端暂不支持返回该字段。 |
| ∟ height | number | 图片/视频高度。选取文件类型为 video 时返回该字段。 | PC 端暂不支持返回该字段。 |
| tempFiles | object[] | 临时文件数组。 | / |
错误码
| errno | msg | 含义 |
|---|---|---|
| 1041001 | user canceled | 用户取消操作 |
| 1002003 | Camera permission not obtained | 用户未授予 App 照相机权限 |
| 1002004 | Album permission not obtained | 用户未授予 App 相册权限（iOS 特有） |
| 1021005 | Read external storage permission not obtained | 用户未授予 App 文件读取权限（Android 特有） |
| 102106 | Write external storage permission not obtained | 用户未授予 App 文件写入权限（Android 特有） |
| 1704001 | unsupported video format | 不支持的视频格式 |
| 1704002 | can't get info from video file | 获取视频信息失败 |