コールバック

Sora JavaScript SDK には WebRTC API のイベントや Sora 固有の機能のイベントをハンドリングするためのコールバックを用意しています。

ここではそのコールバックの利用方法について説明します。

track

自分以外 の音声や映像のメディアストリームが追加、 または削除されたタイミングで発火するコールバックです。

import Sora from "sora-js-sdk";

const conn = Sora.connection('ws://192.0.2.100:5000/signaling', true);
const client = conn.sendrecv("sora", null, {"multistream": true});
// track で上がってくるのは RTCEventTrack
client.on("track", (event: RTCEventTrack) => {
    // ここにトラックイベントの処理を書く
});

// メディアストリームを取得
const mediaStream = await navigator.mediaDevices.getUserMedia({audio: true, video: true});
// Sora に繫ぐ
client.connect(mediaStream);

参考

removetrack

自分以外 の音声や映像のメディアストリームが削除されたタイミングで発火するコールバックです。

このコールバックは MediaStream の onremovetrack をラップしています。

import Sora from "sora-js-sdk";

const conn = Sora.connection('ws://192.0.2.100:5000/signaling', true);
const client = conn.sendrecv("sora", null, {"multistream": true});
// removetrack で上がってくるのは MediaStreamTrackEvent
client.on("removetrack", (event: MediaStreamTrackEvent) => {
    // ここにトラック削除イベントの処理を書く
});

// メディアストリームを取得
const mediaStream = await navigator.mediaDevices.getUserMedia({audio: true, video: true});
// Sora に繫ぐ
client.connect(mediaStream);

参考

disconnect

Sora からクライアントが切断したタイミングで発火するコールバックです。

  • disconnect メソッドが呼ばれた場合

  • PeerConnecion の state が正常な状態では無くなった場合に強制終了する場合

  • 上記以外で何かしらの異常があった場合

push

Sora のシグナリングで利用している通信経路経由でプッシュ通知が送られてきたタイミングで発火するコールバックです

  • WebSocket 経由でのシグナリングのプッシュ通知

  • DataChannel 経由でのシグナリングのプッシュ通知

import Sora from "sora-js-sdk";

const conn = Sora.connection('ws://192.0.2.100:5000/signaling', true);
const client = conn.sendrecv("sora", null, {"multistream": true});
client.on("push", (message: SignalingPushMessage, transportType: TransportType) => {
    // ここにシグナリング経由のプッシュ通知の処理を書く
});

const mediaStream = await navigator.mediaDevices.getUserMedia({audio: true, video: true});
client.connect(mediaStream);

参考

addstream

危険

このコールバックは廃止予定のコールバックです

PeerConnection の ontrack でトラックが追加されたタイミングで発火するコールバックです。

このコールバックは以前 PeerConnection に存在していた onaddstream コールバックの後方互換用ですが、 将来的に廃止予定ですので、利用は避けてください。

参考

removestream

危険

このコールバックは廃止予定のコールバックです

PeerConnection の ontrack でトラックが削除されたタイミングで発火するコールバックです。

このコールバックは以前 PeerConnection に存在していた onremovestream コールバックの後方互換用ですが、 将来的に廃止予定ですので、利用は避けてください。 もし利用する場合は removetrack を利用してください。

参考

notify

Sora のシグナリングで利用している通信経路経由での通知が送られてきた場合に発火するコールバックです。

参考

timeout

Sora との接続でシグナリングは成功したが、WebRTC 接続が成功せずタイムアウトしたタイミングで発火するコールバックです。

シグナリングの開始には WebSocket over TLS を利用するため、ほとんどの環境で接続が成功します。 ただし、その後の WebRTC の接続が失敗する場合があります。

その場合は Sora 側から WebSocket を切断するのですが、 ネットワークの問題などでクライアントがそれに気付けない状況への対策となります。

message

メッセージング機能を利用した際に、メッセージを受信したタイミングで発火するコールバックです。

参考

datachannel

DataChannel 経由シグナリングを利用した際に、利用可能な各データチャネルが利用に可能になったタイミングで発火するコールバックです。

メッセージング機能などを利用している場合はこちらのコールバックを利用して、メッセージングが送れるようになったかどうかを判断してください。

参考

signaling

注釈

この機能はログ出力用のコールバックです

Sora とのシグナリングメッセージを送受信した際に発火するコールバックです。

WebSocket と DataChannel 経由でのシグナリングメッセージが取得可能です。

log

注意

この機能はデバッグ用のトレースログ出力用のコールバックです

SDK のトレースログを出力した際に発火するコールバックです。

このコールバックは debugfalse でも発火します。

timeline

注意

この機能はデバッグ用のタイムラインログ出力用のコールバックです

クライアントの主要なイベントが発生した際に発火するコールバックです。

主に、クライアントの挙動を時系列に確認するために利用するためのデバッグ向けコールバックになっています。

シーケンス図

sequenceDiagram participant client1 as クライアント1<br>sendrecv participant client2 as クライアント2<br>sendrecv participant sora as WebRTC SFU Sora participant app as アプリケーションサーバー note over client1: getUserMedia client1->>+sora: 接続要求 sora-->>-client1: 接続成功 note over client1,sora: WebRTC 確立 sora-)client1: シグナリング通知<br>connection.created (クライアント1) client1->>client1: notify コールバックが発火 note over client1: 1 分経過 sora-)client1: シグナリング通知<br>connection.updated client1->>client1: notify コールバックが発火 note over client2: getUserMedia client2->>+sora: 接続要求 par sora-->>-client2: 接続成功 note over client2,sora: WebRTC 確立 sora-)client2: シグナリング通知<br>connection.created (クライアント2) client2->>client2: notify コールバックが発火 client2->>client2: track コールバックが発火 and sora-)client1: シグナリング通知<br>connection.created (クライアント2) client1->>client1: notify コールバックが発火 client1->>client1: track コールバックが発火 end app->>sora: PushChannel API<br>{"mute": true} par sora-)client1: プッシュ通知<br>{"mute": true} client1->>client1: push コールバックが発火 and sora-)client2: プッシュ通知<br>{"mute": true} client2->>client2: push コールバックが発火 end client1->>+sora: 切断要求 par sora-->>-client1: シグナリング切断 note over client1: 切断完了 client1->>client1: disconnect コールバックが発火 and sora-)client2: シグナリング通知<br>connection.destroyed (クライアント1) client2->>client2: notify コールバックが発火 client2->>client2: removetrack コールバックが発火 end app->>sora: DisconnectChannel API sora->>client2: シグナリング切断 note over client2: 切断完了 client2->>client2: disconnect コールバックが発火

typedocs

© Copyright 2023, Shiguredo Inc. Created using Sphinx 5.3.0