图片管理

更新时间：2026-10-22 20:22:28

/**
 * 根据图片ID批量获取图片存储地址
 *
 * @param params - [GetPictureReq]
 * @public
 */
declare function getPictureById(params: GetPictureReq): Promise<GetPictureRsp>;

export declare namespace RTCXMsgPicGateway {
    export {
        getPictureById
    }
}

批量根据图片ID获取图片地址

注意

​ 本接口是批量接口，在可批量获取的场景下，请不要单个来请求，会影响平台服务

import { RTCXMsgPicGateway, RTCXPlaybackTypes } from '@rtcx/websdk'

async function handleGetPictureById() {
  if (!pictureIdInput.value.trim()) {
    ElNotification.warning('请输入图片ID')
    return
  }

  if (!iotId) {
    ElNotification.warning('请先选择设备')
    return
  }

  loading.value = true
  resultData.value = null

  try {
    const pictureIdList = pictureIdInput.value.split(',').map(id => id.trim()).filter(id => id)


    const result = await RTCXMsgPicGateway.getPictureById({
      iotId,
      pictureIdList,
    })

    resultData.value = result
    ElNotification.success(`查询成功，获取到 ${result.pictureList?.length || 0} 张图片`)
  } catch (error) {
    console.error('查询图片失败:', error)
    ElNotification.error('查询图片失败: ' + (error as Error).message)
  } finally {
    loading.value = false
  }
}

请求对象 RTCXPlaybackTypes.GetPictureReq

/**
 * 根据图片ID获取图片地址
 * @public
 */
declare type GetPictureReq = {
    /**
     * 平台为设备颁发的ID，设备的唯一标识符。
     */
    iotId: string;
    /**
     * 图片ID列表。最大500
     */
    pictureIdList: string[];
    /**
     * 多目摄像头时候填写
     */
    lensId?: number;
    /**
     * 不填或0：消息中心，1：事件中心
     */
    datasource?: string;
};

返回对象 RTCXPlaybackTypes.GetPictureRsp

/**
 * 批量获取图片返回
 * @public
 */
declare type GetPictureRsp = {
    pictureList: GetPictureRspItem[];
};

/**
 * 图片信息
 * @public
 */
declare type GetPictureRspItem = {
    /**
     * 图片地址
     */
    pictureUrl: string;
    /**
     * 图片ID
     */
    pictureId: string;
};