原文地址 : http://www.pjsip.org/pjsua.htm

介紹

　　PJSUA是一個(gè)開源的命令行SIP用戶代理（軟電話），用PJSIP協(xié)議，PJNATH，和PJMEDIA實(shí)現(xiàn)。 它雖然只有很簡(jiǎn)單的命令行界面，但是功能齊全。

SIP功能：

多個(gè)id（帳戶注冊(cè)）；多個(gè)呼叫；支持IPv6（在1.2版本中添加）；PRACK（100rel，RFC 3262）；UPDATE (RFC 3311)；OPTIONS；呼叫保持；呼叫轉(zhuǎn)移；簡(jiǎn)單的PIDF和XPIDF的支持（訂閱/通知，RFC 3265，3856，3863）；自定義存在狀態(tài)文本（RPID，RFC 4480）；支持PUBLISH（RFC 3903）；即時(shí)消息（消息）和消息組成指示（RFC 3428，3994）；支持UDP，TCP和TLS傳輸；SIP服務(wù)器的DNS SRV（RFC 3263）；帶INFO的DTMF（RFC 2976）；STUN（RFC 3489bis);AKA認(rèn)證（開發(fā)中，RFC 3310，4169）。

媒體功能：

多個(gè)并發(fā)調(diào)用；會(huì)議；支持Speex，iLBC，GSM，G711，G722，和L16編解碼；寬帶和超寬帶編解碼（Speex）；通過Intel的IPP庫(kù)支持更多編解碼：AMR-WB，AMR-NB，G.722.1（Siren7），G.723.1，G.726，G.728，G.729A；立體聲編解碼（L16）;WAV文件播放，流媒體和錄制;支持RTCP協(xié)議；通話質(zhì)量監(jiān)測(cè)；RFC 2833；自動(dòng)應(yīng)答，自動(dòng)播放文件，自動(dòng)循環(huán)RTP；產(chǎn)生聲音；AEC（Accoustic回聲消除）；自適應(yīng)抖動(dòng)緩沖器；自適應(yīng)靜音檢測(cè)；PLC（包丟失隱藏）；丟包模擬；每個(gè)RTP包中包含多個(gè)幀；支持SRTP（安全RTP）

NAT功能：

ICE（互動(dòng)式連接建立，最新ICE草案）；STUN（最新的RFC3489雙）;TURN（最新草案）;rport;SIP的TCP和TLS保持活動(dòng)；自動(dòng)檢測(cè)和恢復(fù)SIP UDP地址的變更；自動(dòng)檢測(cè)ICE媒體傳輸?shù)淖兓?

程序使用

