Skip to content

direct-calls.md

Latest commit

 

History

History
78 lines (57 loc) · 3.03 KB

direct-calls.md

File metadata and controls

78 lines (57 loc) · 3.03 KB
Raw

Direct calls (registrar-less mode)

Placing and receiving SIP calls between two baresipy instances without any SIP registrar, proxy, or account credentials.

How it works

If you construct BareSIP() with user/pwd/gateway all left unset, there is nothing to register with. baresipy instead creates a local, non-registering user agent as soon as baresip signals it is ready:

/uanew sip:<user or "baresipy">@0.0.0.0;regint=0

regint=0 tells baresip not to attempt SIP REGISTER at all. The UA exists purely so baresip can place and accept calls locally. user is still accepted in this mode (it becomes the local account's SIP username) even though pwd/gateway are not required.

Because there is no registrar to resolve short numbers against, call() in registrar-less mode requires a full SIP URI:

b = BareSIP(user="alice")          # no gateway -> registrar-less
b.call("sip:bob@192.168.1.42:5060")

Calling call() with a bare number and no gateway configured raises ValueError, since there is nowhere to resolve it against.

Receiving direct calls

Important caveat: baresip only accepts an incoming call when the request-URI matches its local account:

  • the request-URI host must be one of the machine's own local IP addresses (not a hostname, and not 0.0.0.0), and
  • the request-URI user part must match the local account's user.

In practice this means the caller must dial the callee using the callee's actual reachable IP and the exact user the callee registered locally, for example:

# callee, on host 192.168.1.42
callee = BareSIP(user="bob", headless=True)

# caller, elsewhere
caller = BareSIP(user="alice", headless=True)
caller.call("sip:bob@192.168.1.42:5060")

The callee does not accept a call dialed to bob@some-hostname or bob@0.0.0.0 from the caller side, even on the same machine or network. Resolve the callee's IP first and dial that.

By default, BareSIP.handle_incoming_call() rejects every inbound call. To answer, subclass and override it, calling accept_call():

class Callee(BareSIP):
    def handle_incoming_call(self, number):
        self.accept_call()

Working reference: the docker e2e rig

docker-compose.e2e.yml and test/e2e/ are a complete, working example of two registrar-less, headless baresip instances calling each other directly by IP over a private docker network: a callee service that auto-accepts and echoes DTMF, and a caller service that dials it, sends DTMF and a test tone, and asserts on the exchange. Both services get static IPs in the compose network because of the IP-matching requirement described above. The caller dials sip:callee@172.31.99.10:5060, the callee's static address, not a hostname.

See docs/docker.md for how to run it, and test/e2e/callee.py / test/e2e/caller.py for the full implementation (event handling, DTMF, recording the rx audio leg, and writing results for test/e2e/test_call.py to assert on).

← Call control · Home · IVR menus →