janus-sip-plugin 3.0.0

Typed async client for the Janus SIP plugin

janus-sip-plugin

An independently installable, fully typed async client for janus.plugin.sip. It depends on janus-api-core and does not install any other named Janus plugin.

from janus_api.models.base import Jsep
from janus_sip_plugin import SipPlugin

sip = SipPlugin(session=session)
await sip.attach()
await sip.register_account(
    "sip:[e-mail]",
    secret="password",
    proxy="sip:registrar.example.com",
)
await sip.call(
    "sip:[e-mail]",
    Jsep(type="offer", sdp=offer_sdp),
)

Registration validates SIP/SIPS URIs, authentication choice, guest/helper semantics, transport conflicts, and registration lifetime. A normal account requires exactly one of secret and ha1_secret; authuser overrides the URI username for digest authentication. Guest calls can provide credentials on the call request. Helpers use the master account's returned master_id.

The client covers every documented SIP operation: registration, calls, offerless-invite progress/accept flows, renegotiation, decline/hangup, hold/unhold, MESSAGE, INFO/DTMF, subscriptions, blind/attended transfers, recording, keyframes, and RTP forwarders. JSEP remains in the outer Janus envelope and is never mixed into plugin data; update() automatically marks its JSEP as a Janus renegotiation. RTP-forwarder helpers expose the optional unique_id and configured admin_key controls from the current gateway.

Models follow the official SIP API and the current Janus implementation. Outbound objects reject unknown fields; inbound events retain future fields and unknown event variants.