danog\MadelineProto\Call

Back to index

Author: Daniil Gentili daniil@daniil.it

Common interface implemented by every call type: one-to-one {@see VoIP} calls and {@see GroupCall}

group/conference calls.

It covers the media surface shared by all call types — the playlist/DJ playback controls and the mute and discard controls — so code can drive any call uniformly. Every playlist control takes a {@see MediaDestination} selecting the stream it acts on: the main camera+mic stream (default) or a separate presentation (screen-share) stream. Type-specific operations (a one-to-one call’s {@see VoIP::accept()}, a group call’s {@see GroupCall::join()} or per-participant recording) live on the concrete classes.

Method list:

• play(\danog\MadelineProto\LocalFile|\danog\MadelineProto\RemoteUrl|\Amp\ByteStream\ReadableStream $file, \danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): static
• then(\danog\MadelineProto\LocalFile|\danog\MadelineProto\RemoteUrl|\Amp\ByteStream\ReadableStream $file, \danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): static
• playOnHold(\danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera, \danog\MadelineProto\LocalFile|\danog\MadelineProto\RemoteUrl|\Amp\ByteStream\ReadableStream ...$files): static
• skip(\danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): static
• stop(\danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): static
• pause(\danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): static
• isPaused(\danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): bool
• resume(\danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): static
• getCurrent(\danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): \danog\MadelineProto\RemoteUrl|\danog\MadelineProto\LocalFile|string|null
• setMuted(bool $muted = true): static
• isMuted(): bool
• discard(): static

Methods:

play(\danog\MadelineProto\LocalFile|\danog\MadelineProto\RemoteUrl|\Amp\ByteStream\ReadableStream $file, \danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): static

Play a file, transmitting its audio and, if it carries a transmittable one, its video.

A WebM/Matroska file with VP8, VP9, H.264 or AV1 video has its video transmitted too; any other
file (or a raw audio stream) is played as audio only. Frames are demuxed in pure PHP and sent
as-is where possible, so no transcoding (and thus no FFI extension) is required for pre-encoded
WebM/OGG-OPUS input. $dest selects the camera or the presentation (screencast) stream.

Parameters:

• $file: \danog\MadelineProto\LocalFile|\danog\MadelineProto\RemoteUrl|\Amp\ByteStream\ReadableStream
  
• $dest: \danog\MadelineProto\MediaDestination
  

See also:

• \danog\MadelineProto\LocalFile: Indicates a local file to upload.
• \danog\MadelineProto\RemoteUrl: Indicates a remote URL to upload.
• \Amp\ByteStream\ReadableStream
• \danog\MadelineProto\MediaDestination: Which media stream of a call a playback or recording operation targets.

then(\danog\MadelineProto\LocalFile|\danog\MadelineProto\RemoteUrl|\Amp\ByteStream\ReadableStream $file, \danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): static

Add a file to the playlist, to be played once the current one finishes.

Parameters:

• $file: \danog\MadelineProto\LocalFile|\danog\MadelineProto\RemoteUrl|\Amp\ByteStream\ReadableStream
  
• $dest: \danog\MadelineProto\MediaDestination
  

See also:

• \danog\MadelineProto\LocalFile: Indicates a local file to upload.
• \danog\MadelineProto\RemoteUrl: Indicates a remote URL to upload.
• \Amp\ByteStream\ReadableStream
• \danog\MadelineProto\MediaDestination: Which media stream of a call a playback or recording operation targets.

playOnHold(\danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera, \danog\MadelineProto\LocalFile|\danog\MadelineProto\RemoteUrl|\Amp\ByteStream\ReadableStream ...$files): static

Set the files to play, on loop, while the given stream’s main playlist is empty.

Parameters:

• $dest: \danog\MadelineProto\MediaDestination
  
• ...$files: \danog\MadelineProto\LocalFile|\danog\MadelineProto\RemoteUrl|\Amp\ByteStream\ReadableStream
  

See also:

• \danog\MadelineProto\MediaDestination: Which media stream of a call a playback or recording operation targets.
• \danog\MadelineProto\LocalFile: Indicates a local file to upload.
• \danog\MadelineProto\RemoteUrl: Indicates a remote URL to upload.
• \Amp\ByteStream\ReadableStream

skip(\danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): static

Skip to the next file in the playlist.

Parameters:

• $dest: \danog\MadelineProto\MediaDestination
  

See also:

• \danog\MadelineProto\MediaDestination: Which media stream of a call a playback or recording operation targets.

stop(\danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): static

Stop playing all files, clearing the main and the hold playlist.

Parameters:

• $dest: \danog\MadelineProto\MediaDestination
  

See also:

• \danog\MadelineProto\MediaDestination: Which media stream of a call a playback or recording operation targets.

pause(\danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): static

Pause playback of the current file.

Parameters:

• $dest: \danog\MadelineProto\MediaDestination
  

See also:

• \danog\MadelineProto\MediaDestination: Which media stream of a call a playback or recording operation targets.

isPaused(\danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): bool

Whether playback of the current file is paused.

Parameters:

• $dest: \danog\MadelineProto\MediaDestination
  

See also:

• \danog\MadelineProto\MediaDestination: Which media stream of a call a playback or recording operation targets.

resume(\danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): static

Resume playback of the current file.

Parameters:

• $dest: \danog\MadelineProto\MediaDestination
  

See also:

• \danog\MadelineProto\MediaDestination: Which media stream of a call a playback or recording operation targets.

getCurrent(\danog\MadelineProto\MediaDestination $dest = \danog\MadelineProto\MediaDestination::Camera): \danog\MadelineProto\RemoteUrl|\danog\MadelineProto\LocalFile|string|null

The file or stream currently being played, if any.

Parameters:

• $dest: \danog\MadelineProto\MediaDestination
  

See also:

• \danog\MadelineProto\MediaDestination: Which media stream of a call a playback or recording operation targets.
• \danog\MadelineProto\RemoteUrl: Indicates a remote URL to upload.
• \danog\MadelineProto\LocalFile: Indicates a local file to upload.

setMuted(bool $muted = true): static

Mute or unmute our own outgoing audio.

Parameters:

• $muted: bool
  

isMuted(): bool

Whether our own outgoing audio is muted.

discard(): static

Discard (hang up / leave) the call.

Generated by danog/phpdoc