Adhearsion-CPA

This plugin aims to provide CPA detection..

• Asterisk - no
• Freeswitch with Event Socket - no
• Freeswitch with mod_rayo - yes

• Punchblock 2.21 or greater
• Adhearsion's current develop branch
• Recent build of Freeswitch
• Recent build of Mod_rayo that includes CPA support
• Any modules needed for detection

• beep - Detect a beep.
• dtmf - Detect DTMF tones.
• vad - Detect voice activity.
• speech - Detect speech and decide human or machine.
• fax-ced - Detect a fax CED tone.
• fax-cng - Detect a fax CNG tone.
• ring - Detect a ringing tone.
• busy - Detect a busy tone.
• congestion - Detect a congestion tone.
• sit - Detect a Special Information Tone.
• modem - Detect a modem tone.
• offhook - Detect an off-hook tone.

All detectors require the appropiate modules loaded in Freeswitch, and configured in rayo.conf.xml.

class BeepOrNoBeepController < Adhearsion::CallController
  def run
    answer
    say "Try to beep like a machine"
    tone = detect_tone(:beep, timeout: 5)
    if tone
      say "Good job! You sound just like a #{tone.type}"
    else
      say "Nope, you didn't make a convincing enough beep"
    end
  end
end

You can also watch for more than one tone type:

say "Something is beeping" if detect_tone(:modem, :beep, timeout: 5)

Some detection types let you pass extra options:

detect_tone :speech, maxTime: 4000, minSpeechDuration: 4000, timeout: 5

For fax machines, you can either watch for fax-ced or fax-cng, but not both.

You can also call a bang version of #detect_tone!, which will run the detectors in a non-blocking fashion, and execute the passed block when detection occurs:

# Start playing a message right away, so Real Humans don't have to wait
@sound = play_sound! "/foo/message.wav"

# But quit wasting a channel if we hear dialup noises
detect_tone! :modem do |tone|
  logger.info "Call detected a tone"
  @sound.stop!
end

By default, the block will only be executed the first time the signal type is detected, and the detector will quit listening. If you'd prefer the block to fire every time the signal is detected, you can pass :terminate => false in the options hash:

detector = detect_tone! :dtmf, terminate: false do |tone|
  logger.info "Callee pushed #{tone.value}"
  if tone.value == "#"
    detector.stop!
  end
end

• XEP-0341: Rayo CPA
• Mod_rayo CPA Documentation

• Original author: Justin Aiken
• Developed by Mojo Lingo in partnership with Grasshopper.
• Thanks to Grasshopper for sponsorship of Adhearsion-CPA.

• Source
• Bug Tracker

• Fork the project.
• Make your feature addition or bug fix.
• Add tests for it. This is important so I don't break it in a future version unintentionally.
• Commit, do not mess with rakefile, version, or history.
  • If you want to have your own version, that is fine but bump version in a commit by itself so I can ignore when I pull
• Send me a pull request. Bonus points for topic branches.

Copyright (c) 2013 Adhearsion Foundation Inc. MIT license (see LICENSE for details).