destroy method

Future<void> destroy ()

销毁 RtcEngine 实例。

该方法释放 Agora SDK 使用的所有资源。有些 app 只在用户需要时才进行语音通话, 不需要时则将资源释放出来用于其他操作,该方法对这类程序可能比较有用。只要调用了 RtcEngine.destroy 方法, 用户将无法再使用和回调该 SDK 内的其它方法。如需再次使用通信功能,必须重新创建一个 RtcEngine 实例。

Note

  • 该方法需要在子线程中操作。
  • 该方法为同步调用。在等待 RtcEngine 实例资源释放后再返回。 APP 不应该在 SDK 产生的回调中调用该接口,否则由于 SDK 要等待回调返回才能回收相关的对象资源,会造成死锁。
  • 如果需要在销毁后再次创建 RtcEngine 实例,需要等待 RtcEngine.destroy 方法执行结束, 收到返回值后才能再创建实例。

Implementation

@override
Future<void> destroy() {
  RtcChannel.destroyAll();
  _engine = null;
  return _invokeMethod('destroy');
}