pjsip开发——Account

Account提供正在使用该应用程序的用户的身份（或身份）。一个帐户有一个与之相关的SIP统一资源标识符（URI）。

必须在应用程序中创建至少一个Account，因为任何外发请求都需要一个Account上下文。如果不需要用户关联，应用程序可以通过调用Account.create（）来创建一个无用户帐户。无用户帐户识别本地端点而不是特定用户，并且它对应于特定的传输ID。

还有一个Account必须设置为默认Account，当pjsua使用更严格的匹配规则无法将传入请求与任何帐户匹配时，用作帐户身份。

自定义Account类

要使用Account类，通常根据需求来自定义自己的实现类，以便接收该帐户的通知。例如：

   public MyBuddy addBuddy(BuddyConfig bud_cfg) {
    /* Create Buddy */
        MyBuddy bud = new MyBuddy(bud_cfg);
        try {
            bud.create(this, bud_cfg);
        } catch (Exception e) {
            bud.delete();
            bud = null;
        }

        if (bud != null) {
            buddyList.add(bud);
            if (bud_cfg.getSubscribe())
                try {
                    bud.subscribePresence(true);
                } catch (Exception e) {
                }
        }

        return bud;
    }

    public void delBuddy(MyBuddy buddy) {
        buddyList.remove(buddy);
        buddy.delete();
    }

    public void delBuddy(int index) {
        MyBuddy bud = buddyList.get(index);
        buddyList.remove(index);
        bud.delete();
    }

    @Override
    public void onRegState(OnRegStateParam prm) {
        MyApp.observer.notifyRegState(prm.getCode(), prm.getReason(),
                prm.getExpiration());
    }

    @Override
    public void onIncomingCall(OnIncomingCallParam prm) {
        System.out.println("======== Incoming call ======== ");
        MyCall call = new MyCall(this, prm.getCallId());
        MyApp.observer.notifyIncomingCall(call);
    }

    @Override
    public void onInstantMessage(OnInstantMessageParam prm) {
        System.out.println("======== Incoming pager ======== ");
        System.out.println("From     : " + prm.getFromUri());
        System.out.println("To       : " + prm.getToUri());
        System.out.println("Contact  : " + prm.getContactUri());
        System.out.println("Mimetype : " + prm.getContentType());
        System.out.println("Body     : " + prm.getMsgBody());
    }
}

在其子类中，应用程序可以实现帐户回调，基本用于处理与该帐户相关的事件，如：

• SIP注册的状态
• 传入呼叫
• 传入存在订阅请求
• 不是从伙伴传入的即时消息

应用程序需要覆盖派生类中的相关回调方法来处理这些特定事件。

如果未处理事件，将调用默认操作：

• 来电将不被处理
• 传入的存在订阅请求将被接受
• 来自非伙伴的传入即时消息将被忽略

创建帐号

我们需要配置AccountConfig并调用Account.create（）来创建帐户。至少，pjsua只需要帐户的ID，这是一个URI来标识帐户（或者在SIP术语中，它被称为记录地址/ AOR）。

    public MyAccount addAcc(AccountConfig cfg) {
        MyAccount acc = new MyAccount(cfg);
        try {
            acc.create(cfg);
        } catch (Exception e) {
            acc = null;
            return null;
        }

        accList.add(acc);
        return acc;
    }

以上创建的帐户不会执行任何操作，除非在发件人的“发件人”标题中提供身份。该帐户不会注册到SIP服务器或任何东西。

通常，将希望该帐户认证并注册到SIP服务器，以便可以接收来电。为此，需要在AccountConfig中配置一些更多设置，如下所示：

accCfg = new AccountConfig();
accCfg.setIdUri("sip:localhost");
accCfg.getNatConfig().setIceEnabled(true);
accCfg.getVideoConfig().setAutoTransmitOutgoing(true);
accCfg.getVideoConfig().setAutoShowIncoming(true);

帐户配置

在AccountConfig中可以指定更多的设置，如：

• AccountRegConfig，指定注册设置，如注册服务器和重试间隔。
• AccountSipConfig，用于指定SIP设置，如凭证信息和代理服务器。
• AccountCallConfig，用于指定呼叫设置，例如是否需要可靠的临时响应（SIP 100rel）。
• AccountPresConfig来指定状态设置，例如是否启用在线发布（PUBLISH）。
• AccountMwiConfig，指定MWI（留言等待指示）设置。
• AccountNatConfig，用于指定NAT设置，例如是否使用STUN或ICE。
• AccountMediaConfig，用于指定媒体设置，如安全RTP（SRTP）相关设置。
• AccountVideoConfig，用于指定视频设置，如默认捕获和渲染设备。

Account对象能够进行的操作：

• 管理注册
• 管理好友/联系人
• 管理在线状态

关于上述详细类信息参考可以参照官方文档pjsip-book