Method createDataStream [1/2]
createDataStream [1/2]
创建数据流。
Java
public abstract int createDataStream(boolean reliable, boolean ordered);
你可以调用该方法创建数据流并提高数据传输的可靠性和有序性。
调用时机
该方法在加入频道前后均可调用。
调用限制
在 RtcEngine 生命周期内,每个用户最多只能创建 5 个数据流。离开频道时数据流会被销毁,如需使用需要重新创建数据流。
相关回调
将 reliable 设置为 true
后,如果接收方 5 秒没有收到发送方所发送的数据,会触发 onStreamMessageError 回调并获得相应报错信息。
参数
- reliable
- 是否保证数据可靠性,即接收方是否需要在数据发送后的 5 秒内接收:
true
: 接收方 5 秒内会收到发送方所发送的数据,否则会收到 onStreamMessageError 回调并获得相应报错信息。false
: 接收方不保证收到,就算数据丢失也不会报错。
注意请确保将 reliable 和 ordered 同时设为true
或同时设为false
。 - ordered
- 是否保证数据有序性,即接收方是否需要收到有序的数据:
true
: 接收方会按照发送方发送的顺序收到数据包。false
: 接收方不保证按照发送方发送的顺序收到数据包。
返回值
- 创建的数据流的 ID:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。