1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
//! SoraConnection のイベントハンドラトレイト。
use shiguredo_webrtc::{RtpReceiver, RtpTransceiver};
use crate::types::{SignalingDirection, SignalingType};
/// [SoraConnection](crate::SoraConnection) のイベントを受け取るトレイト。
///
/// 12 個のコールバックメソッドを集約し、ユーザーが自身の struct に状態を持たせて
/// `&mut self` で共有できるようにする。
/// 全メソッドにデフォルトの空実装を提供しており、必要なメソッドのみ
/// オーバーライドすればよい。
///
/// 実装型は [Send] を満たす必要がある。
/// [Sync] は不要（各コールバックは単一タスクから直列に呼ばれるため）。
pub trait SoraConnectionEventHandler: Send {
/// シグナリングメッセージの送受信を監視する。
///
/// Sora サーバーとの間でやり取りされる JSON メッセージの内容を、
/// デバッグやログ記録のために取得できる。
/// 第一引数はシグナリング経路（[SignalingType::WebSocket] または [SignalingType::DataChannel]）、
/// 第二引数はメッセージの方向（[SignalingDirection::Sent] または [SignalingDirection::Received]）、
/// 第三引数は JSON 文字列。
fn on_signaling_message(
&mut self,
_signaling_type: SignalingType,
_direction: SignalingDirection,
_text: &str,
) {
}
/// シグナリング通知メッセージを受信したときに呼ばれる。
///
/// 引数には Sora サーバーから送られてきた JSON 文字列が渡される。
/// チャネル参加者の接続・切断・メタデータ変更などのイベント情報を受け取れる。
fn on_notify(&mut self, _text: &str) {}
/// プッシュ通知メッセージを受信したときに呼ばれる。
///
/// 引数には Sora サーバーから送られてきた JSON 文字列が渡される。
/// プッシュ API やシグナリング通知メタデータ拡張から送信された通知を受け取れる。
fn on_push(&mut self, _text: &str) {}
/// リモート参加者から映像または音声トラックを受信したときに呼ばれる。
///
/// 引数には受信した [RtpTransceiver] が渡される。
/// このトランシーバーからトラックや RTP 統計情報を取得できる。
fn on_track(&mut self, _transceiver: RtpTransceiver) {}
/// リモート参加者の映像または音声トラックが削除されたときに呼ばれる。
///
/// 引数には削除されたトラックに対応する [RtpReceiver] が渡される。
fn on_remove_track(&mut self, _receiver: RtpReceiver) {}
/// WebSocket シグナリングから DataChannel シグナリングへの切替が
/// 完了したときに呼ばれる。
fn on_switched(&mut self) {}
/// WebSocket 接続がクローズされたときに呼ばれる。
///
/// 第一引数はクローズコード（`Some(u16)`）または `None`（正常クローズ以外）、
/// 第二引数はクローズ理由の文字列。
fn on_websocket_close(&mut self, _code: Option<u16>, _reason: &str) {}
/// `#` プレフィックス付きのユーザー定義 DataChannel ラベル経由で
/// メッセージを受信したときに呼ばれる。
///
/// 第一引数は DataChannel のラベル名（`#` プレフィックスを含む）、
/// 第二引数は受信したバイナリデータ。
/// 任意のアプリケーションデータを DataChannel 経由で送受信するために使う。
fn on_message(&mut self, _label: &str, _data: &[u8]) {}
/// Sora サーバーから DataChannel が作成されたときに呼ばれる。
///
/// 引数には作成された DataChannel のラベル名が渡される。
fn on_data_channel(&mut self, _label: &str) {}
/// DataChannel が開かれたときに呼ばれる。
///
/// 引数には開かれた DataChannel のラベル名が渡される。
fn on_data_channel_open(&mut self, _label: &str) {}
/// DataChannel 経由でメッセージを受信したときに呼ばれる。
///
/// 第一引数は DataChannel のラベル名、第二引数は受信したバイナリデータ。
fn on_data_channel_message(&mut self, _label: &str, _data: &[u8]) {}
/// DataChannel が閉じられたときに呼ばれる。
///
/// 引数には閉じられた DataChannel のラベル名が渡される。
fn on_data_channel_close(&mut self, _label: &str) {}
}