blob: e9d0f21dd47ee634a88f6bcdd2f6386e5f96d8f9 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
/*
* Jitsi, the OpenSource Java VoIP and Instant Messaging client.
*
* Copyright @ 2015 Atlassian Pty Ltd
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.java.sip.communicator.service.protocol;
/**
* Provides operations necessary to create and handle conferencing calls through
* a video bridge.
*
* @author Yana Stamcheva
*/
public interface OperationSetVideoBridge
extends OperationSet
{
/**
* The name of the property under which the user may specify if
* video bridge should be disabled.
*/
public static final String IS_VIDEO_BRIDGE_DISABLED
= "net.java.sip.communicator.service.protocol.VIDEO_BRIDGE_DISABLED";
/**
* Creates a conference call with the specified callees as call peers via a
* video bridge provided by the parent Jabber provider.
*
* @param callees the list of addresses that we should call
* @return the newly created conference call containing all CallPeers
* @throws OperationFailedException if establishing the conference call
* fails
* @throws OperationNotSupportedException if the provider does not have any
* conferencing features.
*/
public Call createConfCall(String[] callees)
throws OperationFailedException,
OperationNotSupportedException;
/**
* Invites the callee represented by the specified uri to an already
* existing call. The difference between this method and createConfCall is
* that inviteCalleeToCall allows a user to transform an existing 1-to-1
* call into a conference call, or add new peers to an already established
* conference.
*
* @param uri the callee to invite to an existing conf call.
* @param call the call that we should invite the callee to.
* @return the CallPeer object corresponding to the callee represented by
* the specified uri.
* @throws OperationFailedException if inviting the specified callee to the
* specified call fails
* @throws OperationNotSupportedException if allowing additional callees to
* a pre-established call is not supported.
*/
public CallPeer inviteCalleeToCall(String uri, Call call)
throws OperationFailedException,
OperationNotSupportedException;
/**
* Indicates if there's an active video bridge available at this moment. The
* Jabber provider may announce support for video bridge, but it should not
* be used for calling until it becomes actually active.
*
* @return <tt>true</tt> to indicate that there's currently an active
* available video bridge, <tt>false</tt> - otherwise
*/
public boolean isActive();
}
|
