SIST ES 202 391-12 V1.3.1:2008

SLOVENSKI STANDARD
SIST ES 202 391-12 V1.3.1:2008
01-september-2008
2GSUWLGRVWRSGRVWRULWYH26$6SOHWQHVWRULWYH3DUOD\;GHO
9HþSUHGVWDYQRVWQDNRQIHUHQFD3DUOD\;

Open Service Access (OSA) - Parlay X Web Services - Part 12: Multimedia Conference

2003-01.Slovenski inštitut za standardizacijo. Razmnoževanje celote ali delov tega standarda ni dovoljeno.

The present document may be made available in more than one electronic version or in print. In any case of existing or

perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF).

In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive

Users of the present document should be aware that the document may be subject to revision or change of status.

Information on the current status of this and other ETSI documents is available at

If you find errors in the present document, please send your comment to one of the following services:

DECT , PLUGTESTS , UMTS , TIPHON , the TIPHON logo and the ETSI logo are Trade Marks of ETSI registered

3GPP is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners.

Intellectual Property Rights................................................................................................................................5

Foreword.............................................................................................................................................................5

1 Scope........................................................................................................................................................6

2 References................................................................................................................................................6

2.1 Normative references.........................................................................................................................................6

3 Definitions and abbreviations...................................................................................................................7

3.1 Definitions..........................................................................................................................................................7

3.2 Abbreviations.....................................................................................................................................................7

4 Detailed service description .....................................................................................................................7

5 Namespaces..............................................................................................................................................8

6 Sequence diagrams...................................................................................................................................8

6.1 Setting up a conference ......................................................................................................................................8

6.2 Adding and Removing Media ..........................................................................................................................10

6.3 Conference owner disconnects .........................................................................................................................11

6.4 All participants disconnect ...............................................................................................................................12

6.5 Conference ended by application .....................................................................................................................13

7 XML Schema data type definition .........................................................................................................14

7.1 ConferenceStatus enumeration.........................................................................................................................14

7.2 ConferenceInfo structure..................................................................................................................................14

7.3 ParticipantInfo structure...................................................................................................................................14

7.4 ParticipantStatus enumeration..........................................................................................................................14

7.5 Media enumeration...........................................................................................................................................14

7.6 MediaDirection enumeration............................................................................................................................15

7.7 MediaInfo structure..........................................................................................................................................15

8 Web Service interface definition............................................................................................................15

8.1 Interface: MultimediaConference.....................................................................................................................15

8.1.1 Operation: createConference......................................................................................................................15

8.1.1.1 Input message: createConferenceRequest.............................................................................................16

8.1.1.2 Output message: createConferenceResponse........................................................................................16

8.1.1.3 Referenced faults...................................................................................................................................16

8.1.2 Operation: getConferenceInfo....................................................................................................................16

8.1.2.1 Input message: getConferenceInfoRequest ...........................................................................................16

8.1.2.2 Output message: getConferenceInfoResponse......................................................................................16

8.1.2.3 Referenced faults...................................................................................................................................17

8.1.3 Operation: endConference..........................................................................................................................17

8.1.3.1 Input message: endConferenceRequest.................................................................................................17

8.1.3.2 Output message: endConferenceResponse............................................................................................17

8.1.3.3 Referenced faults...................................................................................................................................17

8.1.4 Operation: inviteParticipant........................................................................................................................17

8.1.4.1 Input message: inviteParticipantRequest...............................................................................................17

8.1.4.2 Output message: inviteParticipantResponse.........................................................................................18

8.1.4.3 Referenced faults...................................................................................................................................18

8.1.5 Operation: disconnectParticipant................................................................................................................18

8.1.5.1 Input message: disconnectParticipantRequest.......................................................................................18

8.1.5.2 Output message: disconnectParticipantResponse..................................................................................18

8.1.5.3 Referenced faults...................................................................................................................................18

8.1.6 Operation: getParticipantInfo......................................................................................................................18

8.1.6.1 Input message: getParticipantInfoRequest ............................................................................................18

8.1.6.2 Output message: getParticipantInfoResponse.......................................................................................19

8.1.6.3 Referenced faults...................................................................................................................................19

8.1.7 Operation: getParticipants...........................................................................................................................19

8.1.7.1 Input message: getParticipantsRequest .................................................................................................19

8.1.7.2 Output message: getParticipantsResponse............................................................................................19

8.1.7.3 Referenced faults...................................................................................................................................19

