com.tencent.av.sdk
Class AVEndpoint

java.lang.Object
  com.tencent.av.sdk.AVEndpoint

public class AVEndpoint
extends java.lang.Object

AVEndpoint表示房间成员。
房间成员由房间动态创建和销毁，应用层无法直接创建房间成员，只能通过查询房间成员的方式获取成员对象引用。
注意：不建议应用程序缓存获得的成员对象引用，即显式地把成员对象引用保存到另一个容器。
这是由于随着成员加入和退出房间，房间内部会创建和销毁成员对象，这会导致缓存的引用失效。 任何时候，应该由房间提供的接口来获取成员对象。
当然，有时候为了简化代码，应用层还是需要保存一些必要信息方便进行操作，推荐您在响应房间成员变化的同时，把需要的信息复制到自己的容器，
例如保存成员id。

Nested Class Summary

static class	AVEndpoint.CancelAllViewCompleteCallback cancelAllView()的回调函数，用来异步返回结果。 与requestViewList配合使用。
static class	AVEndpoint.Info 房间成员信息. 由SDK初始化对象各个字段值，app可以通过此对象获取相关信息，
static class	AVEndpoint.RequestViewListCompleteCallback requestViewList()的回调函数，用来异步返回结果。 与requestViewList配合使用。

Field Summary

int

nativeObj

Constructor Summary

AVEndpoint()
构造函数。

Method Summary

static int	cancelAllView(AVEndpoint.CancelAllViewCompleteCallback completeCallback) 取消所有请求的视频画面。 异步返回结果。和requestViewList对应的逆操作，约束条件和requestViewList一样。 注意： .
java.lang.String	getId() 获取当前成员的id。 同步返回结果。
AVEndpoint.Info	getInfo() 获取当前成员的基本信息。 同步返回结果。
boolean	hasAudio() 判断成员是否有音频上行。 同步返回结果。
boolean	hasCameraVideo() 判断成员是否有摄像头视频上行。 同步返回结果。
boolean	hasScreenVideo() 判断成员是否有屏幕视频上行。 同步返回结果。
static int	requestViewList(java.lang.String[] identifierList, AVView[] viewList, int count, AVEndpoint.RequestViewListCompleteCallback completeCallback) 请求多个成员的视频画面。 异步返回结果。请求画面操作是互斥的，必须等到上一次请求操作回调回来后才进行下一次请求。 同一个时间点只能请求一次成员的画面，必须等待异步结果返回后，才能进行新的请求画面操作。 在请求画面前最好检查该成员是否有对应的视频源。 注意： .

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

nativeObj

public int nativeObj

Constructor Detail

AVEndpoint

public AVEndpoint()

构造函数。

Method Detail

getId

public java.lang.String getId()

获取当前成员的id。
同步返回结果。

Returns:

成员的id。

getInfo

public AVEndpoint.Info getInfo()

获取当前成员的基本信息。
同步返回结果。

Returns:

成员的基本信息。

requestViewList

public static int requestViewList(java.lang.String[] identifierList,
                                  AVView[] viewList,
                                  int count,
                                  AVEndpoint.RequestViewListCompleteCallback completeCallback)

请求多个成员的视频画面。
异步返回结果。请求画面操作是互斥的，必须等到上一次请求操作回调回来后才进行下一次请求。
同一个时间点只能请求一次成员的画面，必须等待异步结果返回后，才能进行新的请求画面操作。
在请求画面前最好检查该成员是否有对应的视频源。
注意： . 画面大小可以根据业务层实际需要及硬件能力决定。 . 如果是手机，建议只有其中一路是大画面，其他都是小画面，这样硬件更容易扛得住，同时减少流量。 . 这边把320×240及以上大小的画面认为是大画面；反之，认为是小画面。 . 实际上请求到的画面大小，由发送方决定。如A传的画面是小画面，即使这边即使想请求它的大画面，也只能请求到的小画面。 . 发送方传的画面大小，是否同时有大画面和小画面，由其所设置的编解码参数、场景、硬件、网络等因素决定。 . requestViewList和cancelAllView不能并发执行，即同一时间点只能进行一种操作。 . requestViewList与cancelAllView配对使用，不能与requestView和cancelView交叉使用。 . identifierList和viewList的成员个数必须等于count，同时每个成员是一一对应的。 不能调用此方法请求自己的画面，自己的会被过滤掉。

Parameters:

identifierList - 成员id列表。

viewList - 视频画面参数列表。

count - 请求画面个数。

completeCallback - 回调对象，指向App定义的回调方法。

Returns:

AV_OK表示调用成功，其他值表示失败：

• AV_ERR_FAILED 房间已经不存在、内部获取对方信息失败、不支持传入的视频源类型。

See Also:

View

cancelAllView

public static int cancelAllView(AVEndpoint.CancelAllViewCompleteCallback completeCallback)

取消所有请求的视频画面。
异步返回结果。和requestViewList对应的逆操作，约束条件和requestViewList一样。
注意： . requestViewList和cancelAllView不能并发执行，即同一时间点只能进行一种操作。 . requestViewList与cancelAllView配对使用，不能与requestView和cancelView交叉使用。

Parameters:

completeCallback - 回调对象，指向App定义的回调函数。

Returns:

AV_OK表示调用成功，其他值表示失败：

• AV_ERR_FAILED 房间已经不存在、内部获取对方信息失败、不支持传入的视频源类型。

hasAudio

public boolean hasAudio()

判断成员是否有音频上行。 同步返回结果。

Returns:

true表示有音频上行，false表示无音频上行。

hasCameraVideo

public boolean hasCameraVideo()

判断成员是否有摄像头视频上行。 同步返回结果。

Returns:

true表示有视频上行，false表示无视频上行。

hasScreenVideo

public boolean hasScreenVideo()

判断成员是否有屏幕视频上行。 同步返回结果。

Returns:

true表示有视频上行，false表示无视频上行。