神奇! 搞大數位娛樂的肚子-狂想空間: 2016

2016/02/05

Asterisk : The Cookbook 食譜 035 - a2billing

Q035: 如果我想在 Asterisk 之上再加裝 GUI 套件，請問有沒有什麼好建議？

比較流行的可能是 FreePBX, 另外我正在研讀的是 a2billing, 很多成功的案例通常都是在講 FreePBX, 其他像 AsteriskNOW, 及 PBX in a Flash 等專案也都是基於 FreePBX, 我們當然不會花太多心力在它們上面，主要原因有二，一個最主要原因是這些 GUI 套件都不怎麼提底層的 Asterisk 本身，第二個原因是要找這些 GUI 專案文件很容易，反而專門討論 Asterisk 的中文文件很少。

當然並不是說這些 GUI 專案不好，正因為有這些 GUI 套件才讓 Asterisk 成功起來。只是我想從基礎讀起而已。反過來說，對於一個想快速建立網路電話的人來說，相當建議您直接採用像 AsteriskNOW 這種使用 FreePBX 界面的專案套件來用。

這邊建議一個專案叫 a2billing, 它不止是 Asterisk 的 GUI 界面，而且提供完整的 VoIP 網路電話營運商解決方案。雖然如此，你也千萬別以為下載安裝了 a2billing 之後就可以安心當個網路電話運營商。

首先你可能要安裝一些套件，例如: perl-DBD-Pg subversion libapache2-mod-php5 php5 php5-common php5-cli php5-mysql mysql-server apache2 php5-gd openssh-server php5-mcrypt python-setuptools python-mysqldb，總之，GUI 一般就是像這樣，透過 apache2 + php5 + Mysql

取得套件

mkdir /usr/local/src/a2billing
git clone https://github.com/Star2Billing/a2billing.git /usr/local/src/a2billing/
cd /usr/local/src/a2billing

複製設定檔: cp a2billing.conf /etc/
更新相依套件

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
composer update && composer install

設定資料庫

mysql -u root -p < DataBase/mysql-5.x/a2billing-createdb-user.sql
這個步驟會產生底下資料庫資訊
database name: mya2billing
database user: a2billinguser
user password: a2billing
cd DataBase/mysql-5.x/ ; ./install-db.sh
驗證

mysql -u root -p mya2billing
這一步會要求你輸入 MySQL 的 root 密碼，請自行根據設定登入
mysql> show tables;
這一步可以看到相當多表格，以我的來看是 97 個
mysql> exit

修改 /etc/a2billing.conf，修改 [database] 節即可，如下

    [database]
    hostname = localhost
    port = 3306
    user = a2billinguser
    password = a2billing
    dbname = mya2billing
    dbtype = mysql

新增設定檔：

    touch /etc/asterisk/additional_a2billing_iax.conf
    touch /etc/asterisk/additional_a2billing_sip.conf
    echo \#include additional_a2billing_sip.conf >> /etc/asterisk/sip.conf
    echo \#include additional_a2billing_iax.conf >> /etc/asterisk/iax.conf

安裝音頻檔

cd /usr/local/src/a2billing/addons/sounds
./install_a2b_sounds.sh

安裝 agi-bin

cd /usr/local/src/a2billing
cp -a AGI/*.php common/lib /var/lib/asterisk/agi-bin/

安裝網頁界面:

將必要的檔案複製/或移動到現有的 apache DocumentRoot 下

mkdir /var/www/html/a2billing
mv admin agent common customer vendor webservice /var/www/html/a2billing/

新增撥號計劃 /etc/asterisk/extensions.conf
[a2billing]
include => a2billing_callingcard
include => a2billing_monitoring
include => a2billing_voucher
[a2billing_callingcard]
; CallingCard application
exten => _X.,1,NoOp(A2Billing Start)
exten => _X.,n,DeadAgi(a2billing.php|1)
exten => _X.,n,Hangup
[a2billing_voucher]
exten => _X.,1,Answer(1)
exten => _X.,n,DeadAgi(a2billing.php|1|voucher)
;exten => _X.,n,AGI(a2billing.php|1|voucher44) ; will add 44 in front of the callerID for the CID authentication
exten => _X.,n,Hangup
[a2billing_did]
exten => _X.,1,DeadAgi(a2billing.php|1|did)
exten => _X.,2,Hangup
增加 crontab, 請自行編譯，例如透過 crontab -e
0 6 * * * php /usr/local/src/a2billing/Cronjobs/currencies_update_yahoo.php
0 6 1 * * php /usr/local/src/a2billing/Cronjobs/a2billing_subscription_fee.php
0 * * * * php /usr/local/src/a2billing/Cronjobs/a2billing_notify_account.php
0 2 * * * php /usr/local/src/a2billing/Cronjobs/a2billing_bill_diduse.php
0 12 * * * php /usr/local/src/a2billing/Cronjobs/a2billing_batch_process.php
0 6 * * * php /usr/local/src/a2billing/Cronjobs/a2billing_batch_billing.php
*/5 * * * * php /usr/local/src/a2billing/Cronjobs/a2billing_batch_autodialer.php
0 * * * * php /usr/local/src/a2billing/Cronjobs/a2billing_alarm.php
手動增加 log files:
mkdir /var/log/a2billing; cd /var/log/a2billing
touch cront_a2b_alarm.log
touch cront_a2b_autorefill.log
touch cront_a2b_batch_process.log
touch cront_a2b_archive_data.log
touch cront_a2b_bill_diduse.log
touch cront_a2b_subscription_fee.log
touch cront_a2b_currency_update.log
touch cront_a2b_invoice.log
touch cront_a2b_check_account.log
touch a2billing_paypal.log
touch a2billing_epayment.log
touch a2billing_api_ecommerce_request.log
touch a2billing_api_callback_request.log
touch a2billing_api_card.log
touch a2billing_agi.log
cd /usr/local/src/a2billing
修改權限

chown -R asterisk.asterisk /etc/asterisk /var/{log,run,lib,spool}/asterisk /var/log/a2billing /usr/local/src/a2billing /var/www/html/a2billing
find /etc/asterisk /var/lib/asterisk /usr/local/src/a2billing -type d -exec chmod 777 {} \;
如果您發現網頁看不到或是其它怪怪的時候，很可能就是權限沒設定好，包括這邊寫的可能有遺漏， apache2 也要檢查

安裝 daemon

cd /usr/local/src/a2billing/CallBack/callback-daemon-py/
easy install sqlalchemy
cp -a callback_daemon/a2b-callback-daemon.debian /etc/init.d/a2b-callback-daemon
chmod a+x /etc/init.d/a2b-callback-daemon
如果要開機自動執行，請執行:
update-rc.d a2b-callback-daemon defaults
tar zxf dist/callback_daemon-1.0.prod-r1528.tar.gz -C /tmp
cd /tmp/callback_daemon-1.0.prod-r1528/
touch callback_daemon/__init__.py
python setup.py build &&python setup.py bdist_egg && python setup.py install --prefix=/usr
easy_install dist/callback_daemon-1.0.prod_r1528-py2.7.egg

重新啟動系統

其實可以透過 service 重啟即可，但是因為我在寫這道食譜時亂試一通，系統後來怪怪的，重新啟動後又一切正常
需要重新啟動的或許是底下幾個

mysql
apache2
asterisk
a2b-callback-daemon

測試
用瀏覽器瀏覽 http://localhost/a2billing/admin/

2016/02/04

Asterisk : The Cookbook 食譜 034 - 輪用辦公桌

Q034: 我想提供輪用辦公桌(Hot-Desking)使用電話系統，請問該怎麼設計？

說真的，以目前的食譜要來設計這樣的需求是足夠了，先來看看流程圖

簡單講就是，判斷是不是有人已經用同一支電話登入了，如果有，就將它登出，然後再用新的登入，否則直接登入。

底下直接寫範例(我也還在研讀當中):

[HotDesking]
exten => 7000,1,Verbose(2,Attempting logoff from device ${CHANNEL(peername)})
same => n,Set(PeerName=${CHANNEL(peername)})
same => n,Set(CurrentExtension=${DB(HotDesk/${PeerName})})
same => n,GoSubIf($[${EXISTS(${CurrentExtension})}]? subDeviceLogoff,1(${PeerName},${CurrentExtension}):loggedoff)
same => n,GotoIf($[${GOSUB_RETVAL} = 0]?loggedoff)
same => n,Playback(an-error-has-occurred)
same => n,Hangup()
same => n(loggedoff),Playback(silence/1&agent-loggedoff)
same => n,Hangup()
上面這段設定分機號碼 7000 用來登出裝置，

裝置以 ${PeerName} = ${CHANNEL(peername)} 表示，
分機號碼以 ${DB(HotDesk/${PeerName})} 表示

底下 71XX 則表示先登出現有的分機號碼再登入

exten => _71XX,1,Verbose(2,Attempting to login device ${CHANNEL(peername)} to extension ${EXTEN:1})
same => n,Set(NewPeerName=${CHANNEL(peername)})
same => n,Set(NewExtension=${EXTEN:1})

same => n,Set(ExistingExtension=${DB(HotDesk/${NewPeerName})})
same => n,GotoIf($[${EXISTS(${ExistingExtension})}]?get_existing_device)

same => n(check_device),NoOp()
same => n,Set(ExistingDevice=${DB(HotDesk/${NewExtension})})
same => n,GotoIf($[${EXISTS(${ExistingDevice})}]?get_existing_extension)
same => n,NoOp(Nothing to logout)
same => n,Goto(login)

same => n(get_existing_device),NoOp()
same => n,Set(ExistingDevice=${DB(HotDesk/${ExistingExtension})})
same => n,GotoIf($[${ISNULL(${ExistingDevice})}]?login)
same => n,GoSub(subDeviceLogoff,1(${ExistingDevice},${ExistingExtension}))
same => n,GotoIf($[${GOSUB_RETVAL} = 0]?check_device)
same => n,Playback(silence/1&an-error-has-occurred)
same => n,Hangup()

same => n(get_existing_extension),NoOp()
same => n,Set(ExistingExtension=${DB(HotDesk/${ExistingDevice})})
same => n,GoSubIf($[${EXISTS(${ExistingExtension})}]? subDeviceLogoff,1(${ExistingDevice},${ExistingExtension}):remove_device)
same => n,GotoIf($[${GOSUB_RETVAL} = 0]?loggedoff)
same => n,Playback(silence/1&an-error-has-occurred)
same => n,Hangup()

same => n(remove_device),NoOp()
same => n,Set(Result=${DB_DELETE(HotDesk/${ExistingDevice})})
same => n,Goto(loggedoff)

same => n(loggedoff),Verbose(2,Existing device and extensions have been logged off prior to login)

same => n(login),Verbose(2,Now logging in extension ${NewExtension} to device ${NewPeerName})
same => n,GoSub(subDeviceLogin,1(${NewPeerName},${NewExtension}))
same => n,GotoIf($[${GOSUB_RETVAL} = 0]?login_ok)
same => n,Playback(silence/1&an-error-has-occurred)
same => n,Hangup()

same => n(login_ok),Playback(silence/1&agent-loginok)
same => n,Hangup()

