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

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 135,099评论 19 139
  • 1 Spring框架 1.1 Spring框架 Spring框架是一个分层架构,由7个定义良好的模块组成。Spr...
    Kevin_Junbaozi阅读 1,673评论 0 20
  • 今天下午我回到家,女儿已经到家了。自己做的泡面吃。而我在路上买点吃了。她吃完了就开始写作业了,过了一会女儿把作业写...
    肖琳的妈妈阅读 210评论 0 0
  • 文.孙亮 借助风的速度 去追赶你离去的脚步 眼神像滚落的雨珠 跌跌撞撞打湿了 你或许永不归的归途 回忆衍生模糊 留...
    朦胧诗人孙亮阅读 213评论 2 6
  • 亲子阅读第307天(2月19日) 今天晚上给崽崽讲了一个名叫《上善若水》的故事。故事讲的是世间万物都需要水...
    vv167阅读 297评论 0 0