跳转至
本 SDK 仅适用于过去 3 年内发布的设备。我们定期优化和更新 SDK，以确保兼容性和性能。对于超过 3 年的旧设备，我们不保证兼容性，也不会提供技术支持。

# NET_SDK_PlayBackByTime

### 接口定义

C++C#

    1
    2
    3
    4
    5
    6
    7
    POINTERHANDLE NET_SDK_PlayBackByTime(
        LONG lUserID,
        LONG* pChannels,
        LONG channelNum,
        DD_TIME* lpStartTime,
        DD_TIME* lpStopTime,
        HWND* hWnds);

    1
    2
    3
    4
    5
    6
    7
    public static extern POINTERHANDLE NET_SDK_PlayBackByTime(
        Int32 lUserID,
        uint[] lChannels,
        int channelNum,
        ref DD_TIME lpStartTime,
        ref DD_TIME lpStopTime,
        IntPtr[] hWnds);

### 功能描述

按时间回放录像文件，请求主码流录像。

### 参数说明

参数 | 类型 | 说明
--- | --- | ---
lUserIDin | LONG | 用户ID，`NET_SDK_Login`或`NET_SDK_LoginEx`的返回值。
pChannelsin | LONG* | 要回放的通道号数组，通道号从0开始。
channelNumin | LONG | 数组pChannels中通道的个数。
lpStartTimein | `DD_TIME`* | 文件的开始时间指针，参考`DD_TIME`。
lpStopTimein | `DD_TIME`* | 文件结束时间指针，参考`DD_TIME`。
hWndsin | HWND* | 回放的窗口句柄（仅支持Windows平台），若置为空，SDK仍能收到码流数据，但不解码显示。

### 返回值

- 类型：POINTERHANDLE

- 说明：-1表示失败，其他值作为回放句柄。

### 备注

该接口指定了当前要播放的录像文件，在调用该接口成功后，可以通过接口`NET_SDK_SetPlayDataCallBack`、`NET_SDK_SetPlayYUVCallBack`注册回调函数，捕获录像的码流数据并自行处理。

错误码