读取目录列表

读取指定目录下的文件与目录列表，返回每一项的名称、是否为目录、大小与修改时间。

接口说明

接口类型

readSandboxPath

参数

参数名	类型	必填	说明
deviceId	string	✅	设备 ID
path	string	❌	目标目录路径（不传/空字符串则默认读取设备沙盒根路径，等同 device.info.sandboxPath）

返回值

返回数组（按系统目录读取顺序返回）：

[
    {
        name: "result.txt",
        dir: false,
        size: 1234,
        mtime: 1710000000000
    }
]

字段说明：

• name：文件/目录名（不包含父路径）
• dir：是否为目录
• size：字节数（目录通常为 0 或不可用时为 0）
• mtime：最后修改时间（毫秒时间戳）

基本使用

const _device = await apiInvoke('getDeviceInfo', {
    deviceId: 'P72578581E07'
})

// 读取沙盒根目录（默认：不传 path）
const _entries = await apiInvoke('readSandboxPath', {
    deviceId: 'P72578581E07'
})

// 读取沙盒根目录（显式传入 path）
const _entries = await apiInvoke('readSandboxPath', {
    deviceId: 'P72578581E07',
    path: _device.info.sandboxPath
})

console.log(_entries)