TXLivePlayer

Public 成员函数
	TXLivePlayer ()
	~TXLivePlayer ()
void	setListener (ITXLivePlayerListener^ listener, IntPtr pUserData)
array< String^> ^	speakerDevices ()
void	selectSpeakerDevice (UInt32 index)
UInt32	speakerVolume ()
void	setSpeakerVolume (UInt32 volume)
UInt32	speakerVolumeIndication ()
void	setRenderFrame (IntPtr hWnd)
void	updateRenderFrame (IntPtr hWnd)
void	closeRenderFrame ()
void	startPlay (String^ url, TXEPlayType type)
void	stopPlay ()
void	pause ()
void	resume ()
bool	isPlaying ()
void	setMute (bool mute)
void	setRenderMode (TXERenderMode mode)
void	setRotation (TXEVideoRotation rotation)
void	setRenderYMirror (bool mirror)
void	setOutputVideoFormat (TXEOutputVideoFormat format)

构造及析构函数说明

TXLivePlayer()

TXLivePlayer

(

)

~TXLivePlayer()

~TXLivePlayer

(

)

析构函数，C::代码中要求显示调用Dispose函数，来触发托管C++类析构函数

成员函数说明

closeRenderFrame()

void closeRenderFrame

(

)

关闭图像渲染

isPlaying()

bool isPlaying

(

)

是否正在播放

pause()

void pause

(

)

暂停播放

resume()

void resume

(

)

恢复播放

selectSpeakerDevice()

void selectSpeakerDevice

(

UInt32

index

)

选择指定的扬声器作为音频播放的设备，不调用该接口时，默认选择索引为0的扬声器

参数

index

扬声器设备的索引，要求index值小于 speakerDeviceCount 接口的返回值

setListener()

void setListener	(	ITXLivePlayerListener^	listener,
		IntPtr	pUserData
	)

设置回调 TXLivePlayer 的回调代理，监听播放事件、以及获取音视频数据

参数

listener	TXLivePlayer 类型的接口类
pUserData	一般情况下传 NULL 就可以了，透传用户数据到 ITXLivePusherCallback 的回调函数

setMute()

void setMute

(

bool

mute

)

静音接口

参数

mute

是否静音

setOutputVideoFormat()

void setOutputVideoFormat

(

TXEOutputVideoFormat

format

)

设置视频编码格式，默认格式是TXE_OUTPUT_VIDEO_WITHOUT_OUTPUT

参数

format

视频编码格式，参考 TXLiveTypeDef.h 中定义的 TXEOutputVideoFormat 枚举值

setRenderFrame()

void setRenderFrame

(

IntPtr

hWnd

)

挂接视频图像渲染

参数

hWnd	承载视频画面的 HWND

setRenderMode()

void setRenderMode

(

TXERenderMode

mode

)

设置图像的渲染（填充）模式

参数

mode	参考 TXLiveTypeDef.h 中定义的 TXERenderMode 枚举值

setRenderYMirror()

void setRenderYMirror

(

bool

mirror

)

设置渲染的镜像效果

参数

mirror

true表示画面左右反转，false表示保持原样

setRotation()

void setRotation

(

TXEVideoRotation

rotation

)

设置图像的顺时针旋转角度

参数

rotation

参考 TXLiveTypeDef.h 中定义的 TXEVideoRotation 枚举值

setSpeakerVolume()

void setSpeakerVolume

(

UInt32

volume

)

设置SDK播放的音量，注意设置的不是系统扬声器的音量大小

参数

volume

设置的音量大小，范围是[0, 65535]

speakerDevices()

array<String^> ^ speakerDevices

(

)

枚举当前可用的扬声器，如果一台Windows同时安装了多个扬声器，那么此函数获取可用的扬声器数量和名称

返回

当前可用的扬声器列表，查询得到的字符编码格式是UTF-8

speakerVolume()

UInt32 speakerVolume

(

)

查询SDK播放的音量，注意查询得到不是系统扬声器的音量大小

返回

音量值，范围是[0, 65535]

speakerVolumeIndication()

UInt32 speakerVolumeIndication

(

)

查询已选择扬声器的能量值，指示音量的大小

参数

volume

设置的音量大小，范围是[0, 65535]

返回

能量值，范围是[0, 65535]

startPlay()

void startPlay	(	String^	url,
		TXEPlayType	type
	)

开始播放，请在 startPlay 之前 setRenderFrame

参数

url	视频播放 URL
type	播放类型，参考 TXLiveTypeDef.h 中定义的 TXEPlayType 枚举值

stopPlay()

void stopPlay

(

)

停止播放

updateRenderFrame()

void updateRenderFrame

(

IntPtr

hWnd

)

重设图像渲染区域，当您指定的 HWND 的窗口尺寸发生变化时，可以通过这个函数重新调整视频渲染区域

参数

hWnd	承载视频画面的 HWND