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

# NET_SDK_LivePlayEx

### 接口定义

C++C#

    1
    2
    3
    4
    5
    POINTERHANDLE NET_SDK_LivePlayEx(
        LONG lUserID,
        LPNET_SDK_CLIENTINFO lpClientInfo,
        LIVE_DATA_CALLBACK_EX fLiveDataCallBack = NULL,
        void* pUser = NULL);

    1
    2
    3
    4
    5
    public static extern POINTERHANDLE NET_SDK_LivePlayEx(
        Int32 lUserID,
        ref NET_SDK_CLIENTINFO lpClientInfo,
        LIVE_DATA_CALLBACK_EX fLiveDataCallBack,
        IntPtr pUser);

### 功能描述

实时预览（`NET_SDK_LivePlay`的扩展）。

### 参数说明

参数 | 类型 | 说明
--- | --- | ---
lUserIDin | LONG | 用户ID，`NET_SDK_Login`或`NET_SDK_LoginEx`的返回值。
lpClientInfoin | `LPNET_SDK_CLIENTINFO` | 预览参数，参考结构体`LPNET_SDK_CLIENTINFO`。
fLiveDataCallBackin | `LIVE_DATA_CALLBACK_EX` | 预览数据回调参数，默认值为NULL，参考`LIVE_DATA_CALLBACK_EX`。
pUserin | void* | 用户自定义参数。

### 返回值

- 类型：POINTERHANDLE

- 说明：-1表示失败，其他值作为`NET_SDK_StopLivePlay`等函数的句柄参数。

### 备注

在调用此接口成功后，若需要捕获实时码流数据，可以调用接口口`NET_SDK_SetLiveDataCallBack`、`NET_SDK_SetLiveDataCallBackEx`或者`NET_SDK_SetYUVCallBack`来注册捕获码流数据的回调函数，并在回调函数中自行处理回调上来的码流数据。

错误码