exten => subDeviceLogoff,1,NoOp()
same => n,Set(LOCAL(PeerName)=${ARG1})
same => n,Set(LOCAL(Extension)=${ARG2})
same => n,ExecIf($[${ISNULL(${LOCAL(PeerName)})} | ${ISNULL(${LOCAL(Extension)})}]?Return(-1))
same => n,Set(PeerNameResult=${DB_DELETE(HotDesk/${LOCAL(PeerName)})})
same => n,Set(ExtensionResult=${DB_DELETE(HotDesk/${LOCAL(Extension)})})
same => n,Return(0)

exten => subDeviceLogin,1,NoOp()
same => n,Set(LOCAL(PeerName)=${ARG1})
same => n,Set(LOCAL(Extension)=${ARG2})
same => n,ExecIf($[${ISNULL(${LOCAL(PeerName)})} | ${ISNULL(${LOCAL(Extension)})}]?Return(-1))
same => n,Set(DB(HotDesk/${LOCAL(PeerName)})=${LOCAL(Extension)})
same => n,Set(DB(HotDesk/${LOCAL(Extension)})=${LOCAL(PeerName)})
same => n,Set(ReturnResult=${IF($[${DB_EXISTS(HotDesk/${LOCAL(PeerName)})} & ${DB_EXISTS(HotDesk/${LOCAL(Extension)})}]?0:-1)})
same => n,Return(${ReturnResult})

Asterisk : The Cookbook 食譜 033 - 資料庫 AstDB

Q033: 靜態設定看得差不多了，如果想做一些動態設定，是否有像 File, Database 這類的儲存空間？

是的，Asterisk 有支援各種模組，裡面可以加入像 MySQL, Postgre SQL 這類資料庫，事實上它也有內建的資料庫，Asterisk 比較接近 Sqlite，底下用實例來說明:

exten => 678,1,NoOp()
same => n,Set(COUNT=${DB(test/count)})
same => n,GotoIf($[${ISNULL(${COUNT})}]?:continue)
same => n,Set(DB(test/count)=1)
same => n,Goto(1)
same => n(continue),NoOp()
same => n,Playback(silence/1)
same => n,SayNumber(${COUNT})
same => n,Set(COUNT=$[${COUNT} + 1])
same => n,Set(DB(test/count)=${COUNT})

讀資料 DB(FAMILY/KEY) 如上例的 ${DB(test/count)}
設定 Set(DB(FAMILY/KEY)=VALUE), 如上例的 Set(DB(test/count)=${COUNT})
刪資料:

DB_DELETE(FAMILY/KEY)
DBdeltree(FAMILY)

檢查資料是否存在 DB_EXIST(FAMILY/KEY)，如果要順便讀取其值的話，可以在呼叫後由 DB_RESULT 變數取得
傳回所有的 KEYs DB_KEYS(PREFIX)

所謂的 FAMILY 可以想成『資料庫』、『檔案』或是「群組」

Asterisk : The Cookbook 食譜 032 - 在地通道

Q032: 我們知道可以同時撥接多個通道，可是如果想要多個通道是輪流撥接時該怎麼辦呢？

雖然同時撥接很有用，有時我們更需要輪流撥接接通其中一個通道就夠了，以免同時吵到多個好友。這個需求或許可以用傳回值來判斷處理，但是 Asterisk 提供一個更簡單的寫法，也相當有用。一樣用實例來說明：

首先我們定義一個 Context [TimeDelay] 如下，共定義三個在地通道 channel_1, channel_2, channel_3，三個在地通道等待時間是不同的，後面的也都加上了 Wait()：

[TimeDelay]
exten => channel_1,1,Verbose(2,Dialing the first channel)
same => n,Dial(SIP/0000FFFF0001,20)
same => n,Hangup()
exten => channel_2,1,Verbose(2,Dialing the second channel with a delay)
same => n,Wait(10)
same => n,Dial(DAHDI/g0/14165551212)
exten => channel_3,1,Verbose(2,Dialing the third channel with a delay)
same => n,Wait(15)
same => n,Dial(SIP/MyITSP/12565551212,15)
same => n,Hangup()

在引用時如下，利用 Dial() 同時撥接 channel_1, channel_2, channel_3:

[LocalSets]
exten => 107,1,Verbose(2,Dialing multiple locations with time delay)
same => n,Dial(Local/channel_1@TimeDelay&Local/channel_2@TimeDelay
&Local/channel_3@TimeDelay,40)
same => n,Hangup()

因為三個在地通道的逾時時間不同，後面的通道也加了 Wait(), 因此這三個的開始時間與結束時間並不相同。請自行用下圖來閱讀理解。

或是用下表來配合上面的設定來閱讀

Asterisk : The Cookbook 食譜 031 - 巨集 Macros + GoSub

Q031: 如果我們公司有數百個帳號要設定，某些條件要採用相同的設定，有沒有不要單純採用複製貼上而是比較快速的方法撰寫？

是的，就像程式語言中的自訂函數，或是試算表中的自訂巨集，Asterisk 也可以自訂巨集及函數。

[巨集]

我也不往複雜的說，簡單說 Macro 非常像『簡化版的 Context』，至於 Context 可以回頭找找 Q025。一樣，我們從實例看起:

[macro-voicemail]
exten => s,1,NoOp()
same => n,Dial(${ARG1},10)
same => n,GotoIf($["${DIALSTATUS}" = "BUSY"]?busy:unavail)
same => n(unavail),VoiceMail(${MACRO_EXTEN}@default,u)
same => n,Hangup()
same => n(busy),VoiceMail(${MACRO_EXTEN}@default,b)
same => n,Hangup()

名稱一定要以 macro- 開頭
因為定義巨集時並不知道分機號碼，這邊採用 s 來代表呼叫者的分機號碼
底下介紹四個巨集內可以使用的變數:
${MACRO_CONTEXT} 呼叫者的 Context
${MACRO_EXTEN} 呼叫者的分機號
${MACRO_PRIORITY} 呼叫者所在的權值
${ARGn} 傳入的第 n 個參數，從 1 開始，例如 ${ARG1}, ${ARG2}

至於引用時很簡單:
exten => 101,1,Macro(voicemail,${JOHN})
exten => 102,1,Macro(voicemail,${JANE})
exten => 103,1,Macro(voicemail,${JACK})

比較一下巨集命名與呼叫時的引用名稱，參數，變數。
在巨集呼叫中的 ARGn, MACRO_EXTEN 會被取代成
101, JOHN
102, JANE
103, JACK
請仔細閱讀這幾個呼叫範例就會明白巨集呼叫時參數用法，以及上面四個變數的用法

上面範例還有一個變形，可以比較用法的差異：
[macro-voicemail]
exten => s,1,NoOp()
same => n,Dial(${ARG1},20)
same => n,Goto(s-${DIALSTATUS},1)
exten => s-NOANSWER,1,VoiceMail(${MACRO_EXTEN}@default,u)
same => n,Goto(incoming,s,1)
exten => s-BUSY,1,VoiceMail(${MACRO_EXTEN}@default,b)
same => n,Goto(incoming,s,1)
exten => _s-.,1,NoOp()
same => n,Goto(s-NOANSWER,1)
上例 Goto(s-XXX) 這樣的語法相當容易理解，把它想成字串就好，這樣的寫法應該更容易閱讀（如果沒有就用前一種寫法嘛）。Dial() 的傳回狀態有幾種:
ANSWER, BUSY, NOANSWER, CANCEL, CONGESTION, CHANUNAVAIL, DONTCALL, TORTURE, INVALIDARGS

如果仔細研讀上面的範例，其實可以修改成如下，讀不懂也沒關係喔，戲法人人會變，只要能正確作動，其實沒有什麼美醜好壞之別:
[macro-voicemail]
exten => s,1,NoOp()
same => n,Dial(${ARG1},20)
same => n,VoiceMail(${MACRO_EXTEN}@default,${IF($[${DIALSTATUS}
= BUSY]?b:u)})

這邊沒有說到的內容是，像 Dial() 本身可以相當複雜，也可以引用巨集，有機會再另外說明 Dial() 時再說（應該沒體力寫了）

[函數]

函數看起來很像巨集，一樣直接看範例，就用上面最後一個簡化版本:

[subVoicemail]
exten => start,1,NoOp()
same => n,Dial(${ARG1},20)
same => n,VoiceMail(${ARG2}@default,${IF($[${DIALSTATUS}
= BUSY]?b:u)})

有兩點不一樣：

[macro-voicemail] 變成 [subVoicemail]
GoSub() 的自訂函數其實沒有像巨集那樣的用法，比較像 Context，後面呼叫會看到，這邊的寫法是讓我們自己濾
分機號碼由 s 變成 start
巨集變數都不能用，只能取得參數 ${ARGn} 而已
不像巨集會自動返回呼叫者，GoSub() 必須自行指定是否返回，否則執行完函數就結束了

呼叫範例：

exten => 101,1,GoSub(subVoicemail,start,1(${JOHN},${EXTEN}))

exten => 102,1,GoSub(subVoicemail,start,1(${JANE},${EXTEN}))

exten => 103,1,GoSub(subVoicemail,start,1(${JACK},${EXTEN}))

為了說明返回，我們以底下的例子來說明：
[subDialer]
exten => start,1,NoOp()
same => n,Dial(${ARG1},${ARG2})
same => n,Return()
[subVoicemail]
exten => start,1,NoOp()
same => n,VoiceMail(${ARG1}@${ARG2},${ARG3})
same => n,Hangup()
呼叫時如下：
exten => 101,1,NoOp()
same => n,GoSub(subDialer,start,1(${JOHN},30))
same => n,GoSub(subVoicemail,start,1(${EXTEN},default,u))
如果自訂函數都沒有寫最後一行的 Return(), 那麼呼叫範例並不會執行最後一行的 GoSub(subVoicemail.....)
不過上例並沒有很好的把 Dial() 狀態傳回，底下是修改版本，而且 [subVoicemail] 以這個例子也不必 Return():

[subDialer]
exten => start,1,NoOp()
same => n,Dial(${ARG1},${ARG2})
same => n,Return(${DIALSTATUS})
[subVoicemail]
exten => start,1,NoOp()
same => n,VoiceMail(${ARG1}@${ARG2},${ARG3})
same => n,Hangup()
呼叫例使用 ${GOSUB_RETVAL} 來取得傳回值：

exten => 101,1,NoOp()
same => n,GoSub(subDialer,start,1(${JOHN},30))
same => n,Set(VoicemailMessage=${IF($[${GOSUB_RETVAL} = BUSY]?b:u)})
same => n,GoSub(subVoicemail,start,1(${EXTEN},default,${VoicemailMessage}))

Asterisk : The Cookbook 食譜 030 - 表示法 Expressions

Q030: 在撥號計劃設定檔中有看到類似四則運算，可以說明是怎麼用的嗎？

前面幾則對撥號計劃的設定其實已經說的很多了，基本的使用照理也沒什麼大問題才對。但是要設計自動話務員這類複雜的使用環境的話還有一個課題要說，就是所謂的『表示法』，也就是類似程式語言中的各項運算。

在 Asterisk 的運算中，邏輯運算跟 C 語言一樣，以 0 為假，以非 0 為真，如果有疑問的話，可以隨便找一本程式語言的書來翻翻看。

