whatsapp-rust 0.7.0

Rust client for WhatsApp Web
Documentation 
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

//! VoIP calls media plane (Tokio runtime side): the DTLS/SCTP DataChannel transport
//! over the WhatsApp relay, encoded audio, the call state machine, and the media pipeline.
//! Pure protocol/crypto lives in `wacore::voip`.
//!
//! This module pulls webrtc-rs, which does not build on wasm32 or espidf. The wasm/esp32-safe
//! subset is `wacore`'s `voip` feature (pure-Rust crypto and encoded transport); add
//! `wacore/voip-mlow` for its pure-Rust MLOW codec.

// Fail fast with an actionable message instead of a confusing webrtc link error.
#[cfg(all(
    feature = "voip-runtime",
    any(target_arch = "wasm32", target_os = "espidf")
))]
compile_error!(
    "the native VoIP features of `whatsapp-rust` pull webrtc-rs and do not build on \
     wasm32/espidf. For those targets use `wacore/voip` for crypto/encoded transport and \
     optionally `wacore/voip-mlow` for the pure-Rust MLOW codec."
);

pub mod audio;
pub mod driver;
pub mod facade;
pub mod registry;
pub mod session;
pub mod transport;
pub mod video;

pub use audio::{AudioSink, AudioSource, EncodedAudioSink, EncodedAudioSource};
pub use facade::{
    AcceptCall, CallHandle, CallLinkCall, GroupBoundCall, OutgoingCall, OutgoingGroupCall,
};
pub use video::{VideoFrame, VideoSink, VideoSource};
// Surface core types carried by the facade next to the builders and handle that expose them.
pub use wacore::voip::{
    AudioCodec, AudioConfig, AudioFormat, AudioIo, AudioRtpProfile, EncodedAudioFrame,
    OpusMlowPacketError, depacketize_opus_from_mlow, packetize_opus_for_mlow,
};
pub use wacore::voip::{CallEvent, GroupCallState, GroupStateApply, VideoUpgradeToken};
// `CallEvent::VideoStateChanged` carries this; surface it next to CallEvent (it lives in wacore).
pub use wacore::types::call::VideoState;
pub use wacore::types::group_call::{
    CallLink, CallLinkJoin, CallLinkMedia, CallLinkPreview, GROUP_CALL_MAX_PARTICIPANTS,
    GroupCallDevice, GroupCallEncRekey, GroupCallParticipant, GroupCallRelay,
    GroupCallRelayEndpoint, GroupCallUpdate, ScreenShare, ScreenShareState, WaitingRoom,
    WaitingRoomUser,
};