A-A+

UCMA开发-SignalingSession

2016年04月29日 技术 暂无评论 阅读 3,686 次

索引请点击这里

本文的目的在于讲解如何创建、使用SignalingSession，为之后构建自动应答机器人做准备。

1. Constructors

名称 说明
SignalingSession(RealTimeEndpoint, RealTimeAddress) 使用端点(EndPoint)和目标初始化一个信令会话(SignalingSession)

2. Methods

名称 说明
BeginAccept(AsyncCallback, Object) 接受会话
BeginEstablish(AsyncCallback, Object) 建立会话
BeginParticipate(AsyncCallback, Object) 加入一个会话，这个方法需要调用(用户传入和传出消息)已建立的会话
BeginSendMessage(MessageType, ContentType, Byte [],AsyncCallback, Object) 发送一条消息，会话应该在连接状态
BeginSendMessage(MessageType, ContentType, Byte [],IEnumerable<SignalingHeader>, AsyncCallback, Object)
BeginTerminate(AsyncCallback, Object) 异步终止会话，本次会话将不再可用

3. Properties

名称 说明
OfferAnswerNegotiation 获取或设置由调用者实现并提供的应答协商接口
State 获取或设置会话的状态

4. Events

名称 说明
MessageReceived 收到消息时触发

5. Example

  1. //直接建立SignalingSession，并发送消息
  2. RealTimeAddress target = new RealTimeAddress(strRemoteUri);
  3. SignalingSession session = new SignalingSession(sipEndPoint, target);
  4. session.OfferAnswerNegotiation = this;
  5. try
  6. {
  7.     session.EndEstablish(session.BeginEstablish(null, null));
  8.     break;
  9. }
  10. catch
  11. {
  12.     Thread.Sleep(10);
  13. }
  14. ContentType contentType = new ContentType("text/plain; charset=UTF-8");
  15. byte[] msgBody = Encoding.UTF8.GetBytes(strMessage);
  16. try
  17. {
  18.     session.SendMessage(
  19.         MessageType.Message,
  20.         contentType,
  21.         msgBody);
  22. }
  23. catch (Exception ex)
  24. {
  25.     throw ex;
  26. }
  27. session.EndTerminate(session.BeginTerminate(null, null));
  29. //通过SipEndPoint的SessionReceived事件来建立
  30. void SipEndpoint_SessionReceived(object sender, SessionReceivedEventArgs e)
  31. {
  32.     e.Session.OfferAnswerNegotiation = this;
  33.     //开始参与该会话Session
  34.     try
  35.     {
  36.         e.Session.BeginParticipate(
  37.             new AsyncCallback(ParticipateCallback), e.Session);
  38.     }
  39.     catch
  40.     {
  41.     }
  42. }
  43. //参与处理回发事件
  44. void ParticipateCallback(IAsyncResult ar)
  45. {
  46.     SignalingSession session = ar.AsyncState as SignalingSession;
  47.     SipMessageData response = null;
  48.     try
  49.     {
  50.         response = session.EndParticipate(ar);
  51.         session.SendMessage(
  52.             MessageType.Message,
  53.             contentType,
  54.             msgBody);
  55.     }
  56.     catch
  57.     {
  58.     }
  59. }

关于“Session.OfferAnswerNegotiation = this;”的解释：

this其实代表了继承IOfferAnswer接口的类，在示例中，因为代码段所属的类继承并实现了IOfferAnswer接口的，所以可以直接将自己赋值给OfferAnswerNegotiation属性，IOfferAnswer的实现见下面的示例代码：

  1. #region IOfferAnswer 接口实现
  2. //Occurs when we receive and INVITE with no offer
  3. public ContentDescription GetAnswer(object sender, ContentDescription offer)
  4. {
  5.     return GetContentDescription((SignalingSession)sender);
  6. }
  8. //Occurs when we receive an invite with an offer
  9. public ContentDescription GetOffer(object sender)
  10. {
  11.     return GetContentDescription((SignalingSession)sender);
  12. }
  14. //Occurs in Reinvite cases
  15. public void HandleOfferInInviteResponse(object sender, OfferInInviteResponseEventArgs e)
  16. {
  17.     return;
  18. }
  20. //Occurs in Reinvite cases
  21. public void HandleOfferInReInvite(object sender, OfferInReInviteEventArgs e)
  22. {
  23.     return;
  24. }
  26. //Occurs when we initiate the invite
  27. public void SetAnswer(object sender, ContentDescription answer)
  28. {
  29.     SignalingSession session = sender as SignalingSession;
  30.     byte[] Answer = answer.GetBody();
  31.     if (Answer != null)
  32.     {
  33.         Sdp<SdpGlobalDescription, SdpMediaDescription> sessionDescription =
  34.             new Sdp<SdpGlobalDescription, SdpMediaDescription>();
  35.         if (!sessionDescription.TryParse(Answer))
  36.         {
  37.             session.BeginTerminate(null, session);
  38.             return;
  39.         }
  40.         else
  41.         {
  42.             IList<SdpMediaDescription> ActiveMediaTypes =
  43.                 sessionDescription.MediaDescriptions;
  44.             if ((ActiveMediaTypes.Count == 1) &&
  45.                 (ActiveMediaTypes[0].MediaName.Equals("message",
  46.                     StringComparison.Ordinal)) &&
  47.                 (ActiveMediaTypes[0].Port > 0) &&
  48.                 (ActiveMediaTypes[0].TransportProtocol.Equals("sip",
  49.                     StringComparison.OrdinalIgnoreCase)))
  50.             {
  51.             }
  52.             else
  53.             {
  54.                 session.BeginTerminate(null, session);
  55.             }
  56.         }
  57.     }
  58. }
  60. //Retrieves the content description for offers and answers
  61. private ContentDescription GetContentDescription(SignalingSession session)
  62. {
  63.     IPAddress ipAddress;
  64.     // This method is called back every time an outbound INVITE is sent.
  65.     if (session.Connection != null)
  66.     {
  67.         ipAddress = session.Connection.LocalEndpoint.Address;
  68.     }
  69.     else
  70.     {
  71.         ipAddress = IPAddress.Any;
  72.     }
  73.     Sdp<SdpGlobalDescription, SdpMediaDescription> sessionDescription =
  74.         new Sdp<SdpGlobalDescription, SdpMediaDescription>();
  75.     //Set the origin line of the SDP
  76.     //s, t, and v lines are automatically constructed
  77.     sessionDescription.GlobalDescription.Origin.Version = 0;
  78.     sessionDescription.GlobalDescription.Origin.SessionId = "0";
  79.     sessionDescription.GlobalDescription.Origin.UserName = "-";
  80.     sessionDescription.GlobalDescription.Origin.Connection.Set(ipAddress.ToString());
  81.     //Set the connection line
  82.     sessionDescription.GlobalDescription.Connection.TrySet(ipAddress.ToString());
  83.     SdpMediaDescription mditem = new SdpMediaDescription("message");
  84.     mditem.Port = 5061;
  85.     mditem.TransportProtocol = "sip";
  86.     mditem.Formats = "null";
  87.     SdpAttribute aitem = new SdpAttribute("accept-types", "text/plain");
  88.     mditem.Attributes.Add(aitem);
  89.     //Append the Media description to the Global description
  90.     sessionDescription.MediaDescriptions.Add(mditem);
  91.     ContentType ct = new ContentType("application/sdp");
  92.     return new ContentDescription(ct, sessionDescription.GetBytes());
  93. }
  94. #endregion
标签：

给我留言

Copyright © 字痕随行 保留所有权利.   Theme  Ality

用户登录

分享到：