還記得前面曾經提到一個內建變數，指向現有的分機號碼的 ${EXTEN} 嗎？還記得曾經提過可以用 Set() 設定變數嗎？是的，變數是可以運算的。為了簡少本文長度，直接以實例說明：

same => n,Set(COUNT=3)
same => n,Set(NEWCOUNT=$[${COUNT} + 1])
same => n,SayNumber(${NEWCOUNT})

上面應該有看到變數運算要擺在 $[] 裡面, 而且仍然不變採用 ${} 來取得變數。同樣的，上面也看到了加法，底下就來說說除了加法以外的其它運算子，有些我就懶得打字了。

邏輯判斷 |, &, =, >, <, >=, <=, !=
有發現嗎？等於的判斷只有一個等號
四則運算 +, -, *, /, %
最後面 % 是『餘數』的意思
正規表示法 :, =~
因為第一個是冒號 ':' 特別提出來，因為要學正規表示法篇幅會變很大，雖然它很強大，但是除非相當進階才會需要，這邊就略過。

先總結一下，上面的運算子在其他語言中也都很常見，只是感覺混合了 C, Shell script, 所以差異之處自己要記住。Asterisk 早期版本要求運算子前後一定要有空白，而且通常寫程式時也都會要求我們把式子寫的『明確』一點，請看下例:

劣: same => n,Set(TEST=$[${COUNT}+1])
優: same => n,Set(TEST=$[ ${COUNT} + 1 ])

上面 Set() 是 Application, 而 ${} 則是變數引用， $[] 是變數運算，其中大中小括號的配對請自己小心閱讀，不要有了左邊漏了右邊。

接下來，在變數引用裡面可以使用函數運算，底下直接用例子說明:
same => n,SayNumber(${LEN(${TEST})})
上面的 LEN() 會計算後面參數字串 ${TEST}的長度

接下來介紹一個特別的函數，TIMEOUT(), 它會傳回一個變數，沒錯，直接看用法:

same => n, Set(TIMEOUT(digit)=30)

因為 TIMEOUT() 傳回變數，所以它本身不必用 ${} 括住，其中 digit 是 TIMEOUT() 可以用的三個類型之一。

條件判斷也是透過函數來表達，底下也是以實例來說明：

GotoIf(expression?destination1:destination2)
=================================

exten => 345,1,NoOp() ; 通常用複雜運算用 NoOp() 開頭
same => n,Set(TEST=1)
same => n,GotoIf($[${TEST} = 1]?weasels:iguanas)
same => n(weasels),Playback(weasels-eaten-phonesys)
same => n,Hangup()
same => n(iguanas),Playback(office-iguanas)
same => n,Hangup()

這邊先補充說明，在講權值時引入 same => n 這樣的表示法時沒說到的部份就是，因為 n 只代表繼續上一個權值，當我們需要參考到某個權值時，可以在 n 後面用 (LABEL) 的方式給予標記，就像上面例子那樣使用，就不多說了。比較特別的是下面的用法也是允許的，就是判斷成立反而不跳走而是繼續下一個，同理也可以像第二條:
same => n,GotoIf($[${TEST} = 1]?:iguanas)
same => n,GotoIf($[${TEST} != 1]?iguanas)

上面範例還有一種寫法更易閱讀，跳到分機號碼去了：
exten => 345,1,NoOp()
same => n,Answer()
same => n,Set(TEST=1)
same => n,GotoIf($[${TEST} = 1]?weasels,1:iguanas,1)
exten => weasels,1,
same => n,Playback(weasels-eaten-phonesys)
same => n,Hangup()
exten => iguanas,1,NoOp()
same => n,Playback(office-iguanas)
same => n,Hangup()

講到這邊篇幅已經很長了，但是仍然不得不提醒一件事，去翻一下 Shell Script, 就可以發現字串最好用 "" 括住，例如:

劣： same => n,GotoIf($[${TEST} = invalid]?err_handle)
當 ${TEST} 未設定或是空字串時就會出錯。
優： same => n,GotoIf($[ "${TEST}" = "invalid"]?err_handle)

同樣道理：

劣： same => n,GotoIf($[${TEST} < 1]?err_handle)
當 ${TEST} 未設定或是其實它是空字中時就會出錯
優： same => n,GotoIf($[ 0${TEST} < 1]?err_handle)

一個良好的 Asterisk 服務，應該能夠根據不同日期時間進行不同的服務，因此底下再特別提出 GotoIfTime() 函數。

GotoIfTime(times,days_of_week,days_of_month,months?label)

實例： same => n,GotoIfTime(09:00-17:59,mon-fri,*,*?open,s,1)

==============================================

times 可能的實例:

"5:00 PM", "09:00-17:00", "18:00-0900"

最後的實例會相當於下班時間，系統會自行處理跨日

days_of_week 可能的實例:

"mon", "tue", "wed", "the", "fri", "sat", "sun", "sun-mon", "sat&sun"

所以像週一三五的話是 "mon&wed&fri"

days_of_mon 可能的實例:

"1",...,"31", "7-12", "5&15&25"

months 可能的實例:

"jan", ..., "dec", "jan-apr&jun&oct-dec"

以上，如果要『全部』的話就用星號 "*"

函數就暫時說這麼多，詳細可以在 asterisk -rc 的 CLI 環境中以命令 'core show functions' 取得清單

2016/02/03

Asterisk : The Cookbook 食譜 029 - 重要設定檔

Q029: 如何客製化自己的 Asterisk 呢？

我把設定檔擺在這邊，是因為相信前面幾篇應該足夠大家使用 Asterisk 來撥號了。這篇主要說明三個重要的設定檔（設定檔都在 /etc/asterisk/ 中）。
為了不占太多篇幅，請自行參考系統中的檔案。這邊提醒一個最重要的注意事項，檔案的節後面若有 (!) 的話，表示這個只是草稿，如果你要讓它生效，請自行將它去掉。

==== asterisk.conf ====

asterisk.conf 就把它想成「系統設定」即可，在執行 Asterisk 時也可以指定它的路徑，沒指定時就是從預設路徑讀(/etc/asterisk/asterisk.conf):

/usr/sbin/asterisk -C /custom/path/to/asterisk.conf

這個檔有幾個重要的節：[directories], [options], [files], [compat]

[directories]

astetcdir 設定檔
astmoddir 模組檔
astvarlibdir 各種狀態資訊存放路徑
astdbdir Asterisk 內部資料庫存放路徑
astdatadir 資源檔存放路徑，例如各種錄音檔
astagidir 存放 agi-bin 的執行檔
astspooldir 存放各種對外緩衝資料，例如 voicemail, call recording....
astrundir 存放 linux socket, process ID
astlogdir 存放 log 檔

[options]

這邊的設定可以參考 man asterisk
比較需要知道的就是 runuser/rungroup 為執行時的帳號，通常就是 asterisk

[files]

用來設定 control socket 的控制權，指的是執行在背景，前景用 asterisk -r 的時候用:
astctlpermissions 0660
astctlowner root
astctlgroup apache
astctl asterisk.ctl

這邊都用預設即可，也就是全部都可以不寫出來

[compat]
這是為了向先前的版本相容時用的，一般都設定 1.6, 所以照預設值寫就好。

pbx_realtime=1.6
res_agi=1.6
app_set=1.6

==== modules.conf ====

假如只設定 autoload=yes 這一行的話，那就會預載所有 asterisk.conf 中指明路徑的所有模組。

所以如果你想控制載入的模組，可以用 autoload=yes, 然後把要放的模組放在指定的路徑即可。

如果要明確指定哪些要載入哪些不要載入，那麼就用 :

preload 指明一開始就要載入的模組，此設定跟 autoload 無關
load 指明要載入的模組，受 autoload 影響
noload 指明不要載入的模組，當然是在 autoload=yes 的情況下
require 這項跟 load 一樣，但是有更強烈的要求之意，如果載入失敗就離開 asterisk 不繼續執行
preload-require 這項跟 preload 一樣，當然也是載入失敗就離開

==== indications.conf ====

這個檔定義各種地區的音頻設定(tone indications)，預設是用美國，可以修改成台灣

country=us 改成 country=tw

在撥號計劃中，也可以用底下的語法來明確指明某 Context 採用哪個 tone indications

Set(CHANNEL(tonezone)=[tw])

Set(CHANNEL(musicclass)=[tw])

這邊提到的 tonezone, musicclass 通常也都會在別的設定檔中指明，或是採用在 indications.conf 中指定的 [genera] 中的 country 設定項。

底下用一個比較有趣的設定，星際爭霸的音效:

例如在 indications.conf 設定底下一節：

[starwars](us)

description = Star Wars Theme Song

ring = 262/400,392/500,0/100,349/400,330/400,294/400,524/400,392/500,0/100,

349/400,330/400,294/400,524/400,392/500,0/100,349/400,330/400,349/400,

294/500,0/2000

然後在 extensions.conf 中引用:

exten => 500,1,Answer()

same => n,Set(CHANNEL(tonezone)=starwars)

same => n,Dial(SIP/0000FFFF0002)

寫到這邊，如果您的系統只是自用的話，就在 indications.conf 中指明預設國家就夠了。如果還要給不同國家使用，那就在撥號計劃中如上面那樣使用。

==== musichold.conf ====

撥號時通常有各種音頻設定，甚至可以讓使用者下載自己的音頻（來電答鈴）。可以參考 http://www.university-music-on-hold.com/

這邊要說明的是，播放格式不同會影響 CPU 負載，例如 mp3 就遠比 .wav 還要需要 CPU 來解壓音頻。另外就是若採用非預設音頻格式的話，就需要指定 application 來播放，例如用 mpg123 來播放 mp3 格式的音頻，而 mpg123 可能需要額外安裝。

音頻檔放置路徑定義在 asterisk.conf 的 astdatadir 中，採用編譯的預設值跟 Ubuntu 套件的預設值是不同的，前者在 /var/lib/asterisk 而後者在 /usr/share/asterisk 中

======================================

講完幾個重要的設定檔之後，要提醒大家的是 log 檔，按照 asterisk.conf 的設定，可以找到 /var/log/asterisk/message 檔，它會記錄的跟 asterisk -cvvv 中見到的類似。

也許你在 log message 中會見到很多錯誤，很有可能就是你載入了太多模組，而這些模組在編譯時可能沒有被設定支援。你可以試著解決這些問題。

Asterisk : The Cookbook 食譜 028 - 撥號計劃的互動 3 Pattern Matching

Q028: 撥號計劃裡面常常見到一些怪符號，可以說明它們是什麼嗎？

除了前面提到的變數外，還會見到一些符號，通稱為樣式比對（否則就是錯誤輸入了）。

樣式比對通常需要很大的篇幅，這邊直接從範例來介紹：
exten => _NXX,1,Playback(silence/1&auth-thankyou)

_ 開頭告訴 Asterisk 這段字串是樣式比對
N 表示 2...9。就像前面的提到的 same => n ... 這段說的 n
X 表示 0..9
Z 表示 1..9
接下來說明「list」符號 []. 如果您對 Shell, Perl. 甚至 C, Java 等有了解的話，可以視為 array.....意思就是 [] 括住的『其中之一』.舉例來說
[123] 就代表 1, 2, 3 其中之一都符合樣式
[1-9] 則代表 1..9 這九個數字都符合樣式
[15-7] 則代表 1, 5, 6, 7 這四個數字符合樣式
. 沒錯，就是一個點 '.' 代表萬用字元，包括英文字也都符合樣式，有些語言的樣式比對用的是 ?
! 是的，驚嘆號 '!' 代表零個以上。有些語言的樣式比對用的是 *

