Interface Call.Content.DRAFT

Interface Index (Compact) | Summary | Description | Methods | Signals | Properties | Types

Methods

Remove (u: Reason, s: Detailed_Removal_Reason, s: Message) → nothing

Signals

StreamsAdded (ao: Streams)
StreamsRemoved (ao: Streams)

Properties

Interfaces as (DBus_Interface_List) Read only
Name s Read only
Type u (Media_Stream_Type) Read only
Creator u (Contact_Handle) Read only
Disposition u (Call_Content_Disposition) Read only
Streams ao Read only
Packetization u (Call_Content_Packetization_Type) Read only

Types

Content_Removal_Reason Enum u
Call_Content_Disposition Enum u
Call_Content_Packetization_Type Enum u
WARNING: This interface is experimental and is likely to cause havoc to your API/ABI if bindings are generated. Do not include this interface in libraries that care about compatibility.
Added in 0.19.0. (draft 1)

Description

This object represents one Content inside a Call. For example in an audio/video call there would be one audio and one video content. Each content has one or more Stream.DRAFT objects which represent the actual transport to one or more contacts.

Methods

(Permalink)

Remove (u: Reason, s: Detailed_Removal_Reason, s: Message) → nothing

Parameters

  • Reason — u (Content_Removal_Reason)
    • A generic hangup reason.
  • Detailed_Removal_Reason — s (DBus_Error_Name)
    • A more specific reason for the content removal, if one is available, or an empty string otherwise.
  • Message — s
    • A human-readable message for the reason of removing the content, for example "Fatal streaming failure", "no codec intersection", etc. This property can be left empty if no reason is to be given.
Remove the content from the call.

Possible Errors

  • Network Error
    • Raised when there is an error reading from or writing to the network.
  • Not Implemented
    • Raised when a Call doesn't support removing contents (e.g. a Google Talk video call)

Signals

(Permalink)

StreamsAdded (ao: Streams)

Parameters

  • Streams — ao
    • The streams which were added.

Emitted when streams are added to a call.

(Permalink)

StreamsRemoved (ao: Streams)

Parameters

  • Streams — ao
    • The streams which were removed.

Emitted when streams are removed from a call

Properties

Accessed using the org.freedesktop.DBus.Properties interface.
(Permalink)

Interfaces — as (DBus_Interface_List)

Read only
Added in 0.19.11.

Extra interfaces provided by this content, such as Content.Interface.Media.DRAFT or Content.Interface.Mute.DRAFT. This SHOULD NOT include the Content interface itself, and cannot change once the content has been created.

(Permalink)

Name — s

Read only

The name of the content.

Rationale:
The content name property should be meaningful, so should be given a name which is significant to the user. The name could be a localized "audio", "video" or perhaps include some string identifying the source, such as a webcam identifier.
(Permalink)

Type — u (Media_Stream_Type)

Read only

The media type of this content

(Permalink)

Creator — u (Contact_Handle)

Read only

The creator of this content

(Permalink)

Disposition — u (Call_Content_Disposition)

Read only
The disposition of this content. This property cannot change.
(Permalink)

Streams — ao

Read only

The list of Stream.DRAFT objects that exist in this content.

Rationale:

In a conference call multiple parties can share one media content (say, audio), but the streaming of that media can either be shared or separate. For example, in a multicast conference all contacts would share one stream, while in a Muji conference there would be a stream for each participant.

Change notification is via StreamsAdded and StreamsRemoved.

(Permalink)

Packetization — u (Call_Content_Packetization_Type)

Read only

The packetization method in use for this content. This property is immutable.

Types

Enum (Permalink)

Content_Removal_Reason — u

A simple representation of the reason for a content to be removed, which may be used by simple clients, or used as a fallback when the DBus_Reason is not understood.
  • Unknown (0)
    • We just don't know. Unknown values of this enum SHOULD also be treated like this.
  • User_Requested (1)

    • The local user requests that this content is removed from the call.

  • Error (2)

    • There is an error with the content which means that it has to be removed from the call.

  • Unsupported (3)

    • Some aspect of the content is unsupported so has to be removed from the call.

Enum (Permalink)

Call_Content_Disposition — u

[FIXME]
  • None (0)
    • The content has no specific disposition
  • Early_Media (1)
    • [FIXME: what does this mean?]
  • Initial (2)

    • The content was initially part of the call. When Accept is called on the channel, all streams of this content where the self-handle's sending state in Members is Sending_State_Pending_Send will be moved to Sending_State_Sending as if SetSending (TRUE) had been called.

Enum (Permalink)

Call_Content_Packetization_Type — u

A packetization method that can be used for a content.
  • RTP (0)
    • Real-time Transport Protocol, as documented by RFC 3550.
  • raw (1)
    • Raw media.
  • MSN_Webcam (2)
    • MSN webcam. This is the video-only one-way type which was used in earlier versions of WLM. Although no longer used, modern WLM clients still support the MSN webcam protocol.