Interface Call.Content.DRAFT

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

Methods

Remove () → nothing

Signals

StreamAdded (o: Stream)
StreamRemoved (o: Stream)

Properties

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

Types

Call_Content_Disposition 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 () → nothing

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)

StreamAdded (o: Stream)

Parameters

  • Stream — o
    • The stream which was added

Emitted when a stream is added to a call

(Permalink)

StreamRemoved (o: Stream)

Parameters

  • Stream — o
    • The stream which was removed

Emitted when a stream is added to a call

Properties

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

Name — s

Read only

The name of the content. [FIXME: rationale?]

(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 StreamAdded and StreamRemoved.

Types

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 Senders is Sending_State_Pending_Send will be moved to Sending_State_Sending as if SetSending(TRUE) had been called.