addVideo
Applies to: Skype for Business 2015
Represents an operation to add video to an existing conversation.
For more on web links, see Web links.
Name | Description |
---|---|
rel | The resource that this link points to. In JSON, this is the outer container. |
href | The location of this resource on the server, and the target of an HTTP operation. |
None
None
The user must have at least one of these scopes for operations on the resource to be allowed.
Scope | Permission | Description |
---|---|---|
Conversations.Initiate | Initiate conversations and join meetings | Allows the app to initiate instant messages, audio, video, and desktop sharing conversations; and join meetings on-behalf of the signed-in user |
Conversations.Receive | Receive conversation invites | Allows the app to receive instant messages, audio, video, and desktop sharing invitations on-behalf of the signed-in user |
Adds Video to a Conversation and starts a VideoInvitation.
Name | Description | Required? |
---|---|---|
operationId | The ID that the application supplies to correlate its request with the corresponding operation started in the event channel.The maximum length is 50 characters. String | No |
mediaOffer | Gets and sets the sdp offers.ExternalResource | No |
sessionContext | Gets the session context.The maximum length is 50 characters. String | No |
joinVideoMuted | Sets the video mute status upon joining the online meeting.Nullable Boolean | No |
to | The contact that this invitation is to be sent to.String | Yes |
Item | Description |
---|---|
audioVideoInvitation | Represents an audio-video invitation. |
The errors below (if any) are specific to this resource. Generic errors that can apply to any resource are covered in Generic synchronous errors.
Error | Code | Subcode | Description |
---|---|---|---|
ServiceFailure | 500 | CallbackChannelError | The remote event channel is not reachable |
Conflict | 409 | AlreadyExists | The already exists error. |
Conflict | 409 | TooManyGroups | The too many groups error. |
Conflict | 409 | None | Un-supported Service/Resource/API error. |
Gone | 410 | CannotRedirect | Cannot redirect since there is no back up pool configured. |
Post https://fe1.contoso.com:443/ucwa/v1/applications/192/communication/addVideo HTTP/1.1
Authorization: Bearer cwt=PHNhbWw6QXNzZXJ0aW9uIHhtbG5...uZm8
Host: fe1.contoso.com
Content-Type: application/json
Content-Length: 235
{
"operationId" : "74cb7404e0a247d5a2d4eb0376a47dbf",
"sessionContext" : "8efd502350ff419cb615018ae561f97e",
"joinVideoMuted" : false,
"to" : "sip : john@contoso.com",
"_links" : {
"mediaOffer" : {
"href" : "data : application/sdp;base64,
base64-encoded-sdp"
}
}
}
This sample is given only as an illustration of response syntax. The semantic content is not guaranteed to correspond to a valid scenario.
HTTP/1.1 201 Created
Location: /ucwa/v1/applications/192/communication/invitations/507
Post https://fe1.contoso.com:443/ucwa/v1/applications/192/communication/addVideo HTTP/1.1
Authorization: Bearer cwt=PHNhbWw6QXNzZXJ0aW9uIHhtbG5...uZm8
Host: fe1.contoso.com
Content-Type: application/xml
Content-Length: 353
<?xml version="1.0" encoding="utf-8"?>
<input xmlns="http://schemas.microsoft.com/rtc/2012/03/ucwa">
<property name="operationId">74cb7404e0a247d5a2d4eb0376a47dbf</property>
<property name="sessionContext">8efd502350ff419cb615018ae561f97e</property>
<property name="joinVideoMuted">False</property>
<property name="to">sip:john@contoso.com</property>
</input>
This sample is given only as an illustration of response syntax. The semantic content is not guaranteed to correspond to a valid scenario.
HTTP/1.1 201 Created
Location: /ucwa/v1/applications/192/communication/invitations/507