如果您的樣式有英文，又想用到 NXZ 怎麼辦呢？可以考慮底下的方法

_[N]extNXZ 這樣的話，會比對到 Next999 這種字串。

另外，在北美19個國家中，共用一個 NANP 電話號碼表示法如下：

1-NPA-NXX-XXXX, 第一碼的 1 是給北美國家使用的。

說到這邊不得不提到另一項跟變數+樣式比對相關的問題：

如何在引用時引用『現在的分機號碼』？例如：

exten => _XXX,1,Answer()

same => n,SayDigits(??????)

是的，這個問題能夠解決的話就能夠做出更彈性的設定。

答案是...${EXTEN} 代表目前的分機號

exten => _XXX,1,Answer()
same => n,SayDigits(${EXTEN})

對於變數處理，知道 shell script 的人應該知道一種表示法，這邊先說一下，Asterisk 變數表達字串時，最前面的字元所處的索引值是 0, 跟 C 語言的陣列一樣。先來看看實例，如果 ${EXTEN} 值為 123456789 的話.....

${EXTEN:2} 其值為 3456789 表示索引值第 2 以後，所以傳回值是從 3 開始
${EXTEN:3:4} 其值為 4567 表示從索引值 3 開始，長度4個
${EXTEN:-4:2} 其值為 67，表示從後面數來第4個，長度 2個。這邊要知道的是從頭數是 0, 倒數則從 1 開始。
${EXTEN:1:-3} 其值為 23456，表示從索引值 1 開始，去掉後面3個

如果能了解上面幾項的話，應該會發現還算是夠強大了吧？

最後補充在這邊的是，include，沒錯，相當於把另一個 Context 載入到此的意思，語法如下：
include => Context

例如以這幾篇食譜來說，可以自訂一個 Context 如下：
[Custom]
include => TestMenu

還有一個類似的用法是載入檔案，用法如下：
#include "......" <-- c="" p="">

Asterisk : The Cookbook 食譜 027 - 撥號計劃的互動 2 Dial()

Q027: Dial() 在撥號計劃中扮演相當重要的角色，可以說明它的用法嗎？

先直接寫 Dial() 的語法: Dial(destination,[timeout, option, URI])
首先，必須要有目標，後面是逾時、選項、URI。

distination 就是目標，我們從實例來看：
Dial(DAHDI/1) 指的是用 DAHDI 技術（裝置），後面接其使用的資源 1(此處指的是通道)。
Dial(SIP/7001), 這個出現在前面的食譜中，指的是用 SIP 技術裡面的 [7001] Context。
Dial(DAHDI/1&SIP/7001&IAX2/Softphone), 這個範例是同時播到三個目標。可以想像老人機中，同時撥電話、傳簡訊、送 email ...

以 IAX2 協定來看的話，其語法可以像底下這樣:
Dial(technology/user[:password]@remote_host[:port][/remote_extension])
實例如 exten => 500,1,Dial(IAX2/guest@misery.digium.com/s)

以 DAHDI 裝置來看的話，可以如下:
Dial(DAHDI/[gGrR]channel_or_group[/remote_extension])
exten => 501,1,Dial(DAHDI/4/18005551212)

第二個參數是逾時秒數，直接看範例，底下等60秒逾時：
exten => 7001,n,Dial(SIP/7001,60)

第三個參數是 option, 這個是針對 Dial() 而非前面的 destination, 也是需要另外的篇幅說明，這邊就只提一個，'m'。m 選項需要在其他的 Context 中設定 Hold Music。一般在撥號時，對方會聽到嘟嘟聲，有了m 之後聽到設定中的錄音檔（就像來電答鈴）。底下是個範例：

exten => 502,1,Dial(DAHDI/1,10,m)
same => n,Playback(vm-nobodyavail)
same => n,Hangup()

第四個參數是根據前面的 destination 來決定的，如果 destination 需要一個 URI 傳入的話才會用到它，例如 XMPP 這種即時通訊才會用到。因為相當少用就不多說了。

允許某個參數不填，直接跳過即可，例如底下省略逾時：
exten => 1,1,Dial(DAHDI/1,,m)

底下先用一個範例來表達 Dial()，請自行研讀:
[TestMenu]
exten => start,1,Answer()
    same => n,Background(enter-ext-of-person)
    same => n,WaitExten(5)
  exten => 1,1,Dial(SIP/0000FFFF0001,10)
    same => n,Playback(vm-nobodyavail)
    same => n,Hangup()
  exten => 2,1,Dial(SIP/0000FFFF0002,10)
    same => n,Playback(vm-nobodyavail)
    same => n,Hangup()
  exten => i,1,Playback(pbx-invalid)
    same => n,Goto(TestMenu,start,1)
  exten => t,1,Playback(vm-goodbye)
    same => n,Hangup()

最後講講變數，沒錯，撥號計畫也因為有了變數使得整個設定更加彈性。
變數是區分大小寫的，習慣上會把變數都指定成大寫。順便說一下，通道則習慣用 Pascal 命名法。

在撥號計劃中，有三大類的變數：整體變數、通道變數、環境變數

整體變數定義在 [globals] Context 中，可以往前翻翻 Q025 這篇。整體變數可以在所有通道任何時候引用。在 [globals] Context 定義變數不像上面那樣，是採用更直接的方式，範例如下:

[globals]
LEIF=SIP/0000FFFF0001

通道變數就讓我們在底下直接用範例來說明：
exten => 301,1,Set(LEIF=SIP/0000FFFF0001)
same => n,Dial(${LEIF})
還記得嗎？我們說撥號計劃是一系列的步驟。上面第一行只是設定變數 LEIF 而已，在第二行引用時，必須用 ${} 括住。

環境變數則是在執行 Asterisk 的時候由系統產生的，因為你在設定檔中看不到，引用方式也比較特別，語法 ${ENV(var)}，範例如下:
${ENV(PATH)}

後面還有一項更複雜的項目需要說明，樣式比對。

Asterisk : The Cookbook 食譜 026 - 撥號計劃的互動 Interactive Dialplan

Q026: 前面只提到簡單的撥號計劃，可以進一步談談撥號計劃如何互相引用嗎？

是的，前一則食譜介紹的是靜態的撥號計劃，用來完成固定的動作是夠了。但是如果要在不同情況做不同的動作，就必須要特別的機制，這邊先介紹三個 Applications(): Goto(), Background(), 及 WaitExten()

Goto() 語法: same => n,Goto(context,extension,priority)
Goto() 需要三個參數，譬如: exten => 201,1,Goto(TestMenu,start,1)
如果要讓上面的範例可以作動，必須再定義一個 Context 如下：

[TestMenu]
exten => start,1,Answer()
....

這邊也示範了 Extension 不一定是數字，此處是 start
這個範例應用在一個實際通話中要求使用者輸入轉接分機，當使用者輸入 201 時，就會轉到 TestMenu 分機中。

Background() 語法跟 Playback() 一樣，但是最大的差異是 Playback() 遇到按鍵就中斷了，而 Background() 則不會。在應用上可以像加密輸入，或是邊播放語音說明邊等使用者輸入其他選擇（或是分機），後面的用法就是語音選單。這兩種用法都可以是 DTMF 數字。底下用一個比較實用的範例來說明:

[TestMenu]
exten => start,1,Answer()
same => n,Background(enter-ext-of-person)
same => n,WaitExten(5)
exten => 1,1,Playback(digits/1)
exten => 2,1,Playback(digits/2)
...

上面也用到了 WaitExten()，剛好用來做為語音選單的範例。WaitExten() 可以接等待的秒數當參數，沒給的話就用預設值(10秒)。上面範例剛好示範了當使用者在 Background() 期間輸入數字的話，會聽到該分機相對應的聲音。

以本則食譜來說，當使用者撥入 201 分機的話，首先會聽到英文的『請輸入分機號碼，我將為您轉接』，然後等你輸入 1, 或 2。

如果分機是多位數的話，可以參考底下的範例:
[TestMenu]
exten => start,1,Answer()
same => n,Background(enter-ext-of-person)
same => n,WaitExten(5)
exten => 1,1,Playback(digits/1)
same => n,Goto(TestMenu,start,1)
exten => 2,1,Playback(digits/2)

same => n,Goto(TestMenu,start,1)

講到這邊，你可以知道怎麼設計複雜的分機或是自動轉接的撥號計劃了。

底下就來處理無效的輸入或是處理逾時。

先簡介一下兩個分機號碼，無效輸入對應到 i, 逾時對應到 t。接下來用範例來說明：

[TestMenu]

exten => start,1,Answer()

same => n,Background(enter-ext-of-person)

same => n,WaitExten(5)

exten => 1,1,Playback(digits/1)

same => n,Goto(TestMenu,start,1)

exten => 2,1,Playback(digits/2)

same => n,Goto(TestMenu,start,1)

exten => i,1,Playback(pbx-invalid)

same => n,Goto(TestMenu,start,1)

exten => t,1,Playback(vm-goodbye)

same => n,Hangup()

上例中，當使用者輸入數字不在設定中的話，例如 3，就會選擇對應到無效輸入的 i, 此處是播『無效』的錄音檔，然後跳回去重新輸入。如果等太久遲遲沒有收到輸入的話，就會播『再見』的錄音檔，然後結束通話。

說到這邊雖然引入了兩個應用，要跟真人來對比仍然不足，所以接下來再引入另一個應用 Dial()。

我覺得 Dial() 是相當重要的，所以打算單獨來說，看前一篇的範例就知道，Dial() 幾乎是我們實際在設計分機時都會想要用的，而不像這邊提到的 Background(), WaitExten(), i, t, 等等。

Asterisk : The Cookbook 食譜 025 - 撥號計劃 Dialplan

Q025: 看前面幾條食譜，似乎撥號計劃是最核心的功能，可以進一步說明嗎？

愛因斯坦說過，任何事應該盡量抽絲撥簡，卻不要將之視為簡單（Everything should be made as simple as possible, but not simpler.）。這句話用來理解相對論似乎就說得通了，當我們看狹義相對論的時候，看似相當容易理解，可是背後的事情卻是相當深遠地影響全世界。

同樣的 Asterisk 也是如此。Asterisk 最核心的撥號計劃相當容易理解，能做到的事卻相當廣泛。簡單講，撥號計劃定義了系統如何處理一個撥號接入與轉出。根據這麼簡單的理解，在 Asterisk 前後的版本發展也容入了不同的草稿語法。話說回來，又因為簡單又有彈性的草稿語法，使得 Asterisk 對所有撥號可以客製化一個複雜的計劃（流程）。我可以大膽的聲稱，Asterisk 的能力取決於你對撥號計劃的了解多寡。

撥號計劃(extensions.conf)分成四個主要部份：Contexts, Extensions, Priorities, 及 Applications. 如果您從前一則食譜編譯 Asterisk 的話，範例應該是在 ~/pbx/asterisk-11.21.0/configs/extensions.conf.sample

[Contexts]

