org.freedesktop.Telepathy.Call.Content.DRAFT

# Interface org.freedesktop.Telepathy.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.

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.