Start

函数功能

启动指令流客户端引擎。指令流客户端引擎会启动渲染线程，并启动网络连接。

约束说明

调用者需在调用之前保证网络通道可用。

函数原型

uint32_t Start(uint64_t surface, uint32_t width, uint32_t height, uint32_t densityDpi)

参数说明

参数名称	输入/输出	参数类型	参数描述
surface	输入	uint32_t	Activity传下来的Surface控件对象，并通过Jni转换成ANativeWindow指针，再转成uint64_t值。
width	输入	uint32_t	设备屏幕的宽度，取值大于0。
height	输入	uint32_t	设备屏幕的高度，取值大于0。
densityDpi	输入	uint32_t	设备屏幕的像素密度，取值大于0。

返回值说明

VMI_SUCCESS：代表成功。
VMI_CLIENT_INVALID_PARAM：表示非法参数。
VMI_CLIENT_START_FAIL：表示指令流客户端启动失败。
VMI_CLIENT_ALREADY_STARTED：表示指令流客户端已始处于运行状态。

调用示例

void Test()  
{ 
     ANativeWindow *nativeWindow = ANativeWindow_fromSurface(env, surface);
     uint32_t result = Start(reinterpret_cast<uint64_t>(nativeWindow), width, height, densityDpi);  
     if (result == VMI_SUCCESS) {  
         // 指令流客户端启动成功，程序继续执行  
         ...  
     } else {
        // 指令流客户端启动失败
         ...
     }
}

父主题： 指令流客户端引擎对外接口