Class: Twilio::REST::Api::V2010::AccountContext::ConferenceContext::ParticipantInstance

Inherits:
InstanceResource
  • Object
show all
Defined in:
lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb

Instance Method Summary collapse

Constructor Details

#initialize(version, payload, account_sid: nil, conference_sid: nil, call_sid: nil) ⇒ ParticipantInstance

Initialize the ParticipantInstance

Parameters:

  • version (Version) —

    Version that contains the resource

  • payload (Hash) —

    payload that contains response from Twilio

  • account_sid (String) (defaults to: nil) —

    The SID of the Account that created the Participant resource.

  • conference_sid (String) (defaults to: nil) —

    The SID of the conference the participant is in.

  • call_sid (String) (defaults to: nil) —

    The Call SID or label of the participant to fetch. Non URL safe characters in a label must be percent encoded, for example, a space character is represented as %20.



547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 547

def initialize(version, payload, account_sid: nil, conference_sid: nil, call_sid: nil)
  super(version)

  # Marshaled Properties
  @properties = {
      'account_sid' => payload['account_sid'],
      'call_sid' => payload['call_sid'],
      'label' => payload['label'],
      'call_sid_to_coach' => payload['call_sid_to_coach'],
      'coaching' => payload['coaching'],
      'conference_sid' => payload['conference_sid'],
      'date_created' => Twilio.deserialize_rfc2822(payload['date_created']),
      'date_updated' => Twilio.deserialize_rfc2822(payload['date_updated']),
      'end_conference_on_exit' => payload['end_conference_on_exit'],
      'muted' => payload['muted'],
      'hold' => payload['hold'],
      'start_conference_on_enter' => payload['start_conference_on_enter'],
      'status' => payload['status'],
      'uri' => payload['uri'],
  }

  # Context
  @instance_context = nil
  @params = {
      'account_sid' => ,
      'conference_sid' => conference_sid,
      'call_sid' => call_sid || @properties['call_sid'],
  }
end

Instance Method Details

#account_sid ⇒ String

Returns The SID of the Account that created the resource.

Returns:

  • (String) —

    The SID of the Account that created the resource



595
596
597
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 595

def 
  @properties['account_sid']
end

#call_sid ⇒ String

Returns The SID of the Call the resource is associated with.

Returns:

  • (String) —

    The SID of the Call the resource is associated with



601
602
603
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 601

def call_sid
  @properties['call_sid']
end

#call_sid_to_coach ⇒ String

Returns The SID of the participant who is being ‘coached`.

Returns:

  • (String) —

    The SID of the participant who is being ‘coached`



613
614
615
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 613

def call_sid_to_coach
  @properties['call_sid_to_coach']
end

#coaching ⇒ Boolean

Returns Indicates if the participant changed to coach.

Returns:

  • (Boolean) —

    Indicates if the participant changed to coach



619
620
621
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 619

def coaching
  @properties['coaching']
end

#conference_sid ⇒ String

Returns The SID of the conference the participant is in.

Returns:

  • (String) —

    The SID of the conference the participant is in



625
626
627
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 625

def conference_sid
  @properties['conference_sid']
end

#context ⇒ ParticipantContext

Generate an instance context for the instance, the context is capable of performing various actions. All instance actions are proxied to the context

Returns:



581
582
583
584
585
586
587
588
589
590
591
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 581

def context
  unless @instance_context
    @instance_context = ParticipantContext.new(
        @version,
        @params['account_sid'],
        @params['conference_sid'],
        @params['call_sid'],
    )
  end
  @instance_context
end

#date_created ⇒ Time

Returns The RFC 2822 date and time in GMT that the resource was created.

Returns:

  • (Time) —

    The RFC 2822 date and time in GMT that the resource was created



631
632
633
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 631

def date_created
  @properties['date_created']
end

#date_updated ⇒ Time

Returns The RFC 2822 date and time in GMT that the resource was last updated.

Returns:

  • (Time) —

    The RFC 2822 date and time in GMT that the resource was last updated



637
638
639
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 637

def date_updated
  @properties['date_updated']
end

#delete ⇒ Boolean

Delete the ParticipantInstance

Returns:

  • (Boolean) —

    true if delete succeeds, false otherwise



744
745
746
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 744

def delete
  context.delete
end

#end_conference_on_exit ⇒ Boolean

Returns Whether the conference ends when the participant leaves.

Returns:

  • (Boolean) —

    Whether the conference ends when the participant leaves



643
644
645
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 643

def end_conference_on_exit
  @properties['end_conference_on_exit']
end

#fetch ⇒ ParticipantInstance

Fetch the ParticipantInstance

Returns:



680
681
682
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 680

def fetch
  context.fetch
end

#hold ⇒ Boolean

Returns Whether the participant is on hold.

Returns:

  • (Boolean) —

    Whether the participant is on hold



655
656
657
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 655

def hold
  @properties['hold']
end

#inspect ⇒ Object

Provide a detailed, user friendly representation



757
758
759
760
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 757

def inspect
  values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
  "<Twilio.Api.V2010.ParticipantInstance #{values}>"
end

#label ⇒ String

Returns The label of this participant.