我們先以前則提到的內容來說，摘出一段如下：
[internal]
exten => 7001,1,Answer()
exten => 7001,2,Dial(SIP/7001,60)
exten => 7001,3,Playback(vm-nobodyavail)
exten => 7001,4,VoiceMail(7001@main)
exten => 7001,5,Hangup()

撥號計劃分成多個節，每一節稱之為一個 Context, 每一個 Context 看似獨立，卻是整個撥號計劃的一環，彼此互相連結而非單獨存在（就像眼耳手腳）。而 extension 翻譯成中文可以說是分機號碼或是電話號碼，在某一 Context 中定義時除非特別指明（引用），否則是與其他 Context 獨立無關的（也就是在別的 Context 中重複定義也沒關係）。

想像一下有兩個公司共用同一個 Asterisk 服務器（這很常見），假如將每一個公司的自動話務員放在各自的 Context 中，此時他們當然就各自獨立不互相千擾對方，也就是說各自公司都有相同的分機號碼是彼此不會干擾對方的。

有兩個特別的 Contexts: [general] 及 [globals]。[general] 定義一般的撥號計劃的設定，這邊只需要知道這兩個非一般的 Context 即可。

前文也提過「通道」的說法，一個通道不止包括 extensions.conf, 還包括 sip.conf, iax.conf, chan_dahdi.conf 等等等。通道定義中一個必要的參數就叫 context，我們就以圖來表示吧：

圖中 sip.conf 中有一通道 [0000FFFF0001] 定義，其中的 context 指向 extensions.conf 中的 [LocalSets] 這個 Context. 當然這邊的字眼既然採用同一個，能幫助記憶，也有點容易讓人混淆，就靠你自行理解記憶囉。

對 Context 一個最重要的用法其實是『加密』，系統如果沒有很好的加密的話，很有可能就變成駭客入侵最佳的平台。可以參考 Asterisk Wiki中的說明，後面也會提到。

[Extensions]

在電信世界中，分機號碼通常就只是一組號碼，但是在 Asterisk 中，要理解 Extesions 卻必須看成『用來回應一通撥號的一串步驟』（這也是為什麼要叫撥號計劃的原因）。

在撥號計劃中，Extensions 是以關鍵字 exten 來表示，後面接 => 來表達指定之意。另外要提的是，在 Asterisk 的觀念中，Extensions 並非單純的數字，它通常是數字+文字的組合，甚至可以是 email 的格式，這一點讓 Asterisk 更有彈性也讓 Asterisk 更加強大。

一個 Extesion 的每個步驟包括三個部份：分機名稱（或是號碼）, 權值（也可以看成真正的順序），及 application(或是命令)。其形式就是 :

exten => name, priority, application()

以最上面顯示的來說，就像 "exten => 7001,1,Answer()"

[Priorities]

其中權值可以視為真正的順序，所以最好是由小到大遞增，這樣也有助於理解。但是因為權值用純粹的數字容易引發問題，就像早期的 basic 語言一樣，要在中間插入一條步驟的話就會有困擾，所以後來引入 n 這個權值，它代表就按出現的順序由上而下承接，要記住的是一定要從 1 開始不能省略。例如:

exten => 7001,1,Answer()
exten => 7001,n,Dial(SIP/7001,60)
exten => 7001,n,Playback(vm-nobodyavail)
exten => 7001,n,VoiceMail(7001@main)
exten => 7001,n,Hangup()

為了簡化撰寫，後來也引入了 same => 記號，上例又可以寫成如下：

exten => 7001,1,Answer()
same => n,Dial(SIP/7001,60)
same => n,Playback(vm-nobodyavail)
same => n,VoiceMail(7001@main)
same => n,Hangup()

右移內縮只是為了容易閱讀，有沒有內縮不影響設定。

權值還可以給予標記，以便後面引用，就像程式語言中的 goto，這邊暫時不提，只簡單寫出正確與錯誤的寫法:

[正確] exten => 123,n(label),application()

[錯誤] exten => 123,n,(label),application()

[Applications]

Applications 可以視為『命令』或是『動作』，用來完成一個通道的一系列回應動作。最常用的有兩個：Answer(), Hangup()。每個 Application 括號中可以加入參數（有可能沒有參數），請見上面的實例。

Answer() 用來告知通道正在『響鈴中』，不必給予參數，也不見得一定要求有此 application。

Playback() 用來播放一段錄音檔，此時撥號端的用戶輸入聲音會被忽略，所以在自動話務員中不應該使用 Playback()。錄音檔通常可以在 /var/lib/asterisk/sounds 中找到，如果是 Ubuntu 預設套件的話，應該是在 /usr/share/asterisk/sounds 中。上例的 Playback() 只需提供檔名，省略附檔名，也可以指定 full-path 格式，但是仍然省略附檔名。附檔名系統會自動找，因為有可能是 .wav, .g722, 或是 .gsm 等等等

Hangup() 則用來掛斷通道，每個 Context 的最後，應該都以 Hangup() 結尾。

2016/02/02

Asterisk : The Cookbook 食譜 024 - 在 Ubuntu 下的簡易安裝

Q024: 在 Ubuntu 下不想自己編譯 source code，有沒有更簡單的安裝方法？

是的，目前 Ubuntu 15.10 系統預設的 asterisk 套件版本是 13.1.0, 是可以直接透過安裝套件來達到目的，底下是簡單的指令:

1. 安裝套件
$ sudo apt-get install asterisk asterisk-config asterisk-core-sounds-en asterisk-core-sounds-en-* asterisk-modules asterisk-moh-opsound-g722 asterisk-moh-opsound-gsm asterisk-moh-opsound-wav asterisk-mp3 asterisk-mysql asterisk-ooh323 asterisk-voicemail

2. 修改設定檔
請按照 Q023 的設定檔，修改 asterisk.conf extensions.conf manager.conf modules.conf sip.conf

如果您啟動 asterisk 之後不知道原因無法連線的話，最需要檢查的三個檔是 extensions.conf, sip.conf 及 modules.conf
之所以會特別加這一段話，主要就是因為我在我的電腦 15.10 中工作，所以常常亂裝些套件，更動了不知道什麼設定之後，幾年來又常常把它更新到最新的 Ubuntu 版本。所以我在前前後後幾次裝 Asterisk 都失敗，嘗試了自己編譯或是 Ubuntu 內建套件安裝都無果，也就是我一直搞不懂失敗原因。也因為這樣的機緣，所以我才打算翻譯這本食譜，那時我還不認為我的電腦能夠解決問題，本打算重新安裝試試呢。
在寫這篇食譜之前，我用一台小筆電裝過是成功的，那本是用 FreePBX, 後來用虛擬機用 ubuntu 14.04 Server 安裝也是成功的，那台是用編譯的 Asterisk。
後來在寫這一則食譜(Q023)的時候，我剛剛好照著文件上的做（不是我寫的部份）其實是錯的，因為照原文的話是 ./configure --libdir=/lib64，造成系統找不到 modules, 但是反而能夠連通。也因為這樣的機緣，才讓我找到主要原因是 modules.conf 的問題。原文提到的設定，應該是在 asterisk.conf 中將 astdatadir 設成 /lib64/asterisk 才對。只有純粹的 ./configure 才會將模組裝在預設的 /var/lib/asterisk 下。

如果您發現 SIP client 跟 Asterisk 不通，而你又覺得設定檔都已經照著教學修改了卻仍然不通的話，很有可能是 modules 的設定。以上一則的範例來說，我是把所有 PJSIP 模組都拿掉了才通的。

總之，不是把所有模組都載入才是最好的，而是適合自己的才是最好的。

Asterisk : The Cookbook 食譜 023 - 在 Ubuntu 下的安裝

Q023: 能談談在 Ubuntu 下怎麼安裝 Asterisk 嗎？

其實不管 Ubuntu, Debian, Redhat, CentOS 等等，系統部份雖然不見得一樣，但是 Asterisk 的編譯部份是相差不多的。

1. 安裝編譯環境：
＄ sudo apt-get install build-essential subversion \
libncurses5-dev libssl-dev libxml2-dev libsqlite3-dev \
uuid-dev

2. 準備源碼
$ mkdir ~/pbx; cd ~/pbx
$ wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-11-current.tar.gz
我實驗的版本是 11-current, 解開後是 11.21.0，可以自行驗證 12, 13 等
$ tar zxf asterisk-11-current.tar.gz; cd asterisk-11*
$ contrib/scripts/get_mp3_source.sh
$ sudo ./contrib/scripts/install_prereq install
$ sudo ./contrib/scripts/install_prereq install-unpackaged
3. 編譯,以我的 Ubuntu 是 64 bit, 命令如下
$ ./configure 即可

目前的電腦大部份都是多核心的，底下 -j8 可以加速編譯速度，可以視系統的 CPU 核心數來決定。
$ make -j8
$ make menuselect
在 make menuselect 時，我是盡可能都選了，也可以不做 make menuselect，這不影響本次實驗結果
$ sudo make install && sudo make config && sudo make samples
4. 修改權限
$ sudo adduser --home /var/lib/asterisk --shell /bin/false asterisk && sudo passwd asterisk
$ sudo chown -R asterisk.asterisk /var/{lib,spool,log,run}/asterisk
5. 準備設定檔，存放在 /etc/asterisk/ 中
這一段比較複雜，先以我實驗的實例提供大家參考

===== extensions.conf ======
[globals]
INTERNAL_DIAL_OPT=,30
[internal]
exten => 7001,1,Answer()
exten => 7001,2,Dial(SIP/7001,60)
exten => 7001,3,Playback(vm-nobodyavail)
exten => 7001,4,VoiceMail(7001@main)
exten => 7001,5,Hangup()
exten => 7002,1,Answer()
exten => 7002,2,Dial(SIP/7001,60)
exten => 7002,3,Playback(vm-nobodyavail)
exten => 7002,4,VoiceMail(7001@main)
exten => 7002,5,Hangup()
exten => 7003,1,Answer()
exten => 7003,2,Dial(SIP/7001,60)
exten => 7003,3,Playback(vm-nobodyavail)
exten => 7003,4,VoiceMail(7001@main)
exten => 7003,5,Hangup()
exten => 8001,1,VoicemailMain(7001@main)
exten => 8001,2,Hangup()
exten => 8002,1,VoicemailMain(7002@main)
exten => 8002,2,Hangup()
exten => 8003,1,VoicemailMain(7003@main)
exten => 8003,2,Hangup()

===== sip.conf ======

[general]

context=internal

allowguest=no

allowoverlap=no

bindaddr=0.0.0.0

bindport=5060

srvlookup=no

allow=ulaw

localnet=192.168.1.0/255.255.255.0

[7001]

type=friend

host=dynamic

secret=123456

context=internal

[7002]

type=friend

host=dynamic

secret=123456

context=internal

[7003]

type=friend

host=dynamic

secret=123456

context=internal

===== manager.conf ======

[general]

enabled = yes

webenabled = yes

port = 5038

bindaddr = 0.0.0.0

displaysystemname = yes

httptimeout = 60

[admin]

secret = 123456

permit = 192.168.1.0/24

read = system,call,log,verbose,agent,user,config,command,dtmf,reporting,cdr,dialplan,originate,message

write = system,call,log,verbose,agent,user,config,command,reporting,originate,message

===== asterisk.conf ======

[directories]

