Handling Options Requests

Note: The current implementation for handling of OPTIONS requests, treats all options requests as out-of-dialog requests.

DUM and Profile Setup

• Add OPTIONS as a supported method: masterProfile.addSupportedMethod(OPTIONS);
• Add application/sdp as a supported mime type: masterProfile.addSupportedMimeType(OPTIONS, Mime("application", "sdp"));
• Add an OutOfDialogHandler to DUM: dum.addOutOfDialogHandler(OPTIONS, handler); // Note: handler pointer should be a class that inherits from OutOfDialogHandler

Initiating Out-of-Dialog OPTIONS Requests

Use the DialogUsageManager::makeOutOfDialogRequest(referTo) API. You can optionally add SDP info to the request before you send it.

SharedPtr<SipMessage> optionsMsg = dum.makeOutOfDialogRequest(toUri, OPTIONS);
// Add sdp
SdpContents sdp;
...code to fill in sdp...
optionsMsg->setContents(&sdp);
dum.send(optionsMsg);

Handling OPTIONS Requests

The application should implement the onReceivedRequest callback from the OutOfDialogHandler registered with dum. Sample Code:

virtual void onReceivedRequest(ServerOutOfDialogReqHandle ood, const SipMessage& request)
{
   switch(request.header(h_CSeq).method())
   {
   case OPTIONS:
   {
      SharedPtr<SipMessage> resp = ood->answerOptions();
      SdpContents sdp;
      ...code to fill in sdp...
      resp->setContents(&sdp);
      ood->send(resp);
      break;
   }
   ...
}