用法：PJSUA [選項(xiàng)] [SIP的URL調(diào)用]一般選項(xiàng)：--config-file=file 讀取從文件的配置/參數(shù)；--help 顯示此幫助屏幕；--version 顯示版本信息；日志記錄選項(xiàng)：--log-file=fname 日志文件名（默認(rèn)是stderr）；--log-level=N 設(shè)置日志的最大級(jí)別為N（0（無(wú)）6（跟蹤））（默認(rèn)值= 5）；--app-log-level=N 設(shè)置日志的最大水平為stdout顯示（默認(rèn)值= 4）；--color 運(yùn)用豐富多彩的日志（在Win32默認(rèn)開啟）；--no-color 禁用豐富多彩的日志；--light-bg 使用白底黑字的顏色（默認(rèn)是黑暗的背景）；SIP帳戶選項(xiàng)：--use-ims 開啟和這個(gè)賬號(hào)相關(guān)的3GPP/IMS設(shè)置；--use-srtp=N 是否使用SRTP? 0:不使用, 1:可選, 2:強(qiáng)制使用 (默認(rèn):0)；--srtp-secure=N SRTP 是否需要安全的SIP? 0:不需要, 1:tls方式, 2:sips (默認(rèn):1)；--registrar=url 設(shè)置注冊(cè)服務(wù)器的URL；--id=url 設(shè)置本地賬戶的URL--contact=url 選擇性的覆蓋聯(lián)系人信息--contact-params=S 給指定的聯(lián)系URI添加S參數(shù)--proxy=url 可選擇的訪問代理服務(wù)器的URL --reg-timeout=SEC 注冊(cè)時(shí)間間隔 (default 55)--realm=string 設(shè)置域--username=string 設(shè)置用戶名--password=string 設(shè)置密碼--publish 發(fā)PUBLISH--use-100rel 需要可靠的臨時(shí)響應(yīng)(100rel)--auto-update-nat=N n為0或1來(lái)啟用/禁用SIP遍歷后面對(duì)稱NAT(默認(rèn)1)--next-cred 添加其他憑據(jù)SIP帳戶控制：--next-account 添加更多的賬戶傳輸選項(xiàng)：--ipv6 使用IPv6--local-port=port 端口--ip-addr=IP ip地址--bound-addr=IP 綁定端口--no-tcp 禁用TCP傳輸--no-udp 禁用UDP傳輸--nameserver=NS 域名服務(wù)器--outbound=url 設(shè)置全局代理服務(wù)器的URL，可以指定多次--stun-srv=name 設(shè)置STUN服務(wù)器主機(jī)或域名TLS選項(xiàng)：--use-tls 啟用TLS傳輸（默認(rèn)不開啟）--tls-ca-file 指定TLS CA文件（默認(rèn)為無(wú)）--tls-cert-file 指定TLS證書文件（默認(rèn)為無(wú)）--tls-privkey-file 指定TLS私鑰文件（默認(rèn)值=無(wú)）--tls-password 指定TLS私鑰文件密碼（默認(rèn)為無(wú)）--tls-verify-server 驗(yàn)證服務(wù)器的證書（默認(rèn)=沒有）--tls-verify-client 驗(yàn)證客戶端的證書（默認(rèn)=沒有）--tls-neg-timeout 指定超時(shí)（默認(rèn)值無(wú)）--tls-srv-name 指定TLS服務(wù)器名稱為多宿主服務(wù)器（可選）媒體選項(xiàng)：--add-codec=name 手工添加編解碼(默認(rèn)開啟所有)--dis-codec=name 禁用某個(gè)編解碼--clock-rate=N 覆蓋會(huì)議橋時(shí)鐘頻率--snd-clock-rate=N 覆蓋音頻設(shè)備時(shí)鐘頻率--stereo 音頻設(shè)備及會(huì)議橋開通立體聲模式--null-audio 使用NULL音頻設(shè)備--play-file=file 在會(huì)議橋中注冊(cè)WAV文件--play-tone=FORMAT 向會(huì)議橋注冊(cè)音調(diào)，格式是'F1,F2,ON,OFF'，其中F1,F2為頻率，ON,OFF=on/off ,可以指定多次。--auto-play 自動(dòng)播放文件（僅來(lái)電）--auto-loop 自動(dòng)循環(huán)傳入RTP到傳出RTP--auto-conf 自動(dòng)加入會(huì)議--rec-file=file 錄音文件(擴(kuò)展名可以使.wav 或者 .mp3）--auto-rec 自動(dòng)記錄通話--quality=N 指定媒介質(zhì)量(0-10,默認(rèn)6)--ptime=MSEC 覆蓋編解碼器ptime的毫秒的--no-vad 停用VAD方案/沉默探測(cè)器（默認(rèn)啟用VAD）--ec-tail=MSEC 設(shè)置回波抵消尾長(zhǎng)度（默認(rèn)值256）--ec-opt=OPT 選擇回波抵消算法（0 =默認(rèn)，1 = SPEEX，2 =抑制）--ilbc-mode=MODE 設(shè)置iLBC語(yǔ)音編解碼器模式（20或30，默認(rèn)是30）--capture-dev=id 音頻捕獲的設(shè)備ID（默認(rèn)值= -1）--playback-dev=id 音頻播放設(shè)備ID（默認(rèn)值= -1）--capture-lat=N 音頻捕獲延遲（毫秒,默認(rèn)值= 100）--playback-lat=N 音頻播放延遲（毫秒,默認(rèn)值= 100）--snd-auto-close=N 閑置N秒后自動(dòng)關(guān)閉音頻設(shè)備指定n = -1（默認(rèn)）禁用此功能。指定即時(shí)關(guān)閉不使用時(shí)，N = 0。--no-tones 禁用聽見聲音--jb-max-size 指定最大值抖動(dòng)緩沖(幀，默認(rèn)= 1)媒體傳輸選項(xiàng)：--use-ice 使用ICE（默認(rèn)：不使用）--ice-no-host 禁用ICE主機(jī)候選（默認(rèn):no）--ice-no-rtcp 禁用RTCP組件（默認(rèn):no）--rtp-port=N RTP嘗試端口基數(shù)(默認(rèn)4000)--rx-drop-pct=PCT Drop PCT percent of RX RTP (for pkt lost sim, default: 0)--tx-drop-pct=PCT Drop PCT percent of TX RTP (for pkt lost sim, default: 0)--use-turn Enable TURN relay with ICE (default:no)--turn-srv TURN服務(wù)器的域或主機(jī)名稱--turn-tcp 使用TCP連接到TURN服務(wù)器（默認(rèn):no）--turn-user TURN用戶名--turn-passwd TURN密碼好友名單（可以是多個(gè)）：--add-buddy url 添加指定的URL到好友列表中用戶代理選項(xiàng)：--auto-answer=code 自動(dòng)接聽來(lái)電的應(yīng)答代碼（如200）--max-calls=N 最大并發(fā)呼叫數(shù)（默認(rèn)：4，最大：255）--thread-cnt=N 工作線程數(shù)目（默認(rèn)：1）--duration=SEC 設(shè)置最大通話時(shí)間（默認(rèn)是：沒有限制）--norefersub 轉(zhuǎn)接通話時(shí)禁止事件訂閱--use-compact-form 最小的SIP消息大小--no-force-lr 允許使用嚴(yán)格路由--accept-redirect=N 指定如何處理呼叫重定向響應(yīng)（3XX）。0：拒絕，1：自動(dòng)（默認(rèn)），2：詢問

命令介紹

呼叫命令 m 產(chǎn)生一個(gè)呼叫 M 向同一個(gè)地址產(chǎn)生多個(gè)呼叫 a 響應(yīng)呼叫（發(fā)送100-699） h 掛斷當(dāng)前呼叫(ha為掛斷所有) H 呼叫保持 v 恢復(fù)通話（解除呼叫保持） U 發(fā)送UPDATE請(qǐng)求 ],[ 呼叫翻頁(yè)（前一個(gè)/下一個(gè)） x 呼叫轉(zhuǎn)移 X 呼叫替換 # 發(fā)送DTMF（RFC238） * 發(fā)送DTMF（SIP INFO） dq 顯示當(dāng)前通話質(zhì)量 S 給遠(yuǎn)端主機(jī)發(fā)送任意請(qǐng)求即時(shí)通訊 +b 添加好友 -b 刪除好友 i 發(fā)送即時(shí)消息 s 訂閱（好友）當(dāng)前狀態(tài) u 取消訂閱（好友）當(dāng)前狀態(tài) t 在線狀態(tài)切換 T 設(shè)置在線狀態(tài)媒體命令 cl 列出端口 cc 連接端口 cd 斷開端口 V 調(diào)節(jié)音量 Cp 優(yōu)先編碼器帳戶 +a 添加 -a 刪除 !a 修改 rr 重新注冊(cè) ru 反注冊(cè) > 下一個(gè)（循環(huán)） < 前一個(gè)（循環(huán)）狀態(tài)和設(shè)置 d 顯示狀態(tài) dd 顯示狀態(tài)詳情 dc 顯示配置 f 保存配置其它命令： q 退出 L 重新加載 sleep MS 暫停鍵盤輸入(毫秒) echo [0|1|TXT] 控制echo命令(0:禁用，1：啟用，TXT ：回顯) n 探測(cè)NAT網(wǎng)絡(luò)

PJSUA的使用

1、簡(jiǎn)單點(diǎn)對(duì)點(diǎn)
　　啟動(dòng)： $ ./pjsua
　　呼叫：$ ./pjsua sip:192.168.0.10
　　默認(rèn)端口：5060
2、向服務(wù)器注冊(cè)

單帳戶注冊(cè)：
　　$ ./pjsua --id sip:alice@example.com --registrar sip:example.com \
　　--realm * --username alice --password secret
多帳戶注冊(cè)：
　　$ ./pjsua --id sip:bob@provider1.com --registrar sip:provider1.com \
　　--realm provider.1.com --username bob --password secret \
　　--next-account \
　　--id sip:bob@provider2.com --registrar sip:provider2.com \
　　--realm provider2.com --username bob --password secret

3、自動(dòng)應(yīng)答并播放wav文件：
　　$ pjsua --play-file PROMPT.WAV --auto-answer 200 --auto-play --auto-loop \
　　--max-calls 100
4、從文件加載：

文件（alice.cfg）內(nèi)容：

# This is a comment in the config file. --id sip:alice@example.com --registrar sip:example.com --realm * --username alice --password secret

使用：
$ ./pjsua --config-file alice.cfg

好，就這些了，希望對(duì)你有幫助。

總結(jié)

以上是生活随笔為你收集整理的pjsua帮助手册（中文）的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。