Class: Ari::Bridge

Inherits:
Resource show all
Defined in:
lib/ari/resources/bridge.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Resource

#add_listener, client, #client, #remove_all_listeners!, #remove_listener

Methods inherited from Model

#attributes=, #initialize

Constructor Details

This class inherits a constructor from Ari::Model

Instance Attribute Details

#bridge_class ⇒ Object (readonly)

Returns the value of attribute bridge_class.



15
16
17
 
# File 'lib/ari/resources/bridge.rb', line 15

def bridge_class
  @bridge_class
end

#bridge_type ⇒ Object (readonly)

Returns the value of attribute bridge_type.



15
16
17
 
# File 'lib/ari/resources/bridge.rb', line 15

def bridge_type
  @bridge_type
end

#channels ⇒ Object (readonly)

Returns the value of attribute channels.



15
16
17
 
# File 'lib/ari/resources/bridge.rb', line 15

def channels
  @channels
end

#creator ⇒ Object (readonly)

Returns the value of attribute creator.



15
16
17
 
# File 'lib/ari/resources/bridge.rb', line 15

def creator
  @creator
end

#id ⇒ Object (readonly)

Returns the value of attribute id.



15
16
17
 
# File 'lib/ari/resources/bridge.rb', line 15

def id
  @id
end

#name ⇒ Object (readonly)

Returns the value of attribute name.



15
16
17
 
# File 'lib/ari/resources/bridge.rb', line 15

def name
  @name
end

#technology ⇒ Object (readonly)

Returns the value of attribute technology.



15
16
17
 
# File 'lib/ari/resources/bridge.rb', line 15

def technology
  @technology
end

Class Method Details

.add_channel(options = {}) ⇒ Object

POST /bridges/%bridgeId/addChannel

Add a channel to a bridge

Parameters:

bridgeId (required) - Bridge’s id channel (required) - Ids of channels to add to bridge role - Channel’s role in the bridge

Raises:

  • (ArgumentError) 


121
122
123
124
125
126
 
# File 'lib/ari/resources/bridge.rb', line 121

