@heybox/hb-sdk API Reference - v0.9.5
    正在准备搜索索引...

    接口 MediaPickItemBase

    media.pick 单项结果的公共字段。

    字段描述实际交付给 file 的媒体表示,不根据原始扩展名推测:

    • size 单位为字节,对应 file 当前可读取的字节长度。
    • width / height 是考虑方向信息后的显示像素尺寸,必须是正整数。
    • previewUrl 是本会话受控预览地址,可直接交给页面 <img> / <video>;它不提供任意路径访问, 会话结束后失效。视频预览不得依赖完整 JS 字节读取。
    • file 复用现有只读文件句柄 wire 契约,必须是 mode: 'read' 的 direct file ref, filesystem API 可直接消费;媒体选择不因此授予写入、删除或派生目录权。

    0.9.3

    interface MediaPickItemBase {
        file: MiniProgramFileDescriptor & { ref: MiniProgramDirectFileRef };
        height: number;
        mimeType: string;
        previewUrl: string;
        size: number;
        type: "image" | "video";
        width: number;
    }

    层级 (查看层级一览)

    索引

    属性

    可直接被 filesystem API 消费的只读 direct 文件句柄。

    height: number

    考虑方向后的显示像素高度,正整数。

    mimeType: string

    实际交付文件的 MIME 类型,非空字符串。

    previewUrl: string

    受控、绑定当前会话的预览地址。

    size: number

    实际交付文件的字节大小。

    type: "image" | "video"

    媒体类型判别值;与 file 的实际内容一致。

    width: number

    考虑方向后的显示像素宽度,正整数。