astetcdir => /etc/asterisk

astmoddir => /usr/lib/asterisk/modules

astvarlibdir => /var/lib/asterisk

astdbdir => /var/lib/asterisk

astkeydir => /var/lib/asterisk

astdatadir => /var/lib/asterisk

astagidir => /var/lib/asterisk/agi-bin

astspooldir => /var/spool/asterisk

astrundir => /var/run/asterisk

astlogdir => /var/log/asterisk

astsbindir => /usr/sbin

[options]

runuser = asterisk

rungroup = asterisk

documentation_language = en_US

[compat]

pbx_realtime=1.6

res_agi=1.6

app_set=1.6

===== modules.conf ======

[modules]
autoload=yes
load => res_musiconhold.so
noload => res_speech.so
noload => res_phoneprov.so
noload => pbx_gtkconsole.so
noload => chan_alsa.so
noload => chan_console.so
noload => res_ael_share.so
noload => res_clialiases.so
noload => res_adsi.so
noload => pbx_ael.so
noload => pbx_dundi.so
noload => chan_oss.so
noload => chan_mgcp.so
noload => chan_skinny.so
noload => chan_phone.so
noload => chan_agent.so
noload => chan_unistim.so
noload => app_nbscat.so
noload => app_amd.so
noload => app_minivm.so
noload => app_zapateller.so
noload => app_ices.so
noload => app_sendtext.so
noload => app_speech_utils.so
noload => app_mp3.so
noload => app_flash.so
noload => app_getcpeid.so
noload => app_setcallerid.so
noload => app_adsiprog.so
noload => app_forkcdr.so
noload => app_sms.so
noload => app_morsecode.so
noload => app_followme.so
noload => app_url.so
noload => app_alarmreceiver.so
noload => app_disa.so
noload => app_dahdiras.so
noload => app_senddtmf.so
noload => app_sayunixtime.so
noload => app_test.so
noload => app_externalivr.so
noload => app_image.so
noload => app_dictate.so
noload => app_festival.so
noload => chan_pjsip.so
noload => func_pjsip_aor.so
noload => func_pjsip_contact.so
noload => func_pjsip_endpoint.so
noload => res_hep_pjsip.so
noload => res_pjsip_acl.so
noload => res_pjsip_authenticator_digest.so
noload => res_pjsip_caller_id.so
noload => res_pjsip_config_wizard.so
noload => res_pjsip_dialog_info_body_generator.so
noload => res_pjsip_diversion.so
noload => res_pjsip_dlg_options.so
noload => res_pjsip_dtmf_info.so
noload => res_pjsip_endpoint_identifier_anonymous.so

noload => res_pjsip_endpoint_identifier_ip.so

noload => res_pjsip_endpoint_identifier_user.so

noload => res_pjsip_exten_state.so

noload => res_pjsip_header_funcs.so

noload => res_pjsip_keepalive.so

noload => res_pjsip_log_forwarder.so

noload => res_pjsip_logger.so

noload => res_pjsip_messaging.so

noload => res_pjsip_multihomed.so

noload => res_pjsip_mwi_body_generator.so

noload => res_pjsip_mwi.so

noload => res_pjsip_nat.so

noload => res_pjsip_notify.so

noload => res_pjsip_one_touch_record_info.so

noload => res_pjsip_outbound_authenticator_digest.so

noload => res_pjsip_outbound_publish.so

noload => res_pjsip_outbound_registration.so

noload => res_pjsip_path.so

noload => res_pjsip_phoneprov_provider.so

noload => res_pjsip_pidf_body_generator.so

noload => res_pjsip_pidf_digium_body_supplement.so

noload => res_pjsip_pidf_eyebeam_body_supplement.so

noload => res_pjsip_publish_asterisk.so

noload => res_pjsip_pubsub.so

noload => res_pjsip_refer.so

noload => res_pjsip_registrar_expire.so

noload => res_pjsip_registrar.so

noload => res_pjsip_rfc3326.so

noload => res_pjsip_sdp_rtp.so

noload => res_pjsip_send_to_voicemail.so

noload => res_pjsip_session.so

noload => res_pjsip_sips_contact.so

noload => res_pjsip.so

noload => res_pjsip_t38.so

noload => res_pjsip_transport_websocket.so

noload => res_pjsip_xpidf_body_generator.so

6. 啟動與停止

$ sudo /usr/sbin/asterisk -cvvv

$ CLI> core stop now

如果想直接在背景執行，就不加參數 $ sudo /usr/sbin/asterisk

如果想停止背景中的 asterisk, 可以如下：

$ sudo /usr/sbin/asterisk -rc

CLI> core stop now

PS: 我試過 asterisk-13.7.0, 11.21.0, 12.8.2 都是可以連線的
PS: 如果無法連線，有很多情況是模組載入問題，請試著修改 modules.conf 試試

2016/02/01

Asterisk : The Cookbook 食譜 022 - 其它 Asterisk 專案

A022: 當我在尋找 Asterisk 時，看到很多不同的專案，這份食譜會說明這些專案嗎？

因為 Asterisk 是相當開放的軟體專案，所以也受很多組織支援。譬如 FreePBX 就是其中最著名的一套，主要是以 Asterisk 為核心，包裝了管理的 GUI 界面，並且釋出 ISO 檔讓人很容易安裝到機器中。

因為不同的打包會有不同的安裝、使用方式，我只打算講解 Asterisk 這個核心功能，因為光 Asterisk 就已經需要大量的篇幅。當然，這些專案也都以 Asterisk 為核心，所以只有深入了解基礎部份，也對您了解並使用其它專案有很大的幫助。

底下摘要說明 FreePBX 專案及其衍生的專案：

FreePBX: 由 FreePBX 組織發行，主要整合 Web GUI + mysql 當資料庫管理 Asterisk。底下還有其它基於 FreePBX 而來的其它套件。

AsteriskNOW: 由 Digium 維護發行
Elastix
FreePBX ISO
PBX in a Flash

這邊要特別說明的是，單純的 Asterisk 就足夠您使用了，但是要簡化安裝管理的話，或許您還得繼續研讀 FreePBX. 但是，它們並非真正免費的，當您進一步使用這些專案就知道了。

Asterisk : The Cookbook 食譜 021 - Asterisk 的版本

Q021: Asterisk 的版本好像很複雜？感覺不是很一致，可以說明一下嗎？

一個一直維護的版本來自這兒, 底下是摘要，這邊先補充一句話，在 1.1x 以後的版本，就直接以 1x 為主版號:

Release Series	Release Type	Release Date	Security Fix Only	EOL
1.2.X		2005-11-21	2007-08-07	2010-11-21
1.4.X	LTS	2006-12-23	2011-04-21	2012-04-21
1.6.0.X	Standard	2008-10-01	2010-05-01	2010-10-01
1.6.1.X	Standard	2009-04-27	2010-05-01	2011-04-27
1.6.2.X	Standard	2009-12-18	2011-04-21	2012-04-21
1.8.X	LTS	2010-10-21	2014-10-21	2015-10-21
10.X	Standard	2011-12-15	2012-12-15	2013-12-15
11.x	LTS	2012-10-25	2016-10-25	2017-10-25
12.x	Standard	2013-12-20	2014-12-20	2015-12-20
13.x	LTS	2014-10-24	2018-10-24	2019-10-24
14.x	Standard	2016-10 (tentative)	2017-10 (tentative)	2018-10 (tentative)
15.x	LTS	2017-10 (tentative)	2021-10 (tentative)	2022-10 (tentative)

上面 1.8.x 存在的時間相當久，所以一般文件也都在講這個版本。另外 11.x 起始於 2012-10-25, 因為它被標註為 LTS, 所以也有文件以它為主。

再看看 13.x 系列是從 2014-10-24 才開始，因為它被標註為 LTS(長期支援版本)，因此 Ubuntu 中的套件也是這個系列，但是它起始年份比較新，所以要找到專門的文件反而不多。

Asterisk : The Cookbook 食譜 020 - 支援的硬體

Q020: 請問 Asterisk 要成為真正的 PBX 需要哪些硬體？

Asterisk 相容於現有諸多不同的技術，也因此有很多公司生產支援的硬體，譬如 Digium, Sangoma, Rhino, OpenVox, Pika, Voicetronix, Junghanns, Dialogic, Xorcom, beroNet 等等等。前兩個是比較受歡迎的公司，但是在參考支援的硬體時，適不適合你使用才是最後決定性因素。

最受歡迎的硬體通常支援一個硬體界面稱為 Digium Asterisk Hardware Device Interface(DAHDI), 後面還有討論到它。

這邊要再補充一句就是，這些硬體都會有不同的安裝需求與檔案結構，請在購買之前先詢問好技術支援，確認你都懂了再買會比較保險。

Asterisk : The Cookbook 食譜 019 - 撥號計劃

Q019: 請問什麼是『撥號計劃』？

撥號計劃是 Asterisk 的心臟。在系統中收到的所有信號通道將被傳遞到撥號計劃，其中包含通話腳本，它決定打進來的通話該如何被處理。

撥號計劃有三種表達方式如下：

使用傳統的 Asterisk 撥號計劃語法，它儲存在 /etc/asterisk/extensions.conf
使用新的 Asterisk 擴充邏輯(AEL)，它儲存在 /etc/asterisk/extensions.ael
使用 Lua 語法，它儲存在 /etc/asterisk/extensions.lua

別急，後面會講到傳統語法，它很容易延展到另外兩個(AEL, Lua)

2016/01/26

Asterisk : The Cookbook 食譜 018 - 檔案結構

Q018: Asterisk 的檔案太多了，可以解譯各個檔案的功能嗎？

是的，Asterisk 是一個複雜的系統，整合了諸多資源，而這些資源使用系統中各種不同的方式。底下的解說採用 Ubuntu 為例。

[組態檔]

Asterisk 的組態檔預設都是放在 /etc/asterisk/ ，底下是幾個比較重要的設定
extensions.conf manager.conf sip.conf voicemail.conf asterisk.conf
在最後面會有這幾個檔的範例

[模組]

根據 asterisk.conf 中的設定，模組是放在 astmoddir => /usr/lib/asterisk/modules 中
需要注意的是，新舊版本的模組是不相容的，建議把舊的模組刪除或是備份。

[資源檔]

音樂檔(像 Music oh Hold(MOH)) 照 asterisk.conf 的設定，是放在 /usr/share/asterisk/moh 中。這邊要注意的是要依據設定檔來找，有很大可能也會放在 /var/lib/asterisk/moh 中

[spool]

spool 通常放在 /var/spool/asterisk 中，這目錄放的檔案主要是需要其他工具使用，例如 mail, printer 等等

[記錄]

記錄檔通常放 /var/log/asterisk 中，種類很多，包括 CDR, CEL, debug log, queue log, mesages, error 等等等

== extensions.conf ==
[general]
static=yes
writeprotect=no
clearglobalvars=no

[internal]

exten=>7001,1,Answer()

exten=>7001,2,Dial(SIP/7001,60)

exten=>7001,3,Playback(vm-nobodyavail)

exten=>7001,4,VoiceMail(7001@main)

exten=>7001,5,Hangup()

exten=>7002,1,Answer()

exten=>7002,2,Dial(SIP/7002,60)

exten=>7002,3,Playback(vm-nobodyavail)

