# encoding: utf-8
module Punchblock
module Component
class Output < ComponentNode
register :output, :output
##
# Creates an Rayo Output command
#
# @param [Hash] options
# @option options [String, Optional] :text to speak back
# @option options [String, Optional] :voice with which to render TTS
# @option options [String, Optional] :ssml document to render TTS
# @option options [Symbol] :interrupt_on input type on which to interrupt output. May be :speech, :dtmf or :any
# @option options [Integer] :start_offset Indicates some offset through which the output should be skipped before rendering begins.
# @option options [true, false] :start_paused Indicates wether or not the component should be started in a paused state to be resumed at a later time.
# @option options [Integer] :repeat_interval Indicates the duration of silence that should space repeats of the rendered document.
# @option options [Integer] :repeat_times Indicates the number of times the output should be played.
# @option options [Integer] :max_time Indicates the maximum amount of time for which the output should be allowed to run before being terminated. Includes repeats.
#
# @return [Command::Output] an Rayo "output" command
#
# @example
# output :text => 'Hello brown cow.'
#
# returns:
#
#
def self.new(options = {})
super().tap do |new_node|
case options
when Hash
new_node.ssml = options.delete(:ssml) if options[:ssml]
new_node << options.delete(:text) if options[:text]
options.each_pair { |k,v| new_node.send :"#{k}=", v }
when Nokogiri::XML::Element
new_node.inherit options
end
end
end
##
# @return [String] the TTS voice to use
#
def voice
read_attr :voice
end
##
# @param [String] voice to use when rendering TTS
#
def voice=(voice)
write_attr :voice, voice
end
##
# @return [String] the SSML document to render TTS
#
def ssml
node = children.first
RubySpeech::SSML.import node if node
end
##
# @param [String] ssml the SSML document to render TTS
#
def ssml=(ssml)
return unless ssml
unless ssml.is_a?(RubySpeech::SSML::Element)
ssml = RubySpeech::SSML.import ssml
end
self << ssml
end
##
# @return [Symbol] input type on which to interrupt output
#
def interrupt_on
read_attr :'interrupt-on', :to_sym
end
##
# @param [Symbol] other input type on which to interrupt output. May be :speech, :dtmf or :any
#
def interrupt_on=(other)
write_attr :'interrupt-on', other
end
##
# @return [Integer] Indicates some offset through which the output should be skipped before rendering begins.
#
def start_offset
read_attr :'start-offset', :to_i
end
##
# @param [Integer] other Indicates some offset through which the output should be skipped before rendering begins.
#
def start_offset=(other)
write_attr :'start-offset', other.to_i
end
##
# @return [true, false] Indicates wether or not the component should be started in a paused state to be resumed at a later time.
#
def start_paused
read_attr(:'start-paused') == 'true'
end
##
# @param [true, false] other Indicates wether or not the component should be started in a paused state to be resumed at a later time.
#
def start_paused=(other)
write_attr :'start-paused', other.to_s
end
##
# @return [Integer] Indicates the duration of silence that should space repeats of the rendered document.
#
def repeat_interval
read_attr :'repeat-interval', :to_i
end
##
# @param [Integer] other Indicates the duration of silence that should space repeats of the rendered document.
#
def repeat_interval=(other)
write_attr :'repeat-interval', other.to_i
end
##
# @return [Integer] Indicates the number of times the output should be played.
#
def repeat_times
read_attr :'repeat-times', :to_i
end
##
# @param [Integer] other Indicates the number of times the output should be played.
#
def repeat_times=(other)
write_attr :'repeat-times', other.to_i
end
##
# @return [Integer] Indicates the maximum amount of time for which the output should be allowed to run before being terminated. Includes repeats.
#
def max_time
read_attr :'max-time', :to_i
end
##
# @param [Integer] other Indicates the maximum amount of time for which the output should be allowed to run before being terminated. Includes repeats.
#
def max_time=(other)
write_attr :'max-time', other.to_i
end
def inspect_attributes
super + [:voice, :ssml, :interrupt_on, :start_offset, :start_paused, :repeat_interval, :repeat_times, :max_time]
end
state_machine :state do
event :paused do
transition :executing => :paused
end
event :resumed do
transition :paused => :executing
end
end
# Pauses a running Output
#
# @return [Command::Output::Pause] an Rayo pause message for the current Output
#
# @example
# output_obj.pause_action.to_xml
#
# returns:
#
def pause_action
Pause.new :component_id => component_id, :target_call_id => target_call_id
end
##
# Sends an Rayo pause message for the current Output
#
def pause!
raise InvalidActionError, "Cannot pause a Output that is not executing" unless executing?
pause_action.tap do |action|
result = write_action action
paused! if result
end
end
##
# Create an Rayo resume message for the current Output
#
# @return [Command::Output::Resume] an Rayo resume message
#
# @example
# output_obj.resume_action.to_xml
#
# returns:
#
def resume_action
Resume.new :component_id => component_id, :target_call_id => target_call_id
end
##
# Sends an Rayo resume message for the current Output
#
def resume!
raise InvalidActionError, "Cannot resume a Output that is not paused." unless paused?
resume_action.tap do |action|
result = write_action action
resumed! if result
end
end
class Pause < CommandNode # :nodoc:
register :pause, :output
end
class Resume < CommandNode # :nodoc:
register :resume, :output
end
##
# Creates an Rayo seek message for the current Output
#
# @return [Command::Output::Seek] a Rayo seek message
#
# @example
# output_obj.seek_action.to_xml
#
# returns:
#
def seek_action(options = {})
Seek.new({ :component_id => component_id, :target_call_id => target_call_id }.merge(options)).tap do |s|
s.original_component = self
end
end
##
# Sends a Rayo seek message for the current Output
#
def seek!(options = {})
raise InvalidActionError, "Cannot seek an Output that is already seeking." if seeking?
seek_action(options).tap do |action|
write_action action
end
end
state_machine :seek_status, :initial => :not_seeking do
event :seeking do
transition :not_seeking => :seeking
end
event :stopped_seeking do
transition :seeking => :not_seeking
end
end
class Seek < CommandNode # :nodoc:
register :seek, :output
def self.new(options = {})
super.tap do |new_node|
new_node.direction = options[:direction]
new_node.amount = options[:amount]
end
end
def direction=(other)
write_attr :direction, other
end
def amount=(other)
write_attr :amount, other
end
def request!
source.seeking!
super
end
def execute!
source.stopped_seeking!
super
end
end
##
# Creates an Rayo speed up message for the current Output
#
# @return [Command::Output::SpeedUp] a Rayo speed up message
#
# @example
# output_obj.speed_up_action.to_xml
#
# returns:
#
def speed_up_action
SpeedUp.new(:component_id => component_id, :target_call_id => target_call_id).tap do |s|
s.original_component = self
end
end
##
# Sends a Rayo speed up message for the current Output
#
def speed_up!
raise InvalidActionError, "Cannot speed up an Output that is already speeding." unless not_speeding?
speed_up_action.tap do |action|
write_action action
end
end
##
# Creates an Rayo slow down message for the current Output
#
# @return [Command::Output::SlowDown] a Rayo slow down message
#
# @example
# output_obj.slow_down_action.to_xml
#
# returns:
#
def slow_down_action
SlowDown.new(:component_id => component_id, :target_call_id => target_call_id).tap do |s|
s.original_component = self
end
end
##
# Sends a Rayo slow down message for the current Output
#
def slow_down!
raise InvalidActionError, "Cannot slow down an Output that is already speeding." unless not_speeding?
slow_down_action.tap do |action|
write_action action
end
end
state_machine :speed_status, :initial => :not_speeding do
event :speeding_up do
transition :not_speeding => :speeding_up
end
event :slowing_down do
transition :not_speeding => :slowing_down
end
event :stopped_speeding do
transition [:speeding_up, :slowing_down] => :not_speeding
end
end
class SpeedUp < CommandNode # :nodoc:
register :'speed-up', :output
def request!
source.speeding_up!
super
end
def execute!
source.stopped_speeding!
super
end
end
class SlowDown < CommandNode # :nodoc:
register :'speed-down', :output
def request!
source.slowing_down!
super
end
def execute!
source.stopped_speeding!
super
end
end
##
# Creates an Rayo volume up message for the current Output
#
# @return [Command::Output::VolumeUp] a Rayo volume up message
#
# @example
# output_obj.volume_up_action.to_xml
#
# returns:
#
def volume_up_action
VolumeUp.new(:component_id => component_id, :target_call_id => target_call_id).tap do |s|
s.original_component = self
end
end
##
# Sends a Rayo volume up message for the current Output
#
def volume_up!
raise InvalidActionError, "Cannot volume up an Output that is already voluming." unless not_voluming?
volume_up_action.tap do |action|
write_action action
end
end
##
# Creates an Rayo volume down message for the current Output
#
# @return [Command::Output::VolumeDown] a Rayo volume down message
#
# @example
# output_obj.volume_down_action.to_xml
#
# returns:
#
def volume_down_action
VolumeDown.new(:component_id => component_id, :target_call_id => target_call_id).tap do |s|
s.original_component = self
end
end
##
# Sends a Rayo volume down message for the current Output
#
def volume_down!
raise InvalidActionError, "Cannot volume down an Output that is already voluming." unless not_voluming?
volume_down_action.tap do |action|
write_action action
end
end
state_machine :volume_status, :initial => :not_voluming do
event :voluming_up do
transition :not_voluming => :voluming_up
end
event :voluming_down do
transition :not_voluming => :voluming_down
end
event :stopped_voluming do
transition [:voluming_up, :voluming_down] => :not_voluming
end
end
class VolumeUp < CommandNode # :nodoc:
register :'volume-up', :output
def request!
source.voluming_up!
super
end
def execute!
source.stopped_voluming!
super
end
end
class VolumeDown < CommandNode # :nodoc:
register :'volume-down', :output
def request!
source.voluming_down!
super
end
def execute!
source.stopped_voluming!
super
end
end
class Complete
class Success < Event::Complete::Reason
register :success, :output_complete
end
end
end # Output
end # Command
end # Punchblock