def self.add_channel(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  raise ArgumentError.new("Parameter channel must be passed in options hash.") unless options[:channel]
  path = '/bridges/%{bridgeId}/addChannel' % options
  response = client(options).post(path, options)
end

.addChannel ⇒ Object

POST /bridges/%bridgeId/addChannel

Add a channel to a bridge

Parameters:

bridgeId (required) - Bridge’s id channel (required) - Ids of channels to add to bridge role - Channel’s role in the bridge

Raises:

  • (ArgumentError) 


127
128
129
130
131
132
 
# File 'lib/ari/resources/bridge.rb', line 127

def self.add_channel(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  raise ArgumentError.new("Parameter channel must be passed in options hash.") unless options[:channel]
  path = '/bridges/%{bridgeId}/addChannel' % options
  response = client(options).post(path, options)
end

.create(options = {}) ⇒ Object

POST /bridges

Active bridges

Parameters:

type - Comma separated list of bridge type attributes (mixing, holding, dtmf_events, proxy_media). bridgeId - Unique ID to give to the bridge being created. name - Name to give to the bridge being created.



40
41
42
43
44
 
# File 'lib/ari/resources/bridge.rb', line 40

def self.create(options = {})
  path = '/bridges'
  response = client(options).post(path, options)
  Bridge.new(response.merge(client: options[:client]))
end

.create_with_id(options = {}) ⇒ Object

POST /bridges/%bridgeId

Individual bridge

Parameters:

type - Comma separated list of bridge type attributes (mixing, holding, dtmf_events, proxy_media) to set. bridgeId (required) - Unique ID to give to the bridge being created. name - Set the name of the bridge.

Raises:

  • (ArgumentError) 


57
58
59
60
61
62
 
# File 'lib/ari/resources/bridge.rb', line 57

def self.create_with_id(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  path = '/bridges/%{bridgeId}' % options
  response = client(options).post(path, options)
  Bridge.new(response.merge(client: options[:client]))
end

.createWithId ⇒ Object

POST /bridges/%bridgeId

Individual bridge

Parameters:

type - Comma separated list of bridge type attributes (mixing, holding, dtmf_events, proxy_media) to set. bridgeId (required) - Unique ID to give to the bridge being created. name - Set the name of the bridge.

Raises:

  • (ArgumentError) 


63
64
65
66
67
68
 
# File 'lib/ari/resources/bridge.rb', line 63

def self.create_with_id(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  path = '/bridges/%{bridgeId}' % options
  response = client(options).post(path, options)
  Bridge.new(response.merge(client: options[:client]))
end

.destroy(options = {}) ⇒ Object

DELETE /bridges/%bridgeId

Individual bridge

Parameters:

bridgeId (required) - Bridge’s id



98
99
100
101
102
103
104
 
# File 'lib/ari/resources/bridge.rb', line 98

def self.destroy(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  path = '/bridges/%{bridgeId}' % options
  response = client(options).delete(path, options)
rescue Ari::RequestError => e
  raise unless e.code == '404'
end

.get(options = {}) ⇒ Object

GET /bridges/%bridgeId

Individual bridge

Parameters:

bridgeId (required) - Bridge’s id

Raises:

  • (ArgumentError) 


78
79
80
81
82
83
 
# File 'lib/ari/resources/bridge.rb', line 78

def self.get(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  path = '/bridges/%{bridgeId}' % options
  response = client(options).get(path, options)
  Bridge.new(response.merge(client: options[:client]))
end

.list(options = {}) ⇒ Object

GET /bridges

Active bridges



23
24
25
26
27
 
# File 'lib/ari/resources/bridge.rb', line 23

def self.list(options = {})
  path = '/bridges'
  response = client(options).get(path, options)
  response.map { |hash| Bridge.new(hash.merge(client: options[:client])) }
end

.play(options = {}) ⇒ Object

POST /bridges/%bridgeId/play

Play media to the participants of a bridge

Parameters:

bridgeId (required) - Bridge’s id media (required) - Media’s URI to play. lang - For sounds, selects language for sound. offsetms - Number of media to skip before playing. skipms - Number of milliseconds to skip for forward/reverse operations. playbackId - Playback Id.

Raises:

  • (ArgumentError) 


212
213
214
215
216
217
218
 
# File 'lib/ari/resources/bridge.rb', line 212

def self.play(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  raise ArgumentError.new("Parameter media must be passed in options hash.") unless options[:media]
  path = '/bridges/%{bridgeId}/play' % options
  response = client(options).post(path, options)
  Playback.new(response.merge(client: options[:client]))
end

.play_with_id(options = {}) ⇒ Object

POST /bridges/%bridgeId/play/%playbackId

Play media to a bridge

Parameters:

bridgeId (required) - Bridge’s id playbackId (required) - Playback ID. media (required) - Media’s URI to play. lang - For sounds, selects language for sound. offsetms - Number of media to skip before playing. skipms - Number of milliseconds to skip for forward/reverse operations.

Raises:

  • (ArgumentError) 


238
239
240
241
242
243
244
245
 
# File 'lib/ari/resources/bridge.rb', line 238

def self.play_with_id(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  raise ArgumentError.new("Parameter playbackId must be passed in options hash.") unless options[:playbackId]
  raise ArgumentError.new("Parameter media must be passed in options hash.") unless options[:media]
  path = '/bridges/%{bridgeId}/play/%{playbackId}' % options
  response = client(options).post(path, options)
  Playback.new(response.merge(client: options[:client]))
end

.playWithId ⇒ Object

POST /bridges/%bridgeId/play/%playbackId

Play media to a bridge

Parameters:

bridgeId (required) - Bridge’s id playbackId (required) - Playback ID. media (required) - Media’s URI to play. lang - For sounds, selects language for sound. offsetms - Number of media to skip before playing. skipms - Number of milliseconds to skip for forward/reverse operations.

Raises:

  • (ArgumentError) 


246
247
248
249
250
251
252
253
 
# File 'lib/ari/resources/bridge.rb', line 246

def self.play_with_id(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  raise ArgumentError.new("Parameter playbackId must be passed in options hash.") unless options[:playbackId]
  raise ArgumentError.new("Parameter media must be passed in options hash.") unless options[:media]
  path = '/bridges/%{bridgeId}/play/%{playbackId}' % options
  response = client(options).post(path, options)
  Playback.new(response.merge(client: options[:client]))
end

.record(options = {}) ⇒ Object

POST /bridges/%bridgeId/record

Record audio on a bridge

Parameters:

bridgeId (required) - Bridge’s id name (required) - Recording’s filename format (required) - Format to encode audio in maxDurationSeconds - Maximum duration of the recording, in seconds. 0 for no limit. maxSilenceSeconds - Maximum duration of silence, in seconds. 0 for no limit. ifExists - Action to take if a recording with the same name already exists. beep - Play beep when recording begins terminateOn - DTMF input to terminate recording.

Raises:

  • (ArgumentError) 


268
269
270
271
272
273
274
275
 
# File 'lib/ari/resources/bridge.rb', line 268

def self.record(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  raise ArgumentError.new("Parameter name must be passed in options hash.") unless options[:name]
  raise ArgumentError.new("Parameter format must be passed in options hash.") unless options[:format]
  path = '/bridges/%{bridgeId}/record' % options
  response = client(options).post(path, options)
  LiveRecording.new(response.merge(client: options[:client]))
end

.remove_channel(options = {}) ⇒ Object

POST /bridges/%bridgeId/removeChannel

Remove a channel from a bridge

Parameters:

bridgeId (required) - Bridge’s id channel (required) - Ids of channels to remove from bridge

Raises:

  • (ArgumentError) 


143
144
145
146
147
148
 
# File 'lib/ari/resources/bridge.rb', line 143

def self.remove_channel(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  raise ArgumentError.new("Parameter channel must be passed in options hash.") unless options[:channel]
  path = '/bridges/%{bridgeId}/removeChannel' % options
  response = client(options).post(path, options)
end

.removeChannel ⇒ Object

POST /bridges/%bridgeId/removeChannel

Remove a channel from a bridge

Parameters:

bridgeId (required) - Bridge’s id channel (required) - Ids of channels to remove from bridge

Raises:

  • (ArgumentError) 


149
150
151
152
153
154
 
# File 'lib/ari/resources/bridge.rb', line 149

def self.remove_channel(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  raise ArgumentError.new("Parameter channel must be passed in options hash.") unless options[:channel]
  path = '/bridges/%{bridgeId}/removeChannel' % options
  response = client(options).post(path, options)
end

.start_moh(options = {}) ⇒ Object

POST /bridges/%bridgeId/moh

Play music on hold to a bridge

Parameters:

bridgeId (required) - Bridge’s id mohClass - Channel’s id

Raises:

  • (ArgumentError) 


165
166
167
168
169
 
# File 'lib/ari/resources/bridge.rb', line 165

def self.start_moh(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  path = '/bridges/%{bridgeId}/moh' % options
  response = client(options).post(path, options)
end

.startMoh ⇒ Object

POST /bridges/%bridgeId/moh

Play music on hold to a bridge

Parameters:

bridgeId (required) - Bridge’s id mohClass - Channel’s id

Raises:

  • (ArgumentError) 


170
171
172
173
174
 
# File 'lib/ari/resources/bridge.rb', line 170

def self.start_moh(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  path = '/bridges/%{bridgeId}/moh' % options
  response = client(options).post(path, options)
end

.stop_moh(options = {}) ⇒ Object

DELETE /bridges/%bridgeId/moh

Play music on hold to a bridge

Parameters:

bridgeId (required) - Bridge’s id



185
186
187
188
189
190
191
 
# File 'lib/ari/resources/bridge.rb', line 185

def self.stop_moh(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  path = '/bridges/%{bridgeId}/moh' % options
  response = client(options).delete(path, options)
rescue Ari::RequestError => e
  raise unless e.code == '404'
end

.stopMoh ⇒ Object

DELETE /bridges/%bridgeId/moh

Play music on hold to a bridge

Parameters:

bridgeId (required) - Bridge’s id



192
193
194
195
196
197
198
 
# File 'lib/ari/resources/bridge.rb', line 192

def self.stop_moh(options = {})
  raise ArgumentError.new("Parameter bridgeId must be passed in options hash.") unless options[:bridgeId]
  path = '/bridges/%{bridgeId}/moh' % options
  response = client(options).delete(path, options)
rescue Ari::RequestError => e
  raise unless e.code == '404'
end

Instance Method Details

#add_channel(options = {}) ⇒ Object 



129
130
131
 
# File 'lib/ari/resources/bridge.rb', line 129

def add_channel(options = {})
  self.class.add_channel(options.merge(bridgeId: self.id, client: @client))
end

#create_with_id(options = {}) ⇒ Object 



65
66
67
 
# File 'lib/ari/resources/bridge.rb', line 65

def create_with_id(options = {})
  self.class.create_with_id(options.merge(bridgeId: self.id, client: @client))
end

#destroy(options = {}) ⇒ Object 



106
107
108
 
# File 'lib/ari/resources/bridge.rb', line 106

def destroy(options = {})
  self.class.destroy(options.merge(bridgeId: self.id, client: @client))
end

#get(options = {}) ⇒ Object 



85
86
87
 
# File 'lib/ari/resources/bridge.rb', line 85

def get(options = {})
  self.class.get(options.merge(bridgeId: self.id, client: @client))
end

#play(options = {}) ⇒ Object 



220
221
222
 
# File 'lib/ari/resources/bridge.rb', line 220

def play(options = {})
  self.class.play(options.merge(bridgeId: self.id, client: @client))
end

#play_with_id(options = {}) ⇒ Object 



248
249
250
 
# File 'lib/ari/resources/bridge.rb', line 248

def play_with_id(options = {})
  self.class.play_with_id(options.merge(bridgeId: self.id, client: @client))
end

#record(options = {}) ⇒ Object 



277
278
279
 
# File 'lib/ari/resources/bridge.rb', line 277

def record(options = {})
  self.class.record(options.merge(bridgeId: self.id, client: @client))
end

#remove_channel(options = {}) ⇒ Object 



151
152
153
 
# File 'lib/ari/resources/bridge.rb', line 151

def remove_channel(options = {})
  self.class.remove_channel(options.merge(bridgeId: self.id, client: @client))
end

#start_moh(options = {}) ⇒ Object 



172
173
174
 
# File 'lib/ari/resources/bridge.rb', line 172

def start_moh(options = {})
  self.class.start_moh(options.merge(bridgeId: self.id, client: @client))
end

#stop_moh(options = {}) ⇒ Object 



194
195
196
 
# File 'lib/ari/resources/bridge.rb', line 194

def stop_moh(options = {})
  self.class.stop_moh(options.merge(bridgeId: self.id, client: @client))
end