exten=>7002,4,VoiceMail(7002@main)

exten=>7002,5,Hangup()

exten=>7003,1,Answer()

exten=>7003,2,Dial(SIP/7002,60)

exten=>7003,3,Playback(vm-nobodyavail)

exten=>7003,4,VoiceMail(7002@main)

exten=>7003,5,Hangup()

exten=>8001,1,VoicemailMain(7001@main)

exten=>8001,2,Hangup()

exten=>8002,1,VoicemailMain(7002@main)

exten=>8002,2,Hangup()

== manager.conf ==

[general]

enabled = yes

webenabled = yes

port = 5038

bindaddr = 0.0.0.0

displaysystemname = yes

httptimeout = 60

[admin]

secret = 123456

permit = 192.168.1.0/24

read = system,call,log,verbose,command,agent,user,config

write = system,call,log,verbose,command,agent,user,config

== sip.conf ==

[general]

context=internal

allowguest=no

allowoverlap=no

bindport=5060

bindaddr=0.0.0.0

srvlookup=no

allow=ulaw

nat=yes

localnet=192.168.1.0/24

[my-codecs](!)

disallow=all

allow=ilbc

allow=g729

allow=gsm

allow=g723

allow=ulaw

[7001]

type=friend

host=dynamic

secret=123456

context=internal

[7002]

type=friend

host=dynamic

secret=123456

context=internal

[7003]

type=friend

host=dynamic

secret=123456

context=internal

== voicemail.conf ==

[general]

format=wav49|gsm|wav

serveremail=asterisk

attach=yes

skipms=3000

maxsilence=10

silencethreshold=128

maxlogins=3

emaildateformat=%A,%B%d,%Yat%r

pagerdateformat=%A,%B%d,%Yat%r

[zonemessages]

eastern=America/New_York|'vm-received'Q'digits/at'IMp

central=America/Chicago|'vm-received'Q'digits/at'IMp

central24=America/Chicago|'vm-received'q'digits/at'HN'hours'

military=Zulu|'vm-received'q'digits/at'HN'hours''phonetic/z_p'

european=Europe/Copenhagen|'vm-received'adb'digits/at'HM

[default]

1234=>4242,ExampleMailbox,root@localhost

[other]

1234=>5678,Company2User,root@localhost

[main]

7001=>123456

7002=>123456

7003=>123456

== asterisk.conf ==

[directories](!)

astetcdir => /etc/asterisk

astmoddir => /usr/lib/asterisk/modules

astvarlibdir => /var/lib/asterisk

astdbdir => /var/lib/asterisk

astkeydir => /var/lib/asterisk

astdatadir => /usr/share/asterisk

astagidir => /usr/share/asterisk/agi-bin

astspooldir => /var/spool/asterisk

astrundir => /var/run/asterisk

astlogdir => /var/log/asterisk

astsbindir => /usr/sbin

Asterisk : The Cookbook 食譜 017 - 加值

Q017: 可以說說加值模組嗎？

加值模組屬於社群自行開發的，通常放在獨立的目錄而且預設並不會被編譯進來。如果你想啟動它的話，請利用源碼編譯時採用 make menuselect 來選擇。

app_mysql Executes MySQL queries with a dialplan application (過期，請參考 func_odbc)
app_saycountpl Says Polish counting words (過期，已整合在 say.conf)
cdr_mysql Logs CDRs to a MySQL database (有用的)
chan_mobile Enables making and receiving phone calls using cell phones over Bluetooth (有限制的)
chan_ooh323 Enables making and receiving VoIP calls using the H.323 protocol (有用的)
format_mp3 Allows Asterisk to play MP3 files (有用的)
res_config_mysql Uses a MySQL database as a realtime configuration backend (有用的)

Asterisk : The Cookbook 食譜 016 - 資源

Q016: 可以說說資源模組嗎？

Asterisk 的組態設置都存放在 /etc/asterisk/ 中，每個模組有各自的組態。

res_config_curl Pulls configuration information using cURL (有用的)
res_config_ldap Pulls configuration information using LDAP (可用的)
res_config_odbc Pulls configuration information using ODBC (有用的)
res_config_pgsql Pulls configuration information using PostgreSQL (有用的)
res_config_sqlite Pulls configuration information using SQLite (version 2) (有用的)
res_config_sqlite3 Pulls configuration information using SQLite (version 3) (有用的)

有些操作需要時間來源，不過像 MeetMe() 卻不是使用時間界面，而是直接從 DAHDI 取得。不過並不是每個機器都有支援 DAHDI 硬體模組，所以也可以考慮改用 res_timing_timerfd。可能的話盡量不要使用 res_timing_pthread，因為它比較沒效率。
res_timing_dahdi Provides timing using the DAHDI kernel interface (有用的)
res_timing_kqueue Provides timing using a kernel feature in some BSDs, including Mac OS X (有用的)
res_timing_pthread Provides timing using only parts of the standard pthread API; less efficient but more portable than other timing modules (有用的)
res_timing_timerfd Provides timing using the timerfd API provided by newer versions of the Linux kernel (有用的)
Asterisk 也整合某些行事曆系統，你可以讀寫撥號計畫中的行事曆資訊，也可以透過行程安排自動撥號。
res_calendar Enables base integration to calendaring systems (有用的)
res_calendar_caldav Allows features provided by res_calendar to connect to calendars via CalDAV (有用的)
res_calendar_exchange Allows features provided by res_calendar to connect to MS Exchange (有用的)
res_calendar_icalendar Allows features provided by res_calendar to connect to Apple/Google iCalendar (有用的)
Asterisk 的核心並不包含 RTP 實作，所以如果你的某個 VoIP 通道需要 RTP 的話，就必須先載入 res_rtp_asterisk 模組。而多點廣播 RTP 只用在 chan_multicast_rtp 通道。
res_rtp_asterisk Provides RTP (重要的)
res_rtp_multicast Provides multicast RTP
Asterisk 在使用在各個音頻與視頻格式時，可以實作的一個重要介面就是『屬性』。
res_format_attr_celt Handles format attribute details for the CELT audio format (有用的)
res_format_attr_h263 Handles format attribute details for the H.263 video format (有用的)
res_format_attr_h264 Handles format attribute details for the H.264 video format (有用的)
res_format_attr_silk Handles format attribute details for the SILK audio format (有用的)
底下是一些可選模組供 Asterisk 命令列界面(CLI)使用
res_clialiases Creates CLI aliases (有用的)
res_clioriginate Provides an Asterisk CLI command for originating calls (有用的)
res_convert Provides an Asterisk CLI command to perform file-format conversions (有用的)
res_limit Enables adjusting of system limits on the Asterisk process (有用的)
res_realtime Provides CLI commands for the Asterisk Realtime Architecture (ARA) (有用的)
其他資源，不代表不重要，只是沒有特別將它分類而已
res_adsi Provides ADSI (重要)
res_ael_share Provides shared routines for use with pbx_ael (如果使用 AEL 就重要，不過應該沒人在用 AEL)
res_agi Provides the Asterisk Gateway Interface (see Chapter 21) (有用的)
res_corosync Provides distributed message waiting indication (MWI) and device state notifications via the Corosync Cluster Engine (有用的)
res_crypto Provides cryptographic capabilities (有用的)
res_curl Provides common subroutines for other cURL modules (有用的)
res_fax Provides common subroutines for other fax modules (有用的)
res_fax_spandsp Plug-in for fax using the spandsp package (有用的)
res_http_post Provides POST upload support for the Asterisk HTTP server (有用的)
res_http_websocket Provides WebSocket support for the Asterisk internal HTTP server; also utilized by chan_sip to provide SIP over a WebSocket connection, which is useful for rtcweb(有用的)
res_jabber Provides Jabber/XMPP resources (過期，請參考 res_xmpp)
res_monitor Provides call-recording resources (有用的)
res_musiconhold Provides music on hold (MOH) resources (重要)
res_mutestream Allows muting/unmuting of audio streams
res_odbc Provides common subroutines for other ODBC modules (有用的)
res_phoneprov Provisions phones from Asterisk HTTP server
res_pktccops Provides PacketCable COPS resources
res_security_log Enables logging of security events generated by other parts of Asterisk
res_smdi Provides voicemail notification using the SMDI protocol (有限制的)
res_snmp Provides system status information to an SNMP-managed network (有用的)
res_speech Generic speech recognition API (有限制的)
res_xmpp Provides Jabber/XMPP resources (有用的)

Asterisk : The Cookbook 食譜 015 - PBX

Q015 可以說說 PBX 交換機模組嗎？

交換機模組是一種設備模組，它提供增強的控制和可設置的組態機制。

pbx_ael Asterisk Extension Logic (AEL) offers a dialplan scripting language that looks like a modern programming language. (有用的)
pbx_config This is the traditional, and most popular, dialplan language for Asterisk. Without this module, Asterisk cannot read extensions.conf. (有用的)
pbx_dundi Performs data lookups on remote Asterisk systems. (有用的)
pbx_loopback Performs something similar to a dialplan include, but in a deprecated manner. (不重要)
pbx_lua Allows creation of a dialplan using the Lua scripting language. (有用的)
pbx_realtime Provides functionality related to the Asterisk Realtime Architecture. (有用的)
pbx_spool Provides outgoing spool support relating to Asterisk call files.(有用的)

Asterisk : The Cookbook 食譜 014 - 撥號計劃功能

Q014: 可以說說撥號計劃功能模組嗎？

撥號計劃功能模組針對撥號計畫應用補充許多功能，像字串處理, 時區同步, ODBC 連接等等

func_aes Encrypts/decrypts an AES string (有用)
func_audiohookinherit Allows calls to be recorded after transfer (有用)
func_base64 Encodes/decodes a base-64 string (有用)
func_blacklist Writes/reads blacklist in astdb (有用)
func_callcompletion Gets/sets call-completion configuration parameters for the channel
func_callerid Gets/sets CallerID (有用)
func_cdr Gets/sets CDR variable (有用)
func_channel Gets/sets channel information (有用)
func_config Includes AST_CONFIG() ; reads variables from config file (有用)
func_connectedline Changes connected-line information on supported handsets
func_curl Uses cURL to obtain data from a URI (有用)
func_cut Slices and dices strings (有用)
func_db Provides astdb functions (有用)
func_devstate Gets state of device (有用)
func_dialgroup Creates a group for simultaneous dialing (有用)
func_dialplan Validates that designated target exists in dialplan (有用)
func_enum Performs ENUM lookup (有用)
func_env Includes FILE() , STAT() , and ENV() ; performs operating system actions (有用)
func_extstate Returns status of a hinted extension (有用)
func_global Gets/sets global variables (有用)
func_groupcount Gets/sets channel count for members of a group (有用)
func_hangupcause Gets/sets hangupcause information from the channel (有用)
func_iconv Converts between character sets (有用)
func_jitterbuffer Includes the JITTERBUFFER() function, which allows you to place a jitterbuffer on a channel. (有用)
func_lock Includes LOCK() , UNLOCK() , and TRYLOCK() ; sets a lock that can (有用)
be used to avoid race conditions in the dialplan func_logic Includes ISNULL() , SET() , EXISTS() , IF() , IFTIME() , and IMPORT() ; performs various logical functions (有用)
func_math Includes MATH() , INC() , and DEC() ; performs mathematical functions (有用)
func_md5 Converts supplied string to an MD5 hash (有用)
func_module Checks to see if supplied module is loaded into memory (有用)
func_odbc Allows dialplan integration with ODBC resources (有用)
func_pitchshift Shifts the pitch of an audio stream (有用)
func_presencestate Gets/sets presence state; this is primarily used by Asterisk integration with Digium phones (有用)
func_rand Returns a random number within a given range (有用)
func_realtime Performs lookups within the Asterisk Realtime Architecture (ARA) (有用)
func_redirecting Provides access to information about where this call was redirected from (有用)
func_sha1 Converts supplied string to an SHA1 hash (有用)
func_shell Performs Linux shell operations and returns results (有用)
func_speex Reduces noise and performs dB gain/loss on an audio stream (有用)
func_sprintf Performs string format functions similar to C function of same name (有用)
func_srv Performs SRV lookups in the dialplan (有用)
func_strings Includes over a dozen string manipulation functions (有用)
func_sysinfo Gets system information such as RAM, swap, load average, etc. (有用)
func_timeout Gets/sets timeouts on channel (有用)
func_uri Converts strings to URI-safe encoding (有用)
func_version Returns Asterisk version information (有用)
func_vmcount Returns count of messages in a voicemail folder for a particular user (有用)
func_volume Sets volume on a channel (有用)