Returns:

  • (String) —

    The label of this participant



607
608
609
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 607

def label
  @properties['label']
end

#muted ⇒ Boolean

Returns Whether the participant is muted.

Returns:

  • (Boolean) —

    Whether the participant is muted



649
650
651
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 649

def muted
  @properties['muted']
end

#start_conference_on_enter ⇒ Boolean

Returns Whether the conference starts when the participant joins the conference.

Returns:

  • (Boolean) —

    Whether the conference starts when the participant joins the conference



661
662
663
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 661

def start_conference_on_enter
  @properties['start_conference_on_enter']
end

#status ⇒ participant.Status

Returns The status of the participant’s call in a session.

Returns:

  • (participant.Status) —

    The status of the participant’s call in a session



667
668
669
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 667

def status
  @properties['status']
end

#to_s ⇒ Object

Provide a user friendly representation



750
751
752
753
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 750

def to_s
  values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
  "<Twilio.Api.V2010.ParticipantInstance #{values}>"
end

#update(muted: :unset, hold: :unset, hold_url: :unset, hold_method: :unset, announce_url: :unset, announce_method: :unset, wait_url: :unset, wait_method: :unset, beep_on_exit: :unset, end_conference_on_exit: :unset, coaching: :unset, call_sid_to_coach: :unset) ⇒ ParticipantInstance

Update the ParticipantInstance

Parameters:

  • muted (Boolean) (defaults to: :unset) —

    Whether the participant should be muted. Can be ‘true` or `false`. `true` will mute the participant, and `false` will un-mute them. Anything value other than `true` or `false` is interpreted as `false`.

  • hold (Boolean) (defaults to: :unset) —

    Whether the participant should be on hold. Can be: ‘true` or `false`. `true` puts the participant on hold, and `false` lets them rejoin the conference.

  • hold_url (String) (defaults to: :unset) —

    The URL we call using the ‘hold_method` for music that plays when the participant is on hold. The URL may return an MP3 file, a WAV file, or a TwiML document that contains `<Play>`, `<Say>`, `<Pause>`, or `<Redirect>` verbs.

  • hold_method (String) (defaults to: :unset) —

    The HTTP method we should use to call ‘hold_url`. Can be: `GET` or `POST` and the default is `GET`.

  • announce_url (String) (defaults to: :unset) —

    The URL we call using the ‘announce_method` for an announcement to the participant. The URL may return an MP3 file, a WAV file, or a TwiML document that contains `<Play>`, `<Say>`, `<Pause>`, or `<Redirect>` verbs.

  • announce_method (String) (defaults to: :unset) —

    The HTTP method we should use to call ‘announce_url`. Can be: `GET` or `POST` and defaults to `POST`.

  • wait_url (String) (defaults to: :unset) —

    The URL we call using the ‘wait_method` for the music to play while participants are waiting for the conference to start. The URL may return an MP3 file, a WAV file, or a TwiML document that contains `<Play>`, `<Say>`, `<Pause>`, or `<Redirect>` verbs. The default value is the URL of our standard hold music. Learn more about hold music.

  • wait_method (String) (defaults to: :unset) —

    The HTTP method we should use to call ‘wait_url`. Can be `GET` or `POST` and the default is `POST`. When using a static audio file, this should be `GET` so that we can cache the file.

  • beep_on_exit (Boolean) (defaults to: :unset) —

    Whether to play a notification beep to the conference when the participant exits. Can be: ‘true` or `false`.

  • end_conference_on_exit (Boolean) (defaults to: :unset) —

    Whether to end the conference when the participant leaves. Can be: ‘true` or `false` and defaults to `false`.

  • coaching (Boolean) (defaults to: :unset) —

    Whether the participant is coaching another call. Can be: ‘true` or `false`. If not present, defaults to `false` unless `call_sid_to_coach` is defined. If `true`, `call_sid_to_coach` must be defined.

  • call_sid_to_coach (String) (defaults to: :unset) —

    The SID of the participant who is being ‘coached`. The participant being coached is the only participant who can hear the participant who is `coaching`.

Returns:



724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 724

def update(muted: :unset, hold: :unset, hold_url: :unset, hold_method: :unset, announce_url: :unset, announce_method: :unset, wait_url: :unset, wait_method: :unset, beep_on_exit: :unset, end_conference_on_exit: :unset, coaching: :unset, call_sid_to_coach: :unset)
  context.update(
      muted: muted,
      hold: hold,
      hold_url: hold_url,
      hold_method: hold_method,
      announce_url: announce_url,
      announce_method: announce_method,
      wait_url: wait_url,
      wait_method: wait_method,
      beep_on_exit: beep_on_exit,
      end_conference_on_exit: end_conference_on_exit,
      coaching: coaching,
      call_sid_to_coach: call_sid_to_coach,
  )
end

#uri ⇒ String

Returns The URI of the resource, relative to ‘api.twilio.com`.

Returns:

  • (String) —

    The URI of the resource, relative to ‘api.twilio.com`



673
674
675
 
# File 'lib/twilio-ruby/rest/api/v2010/account/conference/participant.rb', line 673

def uri
  @properties['uri']
end