Call

A Call represents an active voice or video call. You get one from client.call() (outbound) or from the onIncomingCall callback (inbound).

Properties

Methods

Identity

call.id()

Returns the call's unique ID.

call.peer()

Returns the peer's identifier (JID).

call.state()

Returns the current CallPhase symbol.

if (call.state() === CallPhase.Active) {
  console.log('call is active');
}

call.isVideo()

Returns true if the call has video.

Lifecycle

call.answer()

Answer an incoming call. Sends a preaccept and starts the media pipeline.

client.onIncomingCall((call) => {
  call.answer();
});

call.reject()

Reject an incoming call. Sends a reject stanza and cleans up.

client.onIncomingCall((call) => {
  call.reject();
});

call.hangup()

Hang up any active call (inbound or outbound). Sends a terminate stanza and cleans up.

call.hangup();

Audio

call.play(source)

Play audio into the call. Creates a new Player, subscribes it, and starts playback.

Returns the Player instance.

import { WAVFile } from 'meowcaller-js';

const player = call.play(await WAVFile('music.wav'));
player.onFinish(() => console.log('done playing'));

call.subscribe(player)

Attach an existing Player to the call.

import { NewPlayer, SourceFunc } from 'meowcaller-js';

const player = NewPlayer();
player.play(SourceFunc(async () => new Float32Array(960)));
call.subscribe(player);

call.receive(sink)

Set the audio sink for incoming audio. The sink's writeFrame is called with each decoded audio frame.

import { SinkFunc } from 'meowcaller-js';

call.receive(SinkFunc((frame) => {
  // frame: Float32Array of 960 samples at 16 kHz
  processAudio(frame);
}));

Video

call.receiveVideo(sink)

Set the video sink for incoming video.

import { VideoSinkFunc } from 'meowcaller-js';

call.receiveVideo(VideoSinkFunc((au) => {
  // au: Uint8Array containing H.264 Annex B data
  processVideo(au);
}));

call.sendVideo(accessUnit)

Send a video frame (H.264 Annex B access unit).

call.sendVideo(h264Frame);

Events

call.onReady(fn)

Fired when the first inbound RTP packet is decoded — the call is active and media is flowing.

call.onReady(() => {
  console.log('media flowing');
});

call.onEnd(fn)

Fired when the call ends for any reason.

call.onEnd((reason) => {
  console.log('call ended:', reason);
});

call.onStateChange(fn)

Fired on every phase transition.

import { CallPhase } from 'meowcaller-js';

call.onStateChange((phase) => {
  if (phase === CallPhase.Active) console.log('connected');
  if (phase === CallPhase.Ended) console.log('done');
});

call.onVideoState(fn)

Fired when video state changes.

call.onVideoState((vs) => {
  console.log('video active:', vs.Active);
});

Call phases

A call progresses through these states:

Idle → Calling → Ringing → Connecting → Active → Ended

Invalid transitions are silently ignored and return false.