8.1.8 Operation: addMediaForParticipant............................................................................................................19

8.1.8.1 Input message: addMediaForParticipantRequest..................................................................................20

8.1.8.2 Output message: addMediaForParticipantResponse.............................................................................20

8.1.8.3 Referenced faults...................................................................................................................................20

8.1.9 Operation: deleteMediaForParticipant........................................................................................................20

8.1.9.1 Input message: deleteMediaForParticipantRequest ..............................................................................20

8.1.9.2 Output message: deleteMediaForParticipantResponse.........................................................................20

8.1.9.3 Referenced faults...................................................................................................................................20

9 Fault definitions......................................................................................................................................21

9.1 PolicyException...............................................................................................................................................21

9.1.1 POL0240: Too many participants...............................................................................................................21

9.1.2 POL0241: Unavailable media.....................................................................................................................21

9.1.3 POL0242: Maximum duration exceeded ....................................................................................................21

9.2 ServiceException..............................................................................................................................................21

9.2.1 SVC0210: Duplicate media stream.............................................................................................................21

9.2.2 SVC0211: Media stream does not match....................................................................................................21

10 Service policies ......................................................................................................................................22

Annex A (normative): WSDL for Multimedia Conference ..............................................................23

Annex B (informative): Bibliography...................................................................................................24

History ..............................................................................................................................................................25

IPRs essential or potentially essential to the present document may have been declared to ETSI. The information

pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found

in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in

respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee

can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web

This ETSI Standard (ES) has been produced by ETSI Technical Committee Telecommunications and Internet

The present document is part 12 of a multi-part deliverable covering Open Service Access (OSA); Parlay X

The present document has been defined jointly between ETSI, The Parlay Group (http://www.parlay.org) and the 3GPP.

The present document is part 12 of the Stage 3 Parlay X 2 Web Services specification for Open Service Access (OSA).

The OSA specifications define an architecture that enables application developers to make use of network functionality

The present document specifies the Multimedia Conference Web Service. The following are defined here:

References are either specific (identified by date of publication and/or edition number or version number) or

• Non-specific reference may be made only to a complete document or a part thereof and only in the following

- if it is accepted that it will be possible to use all future changes of the referenced document for the

Referenced documents which are not found to be publicly available in the expected location might be found at

For online referenced documents, information sufficient to identify and locate the source shall be provided. Preferably,

the primary source of the referenced document should be cited, in order to ensure traceability. Furthermore, the

reference should, as far as possible, remain valid for the expected life of the document. The reference shall include the

method of access to the referenced document and the full network address, with the same punctuation and use of upper

NOTE: While any hyperlinks included in this clause were valid at the time of publication ETSI cannot guarantee

The following referenced documents are indispensable for the application of the present document. For dated

references, only the edition cited applies. For non-specific references, the latest edition of the referenced document

[2] ETSI ES 202 391-1: "Open Service Access (OSA); Parlay X Web Services; Part 1: Common

For the purposes of the present document, the terms and definitions given in ES 202 391-1 [2] apply.

For the purposes of the present document, the abbreviations given in ES 202 391-1 [2] apply.

The Multimedia Conferencing is a simple Web Service that allows the creation of a multimedia conference and the

• Conference: a "context" (uniquely identified) to which participants can be added/removed.

• Participant: each of the parties involved in the conference. Media can be added/removed for each participant.

There may exist a participant that is also the "owner" of the conference, i.e. the user who can end the call

• Media: the conference can utilize multiple media streams to support the participants' communication. In

particular both audio and video streams are available, including the specific stream direction (i.e. in, out,

An application setting up a multimedia conference must initially invoke the createConference operation. The result of

such invocation is the creation of a "context" that represents a "virtual" room where users can "meet". A unique

identifier is assigned to the just-created conference. At this stage no participant is connected.

Subsequently the application may wish to add participants to the conference. In order to do so the operation

inviteParticipant can be used. The result of such an operation is to alert the user of the incoming connection request

If the application wishes to check whether the user has accepted the invitation (i.e. is connected) it can invoke (at a later

• As soon as the first participant connects, the conference becomes "active". The duration of the conference is

• The initial media set utilized by the participant will depend on the conference type and the media actually

• Add (or remove) a specific media stream to a single participant: e.g. adding a video bidirectional stream to a

participant that has an audio connection to the conference. This can be obtained by invoking the

• Disconnect a participant from the conference, by invoking the disconnectParticipant operation.