Asterisk : The Cookbook 食譜 013 - 格式解譯器

Q013 : 可以說說格式解譯器模組嗎？

格式解譯器模組完成 Codec 翻譯器的同樣的功能，只是對象不是通道而是檔案。譬如你將一通電話以 GSM 格式記錄下來，在回放時若是該通道非 GSM 格式時就需要格式解譯器模組。

這邊建議不要使用 GSM 格式來儲存而請改採 WAV 格式，主要原因是降低 CPU 負載。

format_g723 G.723: .g723 (不重要)
format_g726 G.726: .g726 (不重要)
format_g729 G.729: .g729 (有用的)
format_gsm RPE-LTP (original GSM codec): .gsm (有用的)
format_h263 H.263—video: .h263 (有用的)
format_h264 H.264—video: .h264 (有用的)
format_ilbc Internet Low Bitrate Codec: .ilbc (不重要)
format_jpeg Graphic file: .jpeg, .jpg (不重要)
format _ogg_vorbis Ogg container: .ogg (有用的)
format_pcm Various Pulse-Coded Modulation formats: .alaw, .al, .alw, .pcm, .ulaw, .ul, .mu, .ulw, .g722, .au (有用的)
format_siren14 G.722.1 Annex C (14 kHz): .siren14
format_siren7 G.722.1 (7 kHz): .siren7
format_sln16 16-bit signed linear: .sln16
format_sln 8-bit signed linear: .sln, .raw (有用的)
format_vox .vox (不重要)
format_wav .wav (有用的)
format_wav_gsm GSM audio in a WAV container: .wav, .wav49 (有用的)

Asterisk : The Cookbook 食譜 012 - Codec 翻譯器

Q012: 可以說說Codec 翻譯器嗎？

Codec 翻譯器讓 Asterisk 有能力轉換通話雙方的音頻編碼。例如有可能來自一個 PRI 線路(使用 G.711)，需要轉換成壓縮的 SIP 輸出(像 G.729)，此時就需要這種 Codec 翻譯器。

Digium 公司有散布某些額外的 Codec 翻譯器模組，像 codec_g729 , codec_silk , codec_siren7 , and codec_siren14 等。這些 Codec 並不是開放授權的，不過大部份也都是可以免費使用，要注意的是 codec_g729 在使用前必須取得授權。可以參考 Digium Site.

codec_adpcm Adaptive Differential Pulse Coded Modulation (ADPCM) codec (不重要)
codec_alaw A-law PCM codec used all over the world (except Canada/USA) on the PSTN (重要)
codec_g729 Does not come with Asterisk due to the fact that it is not a public domain codec, but can be purchased from Digium; a very popular codec if compression is desired (and CPU use is not an issue) (有用的)
codec_a_mu A-law to mu-law direct converter (有用的)
codec_dahdi Utilizes proprietary Digium hardware transcoding card (重要)
codec_g722 Wideband audio codec (有用的)
codec_g726 Flavor of ADPCM (不重要)
codec_gsm Global System for Mobile Communications (GSM) codec Useful
codec_ilbc Internet Low Bitrate Codec (不重要)
codec_lpc10 Linear Predictive Coding vocoder (extremely low bandwidth) (不重要)
codec_resample Resamples between 8-bit and 16-bit signed linear (有用的)
codec_speex Speex codec (有用的)
codec_ulaw Mu-law PCM codec used in Canada/USA on PSTN (重要)

Asterisk : The Cookbook 食譜 011 - 通道驅動

Q011: 可以說說通道驅動嗎？

如果沒有通道驅動的話，Asterisk 就沒有辦法完成通話。每個通道實作支援了某一協定，例如 SIP, ISDN 等。通道模組就像是 Asterisk 核心的中繼器。

chan_agent Provides agent channel for Queue() (有用的)
chan_alsa Provides connection to Advanced Linux Sound Architecture (有用的)
chan_bridge Used internally by the ConfBridge() application; should not be used directly Essential a chan_console Utilizes the portaudio library to provide a cross-platform console channel driver that uses the system sound device (有用的)
chan_dahdi Provides connection to PSTN cards that use DAHDI channel drivers (有用的)
chan_gtalk Provides connection to Google Talk (過期的, 參考 chan_motif)
chan_h323 Provides connection to H.323 endpoints (過期的，參考 chan_ooh323)
chan_iax2 Provides connection to IAX2 endpoints (有用的)
chan_jingle Provides connection to Jingle-enabled endpoints (過期的，參考chan_motif)
chan_local Provides a mechanism to treat a portion of the dialplan as a channel (有用的)
chan_mgcp Media Gateway Control Protocol channel driver (有用的)
chan_misdn Provides connection to mISDN-supported ISDN cards (有限制的)
chan_motif Implements the Jingle protocol, including the ability to connect to Google Talk and Google Voice; introduced in Asterisk 11 (有用的)
chan_multicast_rtp Provides connection to multicast Realtime Transport Protocol (RTP) streams (有用的)
chan_nbs Network Broadcast Sound channel driver (不重要)
chan_oss Open Sound System driver (有用的)
chan_phone Linux telephony interface driver (very old) (不重要)
chan_sip Session Initiation Protocol (SIP) channel driver (重要)
chan_skinny Cisco Skinny Client Control Protocol (SCCP) channel driver (有用的)
chan_unistim Nortel Unistim protocol channel driver (有用的)

Asterisk : The Cookbook 食譜 010 - 通道事件記錄模組 (CEL)

Q010: 可以說說通道事件記錄模組 (CEL)嗎？

通道事件日誌記錄（CEL）針對電話活動報告提供了更為強大的控制。出於同樣的原因，它需要更加仔細的規劃你的撥號方案，而絕不會自動工作。也就是說更複雜了點，而且是被動呼叫。

cel_custom CEL to disk/file (有用的)
cel_manager CEL to AMI (有用的)
cel_odbc CEL to ODBC (有用的)
cel_pgsql CEL to PostgreSQL (有用的)
cel_radius CEL to RADIUS (有用的)
cel_sqlite3_custom CEL to SQLite3 (有用的)
cel_tds CEL to Microsoft SQL or Sybase (有用的)

Asterisk : The Cookbook 食譜 009 通話詳細記錄 (CDR)模組

Q009: 可以說說通話詳細記錄 (CDR)模組嗎？

通話詳細記錄(CDR)可以有很多方法，例如存到檔案、資料庫、或是遠端撥入用戶服務(RADIUS)，或是 syslog 中。

CDR 通常不建議用在複雜的計費系統中，如果你要更多的控制計費及呼叫記錄的話，應該採用通道事件記錄(Channel Event Logging)，主要是因為 CDR 相對簡單夠用，但是在計費系統中又不夠滿足系統端與用戶端的需求。

cdr_adaptive_odbc Allows writing of CDRs through ODBC framework with ability to add custom fields (有用的)
cdr_csv Writes CDRs to disk as a comma-separated values file (有用的)
cdr_custom Writes CDRs to a CSV file, but allows addition of custom fields (有用的)
cdr_manager Outputs CDRs to Asterisk Manager Interface (AMI) (有用的)
cdr_odbc Writes CDRs through ODBC framework (有用的)
cdr_pgsql Writes CDRs to PostgreSQL (有用的)
cdr_radius Writes CDRs to RADIUS (有用的)
cdr_sqlite Writes CDRs to SQLite2 database (過期，請使用 sqlite3_custom)
cdr_sqlite3_custom Writes CDRs to SQLite3 with custom fields (有用的)
cdr_syslog Writes CDRs to syslog (有用的)
cdr_tds Writes CDRs to Microsoft SQL or Sybase (有用的)

訂閱：文章 (Atom)

神奇! 搞大數位娛樂的肚子-狂想空間

2016/02/05

Asterisk : The Cookbook 食譜 035 - a2billing

2016/02/04

Asterisk : The Cookbook 食譜 034 - 輪用辦公桌

Asterisk : The Cookbook 食譜 033 - 資料庫 AstDB

Asterisk : The Cookbook 食譜 032 - 在地通道

Asterisk : The Cookbook 食譜 031 - 巨集 Macros + GoSub

Asterisk : The Cookbook 食譜 030 - 表示法 Expressions

2016/02/03

Asterisk : The Cookbook 食譜 029 - 重要設定檔

Asterisk : The Cookbook 食譜 028 - 撥號計劃的互動 3 Pattern Matching

Asterisk : The Cookbook 食譜 027 - 撥號計劃的互動 2 Dial()

Asterisk : The Cookbook 食譜 026 - 撥號計劃的互動 Interactive Dialplan

Asterisk : The Cookbook 食譜 025 - 撥號計劃 Dialplan

2016/02/02

Asterisk : The Cookbook 食譜 024 - 在 Ubuntu 下的簡易安裝

Asterisk : The Cookbook 食譜 023 - 在 Ubuntu 下的安裝

2016/02/01

Asterisk : The Cookbook 食譜 022 - 其它 Asterisk 專案

Asterisk : The Cookbook 食譜 021 - Asterisk 的版本

Asterisk : The Cookbook 食譜 020 - 支援的硬體

Asterisk : The Cookbook 食譜 019 - 撥號計劃

2016/01/26

Asterisk : The Cookbook 食譜 018 - 檔案結構

Asterisk : The Cookbook 食譜 017 - 加值

Asterisk : The Cookbook 食譜 016 - 資源

Asterisk : The Cookbook 食譜 015 - PBX

Asterisk : The Cookbook 食譜 014 - 撥號計劃功能

Asterisk : The Cookbook 食譜 013 - 格式解譯器

Asterisk : The Cookbook 食譜 012 - Codec 翻譯器

Asterisk : The Cookbook 食譜 011 - 通道驅動

Asterisk : The Cookbook 食譜 010 - 通道事件記錄模組 (CEL)

Asterisk : The Cookbook 食譜 009 通話詳細記錄 (CDR)模組

網誌存檔

我的好友連結

愛我的人