PJSUA java_PJSUA2开发文档--第三章 PJSUA2高级API

3.1.5 搭档 Buddy

该类代表一个远程伙伴(一个人或一个SIP端点)。您可以订阅好友的状态来了解好友是否在线/离线等等，您可以向/从伙伴发送和接收即时消息。

3.2 一般概念

3.2.1 类使用模式

使用上面的主类的方法，可以很容易地调用对象的各种操作。但是我们如何从这些类中获取事件/通知？以上每个主要类(Media除外)将在回调方法中获取他们的事件。所以要处理这些事件，只需从对应的类(Endpoint，Call，Account或Buddy)派生一个类，并实现/重载相关的方法(取决于想要处理的事件)。更多内容将在后面的章节中进行说明。

3.2.2错误处理

使用异常作为报告错误的手段，因为这将使程序更自然地流动。产生错误的操作会引起错误异常。如果希望以更结构化的方式显示错误，则Error类有几个成员来解释错误，例如引发错误的操作名称，错误代码和错误消息本身。

3.2.3 异步操作

如果您已经使用PJSIP开发应用程序，那么您已经了解了这些应用程序。在PJSIP中，涉及发送和接收SIP消息的所有操作都是异步的，这意味着调用该操作的功能将立即完成，您将在回调中获得完成状态。

例如Call类的makeCall( ) 方法。此功能用于启动到目的地的呼出。当此函数成功返回时，并不意味着该呼叫已经建立，而是意味着该呼叫已成功启动。您将在Call类的onCallState()回调方法中获取呼叫进度和/或完成的报告。

3.2.4 线程

对于需要轮询的平台，PJSUA2模块提供自己的工作线程来轮询PJSIP，因此无需实例化您的轮询线程。如前所述，应用程序应该准备好让主线程调用不同线程的回调。PJSUA2模块本身是线程安全的。

通常，尤其是如果使用高级语言(如Python)调用PJSUA2，则需要通过将EpConfig.uaConfig.threadCnt 设置为0，来禁用PJSUA2内部工作线程。因为高级环境不喜欢被外部线程调用(如PJSIP的工作线程)。

3.2.5 垃圾收集问题

垃圾收集(Garbage collection，GC)存在于Java和Python(和其他语言，但现在我们不支持这些)，并且在PJSUA2使用方面存在一些问题：

在Java和Python空间中创建的PJSUA2对象的过早析构，并传递给本机空间，而不保留对对象的引用

它延迟了对象(包括PJSUA2对象)的析构，导致对象的析构函数中的代码无序执行

GC的销毁操作可以在之前未注册到PJLIB的不同线程上运行，从而导致断言assertion

当使用 Account.addBuddy()或者通过调用 EpConfig.LogConfig.setLogWriter()设置LogWriter，将Buddy对象添加到一个帐户时，问题1的一些示例(这些示例绝不是完整的列表)。为了避免这个问题，应用程序需要维护在其应用程序中创建的对象的显式引用，而不是依赖于PJSUA2本机库来跟踪这些对象，如：

classMyApp {privateMyLogWriter logWriter;public voidinit()

{/*Maintain reference to log writ