您可以使用 ua 屬性,在使用者介面控制使用者對於功能表項目的存取權。 ua 屬性已附加到組態檔中的每個參數。 有關詳情請參閱以下區段。

Cisco IP 電話韌體提供特定的管理員和使用者帳戶。 這些帳戶提供特定的登入權限。 管理員帳戶名稱為 admin;使用者帳戶名稱為 user。 帳戶名稱無法更改。

管理員帳戶給予服務提供者或增值零售商(VAR) 設定存取電話的權限。 使用者帳戶給予裝置一般使用者有限且可設定的控制權。

可使用密碼對使用者管理員帳戶分別進行保護。 如果服務提供者設定管理員帳戶密碼,當您點撃管理員登入時,系統會提示您。 如果密碼不存在,螢幕會重新整理並顯示管理參數。 管理員帳戶和使用者帳戶均未分配任何預設密碼。 只有管理員帳戶可以分配或更改密碼。

管理員帳戶可以查看和修改所有 Web 設定檔參數,包括可供使用者登入的 Web 參數。 電話系統管理員可使用佈建設定檔進一步限制使用者帳戶可查看和修改的參數。

使用者帳戶使用的組態參數可在電話上設定。 可停用使用者對電話 Web 使用者介面的存取權限。

使用者帳戶可以使用使用者存取 (ua) 屬性控制更改存取權限。 如果未指定 ua 屬性,則現有使用者存取設定會保留。 此屬性不影響管理員帳戶的存取權。

ua 屬性必須具有下列其中的值:

  • na — 無法存取

  • ro — 唯讀

  • rw — 讀取和寫入

  • y — 保留值

    y 值必須與 narorw 一起使用。

下列例子解釋了 ua 屬性。 請注意,ua 屬性更新為 rw 的最後一條線路,並且基站名稱欄位(旅行社 1) 將會保留。 如果不包含 y旅行社 1 會被覆寫:

<flat-profile> <SIP_TOS_DiffServ_Value_1_ ua=”na”/> <Dial_Plan_1_ ua=”ro”/> <Dial_Plan_2_ ua=”rw”/><Station_Name ua=“rw” preserve-value="y">Travel Agent 1</Station_Name></flat-profile>

必須將 ua 選項的值置於雙引號內。

電話韌體提供了用於限制最終用戶訪問某些參數的機制。 韌體提供了管理者帳戶使用者帳戶特定的特權, 帳戶皆可獨立的以密碼保護。

  • 管理者帳戶-允許所有管理伺服器參數的完全存取。

  • 使用者帳戶–允許管理伺服器參數中的小組存取。

如果服務提供者停用存取組態使用狀況,請在進行之前聯絡服務供應商。

1

確保電腦與電話可以通訊。 沒有使用 VPN。

2

在 Web 瀏覽器位址列中輸入電話的 IP 位址。

  • 使用者存取:http://<ip address>
  • 管理員存取:http://<ip address>/admin/advanced
  • 管理員存取:http://<ip address>,按一下管理員登入按一下進階

例如,http://10.64.84.147/admin

3

ヒントが出たらパスワードを入力してください。

基於以下佈建操作,第一次啟動時或恢復原廠設定後,您可以略過電話設定密碼螢幕:

  • DHCP 組態

  • EDOS 組態

  • 在電話 XML 組態檔中設定使用者密碼

設定使用者密碼之後,「設定密碼」螢幕不會顯示。

1

在文本編輯器或 XML 編輯器中編輯電話 cfg.xml 檔案。

2

使用下列選項之一,插入 <User_Password> 標籤。

  • 無密碼 (開始和結束標籤)<User_Password></User_Password>
  • 密碼的值 (4-127 個字元)<User_Password >Abc123</User_Password>
  • 無密碼 (僅適用於開始標籤)<User_Password />
3

將更改儲存到 cfg.xml 檔案。

設定密碼螢幕在第一次啟動時或恢復原廠設定後不顯示。 如果指定了密碼,則在存取電話 Web 介面或電話螢幕功能表時,系統會提示使用者輸入密碼。

您可以將電話設定為允許或封鎖存取電話網頁或電話螢幕上的組態參數。 只要存取權控制參數,您可以:

  • 表示建立設定時,哪些組態參數可供使用者帳戶使用。

  • 啟用或停用使用者對管理 Web 伺服器的存取權。

  • 啟用或停用使用者對電話螢幕功能表的存取權。

  • 為使用者繞過設定密碼螢幕。

  • 限制電話因為線路 1 的重新同步、升級或 SIP 註冊而存取的網際網域網域。

您還可以使用 XML (cfg.xml) 代碼在電話組態檔中設定參數。 如要配置每個參數,請參閱下方的存取權控制參數表格中的字串語法。

1

存取電話管理網頁。

2

點擊語音 > 系統

3

系統組態區段中,根據下列存取權控制參數表格的定義配置參數。

4

點撃提交所有更改以套用更改。

在電話 Web 介面中的語音 > 系統標籤下方,下列表格在系統組態區段中界定了存取權控制參數的功能和使用情況。 表格還界定了電話組態檔 (cfg.xml) 中所新增的字串語法,其中包含用於配置參數的 XML (cfg.xml) 代碼。

表格 1 存取權控制參數

參數名稱

說明和預設值

啟用網站伺服器

啟用或停用對電話 Web 介面的存取權。 將此參數設定為,以允許使用者或管理員存取電話 Web 介面。 否則,將其設定為。 如果設定為,將無法存取電話 Web 介面。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <Enable_Web_Server ua="na">Yes</Enable_Web_Server>
  • 在電話 Web 介面中,設定以允許存取權。

允許的值:是|否

預設值:是。

啟用網路管理員存取權

允許或封鎖對電話管理頁面的存取:

http://<phone_IP>/admin

當設定為時,將無法存取「管理員」網頁。 只有使用者的網頁可存取。


 

如果要在存取被封鎖後再次允許存取管理網頁,則需要從電話重設成出廠預設值。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <Enable_Web_Admin_Access ua="na">Yes</Enable_Web_Admin_Access>
  • 在電話 Web 介面中,將此參數設定為以允許存取。 否則,將其設定為

允許的值:是|否

預設值:是

系統管理員密碼

允許您設定或更改電話管理網頁的存取密碼。

「管理員密碼」參數僅適用於電話管理網頁。

有效密碼必須包含 4 到 127 個字元,字元類型涉及以下四類中的三種:大寫字母、小寫字母、數字和特殊字元。

在您執行電話原廠重設後,密碼設定為空。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:<Admin_Password ua="na">P0ssw0rd_tes89</Admin_Password>

  • 在電話 Web 介面中,輸入管理員存取密碼。

預設值:空

使用者密碼

允許您或電話使用者設定,或更改用於存取電話 Web 介面以及電話螢幕功能表的密碼。

有效密碼必須包含 4 到 127 個字元,字元類型涉及以下四類中的三種:大寫字母、小寫字母、數字和特殊字元。

在您執行電話原廠重設後,密碼設定為空。

在組態檔 (cfg.xml) 中,您可以使用 User_Password 參數繞過在第一次啟動或重設原廠設定時提示的設定密碼螢幕。 更多資訊請見繞過設定密碼螢幕

預設值:空

顯示密碼警告

確定當使用者或管理員密碼為空時,是否顯示「 未提供 密碼」警告。 通常,警告訊息會顯示在電話 問題和診斷功能表 以及電話網頁上。

當同時設定了使用者密碼和管理員密碼時,警告訊息將消失。


 
如果 「啟用 Web 管理員存取 」設置為 「否」,則密碼警告不會顯示在電話螢幕上。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <Display_Password_Warnings ua =“na”>是</Display_Password_Warnings>
  • 在電話 Web 介面中,設定為是 以顯示警告,將設定為 以隱藏警告。

允許的值:是|否

預設值:是

作為管理員,您可以為使用者配置帶有快速撥號和來電代接的 BLF 快捷方式。 BLF 快捷方式允許使用者監視其同事線路。 當快捷方式配置了 BLF 代接和快速撥號時,使用者可以使用 BLF 快捷方式接聽監控線路的通話,並一鍵撥打監控線路。

監控線上的指示燈因配置而異。 有關狀態,請參閱下表。


 
在監控線上同時設定快速撥號和來電代接時,指示燈將顯示為快速撥號圖示。
表 2. 來電代接 BLF 指示燈
標示狀態

適用於 Espresso B 和 C 型號的「來電代接」(空閒狀態)的 BLF。

該線路已配置代接來電,並處於閒置模式。

警報,或

警示 · 已啟用代接

有等候接聽的來電。

如果為 BLF 快捷方式啟用了“來電代接”功能,則使用者可以通過點擊 BLF 快捷方式為其同事接聽該通電話。

如果未啟用來電代接功能,使用者將無法接聽電話。 相反,點擊快捷方式會啟動對受監控線路的呼叫。


 
當您的電話上有進行中的通話或去電時,您無法接聽受監控線路的警示通話。

正在使用

被監控的線路正在使用中。
表 3. 使用快速撥號的 BLF 狀態指示燈
標示狀態描述

快速撥號圖示 BLF 不明狀態

閒置

受監控的線路處於空閒模式。

您可以點選捷徑來撥打快速撥號號碼。

BLF 快速撥號警示圖示

警告

警示 · 已啟用代接

受監控的線路上有通話警示。

如果為 BLF 快捷方式啟用了“來電代接”功能,您可以通過點擊 BLF 快捷方式來接聽同事的通話。

如果未啟用來電代接功能,則無法接聽來電。 相反,點擊快捷方式會啟動對受監控線路的呼叫。


 

當您的電話上有進行中的通話或去電時,您無法接聽受監控線路的警示通話。

表示快速撥號圖示 BLF 使用中

正在使用

受監控的線路正在通話中。

如果您點選捷徑,則會撥打快速撥號號碼。 您將聽到忙碌音或被重新導向至語音信箱,具體取決於同事線路上的配置。

圖示表示 BLF 快速撥號 DND 狀態

請勿打擾

監控的線路設定為勿打擾(DND)。

撥打該線路的電話不會發出警報。

未註冊快速撥號圖示 BLF

未註冊

受監視的線路未註冊。

撥打線路的電話未接通。

如果電話已註冊到 BroadWorks 伺服器,則可以將電話配置為監視整個 BLF 清單。 電話會按順序分配可用的線路鍵以監察 BLF 清單項目,並開始在 BLF 鍵上顯示受監察線路的狀態。

您也可以使用 XML(cfg.xml)設定電話設定檔中的參數。 如要配置每個參數,請參閱下列監察多條使用者線路的參數表格中的字串語法。

開始之前

  • 確保電話已註冊到 BroadWorks 伺服器。

  • 您可以在 BroadWorks 伺服器上為電話使用者設定 BLF 清單。

  • 確保 BLF 鍵上的監察線路並蚸處於不活動模式。

1

存取管理 Web 介面。

2

選擇語音 > 服務員主控台.

3

如下列監察多條使用者線路的參數表格所述,配置 BLF 清單 URIBLF 清單的使用線路鍵BLF 清單BLF 標籤顯示模式

4

按一下提交所有變更

監察多條使用者線路的參數

監察多條使用者線路的參數

在電話 Web 介面中的語音 > 服務員主控台標籤下方的一般區段中,下表介定了 BLF 參數中的功能與使用情況。 它還定義了在電話設定檔中使用 XML(cfg.xml)新增以設定參數的字串語法。

表格 4 監察多條使用者線路的參數

參數

說明和預設值

BLF 清單 URI

您在 BroadWorks 伺服器上為電話使用者設定的忙碌指示燈欄位(BLF)清單的統一資源識別碼(URI)。

僅當電話已註冊到 BroadWorks 伺服器時,此欄位才適用。 BLF 清單是電話可監察其線路的使用者之清單。

必須以 <URI_名稱>@<伺服器> 格式指定 BLF 清單 URI。 指定的 BLF List URI 必須與在 BroadWorks 伺服器上為 List URI:sip 參數設定的值相同。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <BLF_List_URI ua="na">MonitoredUsersList@sipurash22.com</BLF_List_URI>

  • 在電話 Web 介面上,指定在 BroadSoft 伺服器上界定的 BLF 清單。

預設值:空

將線路鍵用於 BLF 清單

控制當對 BLF 清單的監察啟動時,電話是否使用其線路鍵來監察 BLF 清單。

此設定僅在 BLF 清單設定為顯示時有意義。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <Use_Line_Keys_For_BLF_List ua="na">Yes</Use_Line_Keys_For_BLF_List>

  • 在電話 Web 介面上,將此欄位設定為,以使用未註冊的線路監察 BLF 清單項目。 將其設定為,則防止使用線路鍵來監察 BLF 清單項目。

預設值:否

BLF 清單

確定是顯示還是隱藏線路鍵上的 BLF 清單。

如果設定為顯示,電話會依序分配可用的線路鍵來監察 BLF 清單項目。 BLF 清單鍵的標籤顯示受監察使用者的姓名和受監察線路的狀態。

此設定僅在設定了 BLF 清單 URI 時有意義。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <BLF_List ua="rw">Show</BLF_List>

  • 在電話 Web 介面上,將此欄位設定為顯示隱藏,以啟動或停用 BLF 監察功能。

允許的值:顯示|隱藏

預設值:顯示

BLF 標籤顯示模式

指定 BLF 項目在線路鍵上的顯示方式。 選項包括:「姓名 「分機 號碼」及 「兩者」。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <BLF_Label_Display_Mode ua="na">Name</BLF_Label_Display_Mode>

  • 在電話 Web 介面上,從清單中選擇一個選項。

允許的值:名稱|分機|兩者

預設值:名稱

當使用者需要監察同事是否有空處理通話時,您可以在電話線路設定忙線指示燈域。

您可以將忙線指示燈域設定為與快速撥號或來電代接的任何組合來配合使用。 例如,忙碌燈場和快速撥號、忙碌燈場和來電代接,或同時具有快速撥號和來電代接的忙碌燈場。 不過,單獨的快速撥號需要不同的組態。

您也可以使用 XML(cfg.xml)設定電話設定檔中的參數。 如要配置每個參數,請查看下列監察特定線路參數表格中的字串語法。

開始之前

確保用於配置忙線指示燈域的線路鍵不處於不活動模式。

1

存取電話管理網頁。

2

選擇語音 > 電話

3

選擇要設定忙線指示燈域的線路鍵。

4

如下列監察特定線路參數表格所界定,配置分機擴展功能欄位。

5

按一下提交所有變更

監察特定線路的參數

監察特定線路的參數

在電話 Web 介面中的語音 > 電話標籤下方的線路鍵 (n) 區段中,下表界定了忙線指示燈域 (BLF) 參數的功能與使用情況。 它還定義了在電話設定檔中使用 XML(cfg.xml)新增以設定參數的字串語法。

表格 5 監察特定線路的參數

參數

說明和預設值

分機

分配分機號碼给線路鍵或停用線路鍵上的分機功能。

線路鍵的數量因電話型號而異。 使用分機號碼分配時,您可以將線路鍵設定為電話分機。


 
當您需要在禁用直接 PLK 配置功能時為線路鍵分配擴展功能(例如,快速撥號、BLF、來電代接)時,您可以啟用該功能或將擴展參數 設置為禁用

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <Extension_1_ ua="na">1</Extension_1_>

    <Extension_2_ ua="na">2</Extension_2_>

    <Extension_3_ ua="na">3</Extension_3_>

    <Extension_4_ ua="na">4</Extension_4_>

  • 在電話 Web 介面上,將此參數設定為已停用,以監察線路鍵上的另一條線路。

允許的值:已停用|1|2|3|4,允許的值因電話而異。

預設值:n,其中 n 為線路鍵號。

擴展功能

此參數僅在分機參數設定為停用的線路上才起作用。

用於將擴展功能分配给電話上的線路。 支援的功能包括:

  • BLF 和來電代接

    範例:fnc=blf+cp;sub=BLF_List_URI@$PROXY;ext=user_ID@$PROXY

  • BLF 和快速撥號

    範例:fnc=blf+sd;sub=BLF_List_URI@$PROXY;ext=user_ID@$PROXY

  • BLF、快速撥號和來電代接

    範例:fnc=blf+sd+cp;sub=BLF_List_URI@$PROXY;ext=user_ID@$PROXY

其中, user_ID 表示受監控電話的 ID。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <Extended_Function_1_>fnc=blf;sub=BLF_List_URI@$PROXY;ext=user_ID@$PROXY</Extended_Function_1_>

  • 在電話 Web 介面中,使用有效的語法設定參數,以便使用線路監察其他使用者或分機。

預設值:空

您還可以使用 XML (cfg.xml) 代碼在電話組態檔中設定參數。 如要配置每個參數,請參閱下方的鈴聲參數表格中的字串語法。

1

存取電話管理網頁。

2

選擇語音 > 分機(n);當中的 (n) 為電話分機的號碼。

3

通話功能設定區段,從清單中選擇預設鈴聲參數,或選擇不響鈴。

您也可以透過輸入以下格式的字串,在組態檔 (cfg.xml) 中設定此參數:

<Default_Ring_3_ ua="rw">1</Default_Ring_3_>
4

選擇語音 > 電話

5

鈴聲區段,請依照下列鈴聲參數表格所述來設定鈴聲(n) 靜音鈴聲持續時間參數。

6

按一下提交所有變更

鈴聲的參數

在電話網頁的語音 > 電話標籤中,下表說明鈴聲區段中的參數。

表格 6 鈴聲參數

參數

描述

Ring1 到 Ring12

適用於各種鈴聲的鈴聲指令碼。

如要獨特的鈴聲模式,請依照自訂鈴聲模式所述,使用鈴聲指令碼來自訂您的鈴聲。

在電話 XML 組態檔 (cfg.xml) 中輸入以下格式的字串:

<!-- Ringtone --><Ring1 ua="na">n=Sunrise;w=file://Sunrise.rwb;c=1</Ring1><Ring2 ua="na">n=Chirp 1;w=file://chirp1.raw;c=1</Ring2><Ring3 ua="na">n=Chirp 2;w=file://chirp2.raw;c=1</Ring3><Ring4 ua="na">n=Delight;w=file://Delight.rwb;c=1</Ring4><Ring5 ua="na">n=Evolve;w=file://Evolve.rwb;c=1</Ring5><Ring6 ua="na">n=Mellow;w=file://Mellow.rwb;c=1</Ring6><Ring7 ua="na">n=Mischief;w=file://Mischief.rwb;c=1</Ring7><Ring8 ua="na">n=Reflections;w=file://Reflections.rwb;c=1</Ring8><Ring9 ua="na">n=Ringer;w=file://Ringer.rwb;c=1</Ring9><Ring10 ua="na">n=Ascent;w=file://Ascent.rwb;c=1</Ring10><Ring11 ua="na">n=Are you there;w=file://AreYouThereF.raw;c=1</Ring11><Ring12 ua="na">n=Chime;w=file://Chime.raw;c=1</Ring12><Silent_Ring_Duration ua="na">60</Silent_Ring_Duration>

靜音鈴聲持續時間

控制靜音響鈴的持續時間。 例如,如果該參數設定為 20 秒,則電話播放靜音響鈴 20 秒,然後向邀請訊息傳送 480 回應。

在電話 XML 組態檔 (cfg.xml) 中輸入以下格式的字串:

<Silent_Ring_Duration ua="na">60</Silent_Ring_Duration>

您可以使用鈴聲指令碼設定每個鈴聲的特性。 當電話收到 SIP Alert-INFO 訊息且訊息格式正確時,電話便會播放指定的鈴聲。 否則,電話會播放預設鈴聲。

在鈴聲指令碼中,為鈴聲指定名稱,並按以下格式新增指令碼以設定獨特的鈴聲:

n=ring-tone-name;h=hint;w=waveform-id-or-path;c=cadence-id;b=break-time;t=total-time

其中:

n = ring-tone-name 用於標識此鈴聲。 此名稱會顯示在電話的鈴聲功能表上。 可以在入站 INVITE 請求的 SIP Alert-Info 標頭中使用相同的名稱,以通知電話播放相應的鈴聲。 該名稱應僅包含允許在 URL 中使用的字元。

h = hint 用於 SIP Alert-INFO 規則。

w = waveform-id-or-path 是用於此鈴聲中所需波形的索引。 內置的波形包括:

  • 1 = 具有機械鈴的傳統電話

  • 2 = 典型電話響鈴

  • 3 = 經典鈴聲

  • 4 = 寬頻頻率掃頻訊號

c = 是播放指定波形所需韻律的索引。 8 個韻律 (1–8) 在 <韻律 1> 到 <韻律 8> 中定義。 Cadence-id 可以是 0 (如 w=3、4)。 設定 c = 0 表示接通持續時間是鈴聲檔案的自然長度。

b = break-time 指定在兩次鈴聲突發之間斷開的秒數,例如 b=2.5。

t = total-time 指定在超時前播放鈴聲的總秒數。

在電話 XML 組態檔 (cfg.xml) 中輸入以下格式的字串:

<!-- Ringtone --><Ring1 ua="na">n=Sunrise;w=file://Sunrise.rwb;c=1</Ring1><Ring2 ua="na">n=Chirp 1;w=file://chirp1.raw;c=1</Ring2><Ring3 ua="na">n=Chirp 2;w=file://chirp2.raw;c=1</Ring3><Ring4 ua="na">n=Delight;w=file://Delight.rwb;c=1</Ring4><Ring5 ua="na">n=Evolve;w=file://Evolve.rwb;c=1</Ring5><Ring6 ua="na">n=Mellow;w=file://Mellow.rwb;c=1</Ring6><Ring7 ua="na">n=Mischief;w=file://Mischief.rwb;c=1</Ring7><Ring8 ua="na">n=Reflections;w=file://Reflections.rwb;c=1</Ring8><Ring9 ua="na">n=Ringer;w=file://Ringer.rwb;c=1</Ring9><Ring10 ua="na">n=Ascent;w=file://Ascent.rwb;c=1</Ring10><Ring11 ua="na">n=Are you there;w=file://AreYouThereF.raw;c=1</Ring11><Ring12 ua="na">n=Chime;w=file://Chime.raw;c=1</Ring12><Silent_Ring_Duration ua="na">60</Silent_Ring_Duration>

當您在電話上啟用 BroadSoft 的輪用功能時,使用者可以作為訪客登入到電話。 在訪客登出電話之後,使用者將會切換回主機使用者。

您還可以使用 XML (cfg.xml) 代碼在電話組態檔中設定參數。

1

存取電話管理網頁。

2

選擇語音 > 分機 (n) (其中的 [n] 代表了分機號碼)。

3

通話功能設定區段,將啟用 Broadsoft Hoteling 參數設定為

您可以輸入以下格式的字串,在電話組態 XML 檔 (cfg.xml) 中設定此參數:

<Enable_Broadsoft_Hoteling_1_ua="na">Yes</Enable_Broadsoft_Hoteling_1>

選項:是及否

預設值:否

4

使用者在輪用功能訂閱到期中設定使用者可作為訪客登入電話的時間 (以秒為單位)。

您可以輸入以下格式的字串,在電話組態 XML 檔 (cfg.xml) 中設定此參數:

<Hoteling_Subscription_Expires_1_ua="na">3600</Hoteling_Subscription_Expires_1>

有效值:介於 10 至 86400 之間的整數

預設:3600

5

按一下提交所有變更

您必須使用具有上傳指令碼的伺服器來接收使用者從電話傳送的問題報告。

  • 如果 PRT 上傳規則欄位中指定的 URL 有效,使用者會在電話使用者介面上收到說明他們已成功提交問題報告的通知警示。

  • 如果 PRT 上傳規則欄位為空或 URL 無效,則使用者會在電話使用者介面上收到說明數據上傳失敗的通知警示。

電話使用 HTTP/HTTPS POST 機制,其參數與基於 HTTP 表格的上傳類似。 上傳中包含以下參數 (使用多部分 MIME 編碼):

  • devicename (例如:「SEP001122334455」)

  • serialno (例如:「FCH12345ABC」)

  • username (使用者名稱是分機的基站顯示名稱使用者 ID。 首先考慮基站顯示名稱。 如果此欄位空白,則選擇使用者 ID。)

  • prt_file (例如:「probrep-20141021-162840.tar.gz」)

您可以用指定的時間間隔來自動產生 PRT,並可以定義 PRT 檔案名稱。

您還可以使用 XML (cfg.xml) 代碼在電話組態檔中設定參數。 如要配置每個參數,請參閱下方的問題報告工具參數表格中的字串語法。

範例指令檔如下所示。 此指令檔僅供參考。 Cisco 不對客戶伺服器上安裝的上載指令檔提供支援。

<?php // 注意:您可能需要編輯 php.ini 檔以允許更大的 // 大小的檔上傳工作。 修改 upload_max_filesize // 的設定我使用了:upload_max_filesize = 20M // 檢索上傳檔的名稱 $filename = 基本名稱($_FILES['prt_file']['name']);刪除設備名稱、序列號和使用者名(如果存在)周圍的引號 $devicename = $_POST['devicename'];$devicename = 修剪($devicename,“'\”“);$serialno = $_POST['序列號'];$serialno = 修剪($serialno,“'\”“);$username = $_POST[“使用者名”];$username = 修剪($username,“'\”“);檔放置位置 $fullfilename =“/var/prtuploads/”.$filename;如果檔上傳失敗,則返回 500 錯誤和 // 通知使用者重試 if(!move_uploaded_file($_FILES['prt_file']['tmp_name'],$fullfilename)){ header(“HTTP/1.0 500 內部伺服器錯誤”); die(“錯誤:您必須選擇要上傳的檔。”); }?>
1

存取電話管理網頁。

2

選擇語音 > 佈建

3

問題報告工具區段,請依照問題報告工具參數所述來設定欄位。

4

按一下提交所有變更

問題報告工具參數

表格 7 問題報告工具參數

參數

描述

PRT 上傳規則

指定 PRT 上傳指令碼的路徑。

如果 PRT 最長時間PRT 上傳規則欄位為空,電話不會自動產生問題報告,使用者只能手動執行此操作。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <PRT_Upload_Rule ua="na">https://proxy.example.com/prt_upload.php</PRT_Upload_Rule>
  • 在電話網頁上,按以下格式數據路徑:

    https://proxy.example.com/prt_upload.php

    http://proxy.example.com/prt_upload.php

預設值:空

PRT Upload Method

確定用於將 PRT 記錄上傳到遠端伺服器的方法。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <PRT_Upload_Method ua="na">POST</PRT_Upload_Method>
  • 在電話網頁上,選擇 POSTPUT 方法會將記錄上傳到遠端伺服器。

有效值:POST 和 PUT

預設值:POST

PRT 最大計時器

確定電話以多長時間的間隔 (分鐘) 開始自動生成問題報告。

如果 PRT 最長時間PRT 上傳規則欄位為空,電話不會自動產生問題報告,使用者只能手動執行此操作。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <PRT_Max_Timer ua="na">30</PRT_Max_Timer>
  • 在電話網頁上,以分鐘為單位輸入間隔持續時間。

有效值範圍:15 分鐘到 1440 分鐘。

預設值:空

PRT 名稱

為產生的 PRT 檔案定義名稱。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <PRT_Name ua="na">prt-string1-$MACRO</PRT_Name>

    輸入此格式的名稱:

    prt-string1-$MACRO
  • 在電話網頁上,按以下格式輸入名稱:

    prt-string1-$MACRO

預設值:空

PRT HTTP 標頭

PRT 上傳規則中指定 URL 的 HTTP 標頭。

參數值與 PRT HTTP 標頭值相關。

只有設定了兩個參數時,HTTP 標頭才包含在 HTTP 請求中。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <PRT_HTTP_Header ua="na">x-cisco-spark-canary-opts</PRT_HTTP_Header>
  • 在電話網頁上,按以下格式輸入 HTTP 標頭:

    x-cisco-spark-canary-opts

有效值範圍:a-z、A-Z、0-9、下劃線 (_) 和連字符 (-)

預設值:空

PRT HTTP 標頭值

設定指定 HTTP 標頭的值。

參數值與 PRT HTTP 標頭相關。

只有設定了兩個參數時,HTTP 標頭才包含在 HTTP 請求中。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <PRT_HTTP_Header_Value ua="na">always</PRT_HTTP_Header_Value>
  • 在電話網頁上,按以下格式輸入值:

    永遠

有效值範圍:a-z、A-Z、0-9、下劃線 (_)、逗號 (,)、分號 (;)、等於號 (=) 和連字符 (-)


 

除下劃線 (_) 外,首個字元不得是特殊字元。

預設值:空

使用者使用問題報告工具向您提交問題報告。

如果使用 Cisco TAC 疑難排解問題,通常需要來自問題報告工具的記錄以協助解決問題。

若要發佈問題報告,使用者需存取問題報告工具,提供問題發生的日期與時間以及問題說明。 您需要從電話管理網頁下載問題報告。

1

存取電話管理網頁。

2

選擇資訊 > 偵錯資訊 > 裝置記錄

3

問題報告區域,點撃要下載的問題報告檔案。

4

將檔案儲存到本機系統,然後開啟檔案以存取問題報告記錄。

您可以使用《技術報告 069 號通訊協定》(TR 069) 中定義的通訊協定和標準來管理電話。 TR-069 說明了管理所有電話和大型部署中的其他客戶部署裝置 (CPE) 的公共平台。 該平台與電話類型和製造商無關。

TR-069 是一種基於 SOAP/HTTP 的雙向通訊協定,支援 CPE 和自動設定伺服器 (ACS) 之間的通訊。

您還可以使用 XML (cfg.xml) 代碼在電話組態檔中設定參數。 如要配置每個參數,請參閱下方的TR-069 組態參數表格中的字串語法。

1

存取電話管理網頁。

2

選擇語音 > TR-069

3

如下列 TR-069 組態參數表格所述來設定欄位。

4

按一下提交所有變更

TR-069 組態參數

TR-069 組態參數

在電話 Web 介面中的語音 > TR-069標籤下方,下表界定了 TR-069 參數的功能與使用情況。 表格還界定了電話組態檔中所新增的字串語法,其中包含用於配置參數的 XML (cfg.xml) 代碼。

表格 8 TR-069 組態參數

參數

描述

啟用 TR-069

啟用或停用 TR-069 功能的設定。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <Enable_TR-069 ua="na">No</Enable_TR-069>
  • 在電話網頁上,選擇以啟用此功能,選擇以停用。

有效值:是|否

預設值:否

ACS URL

使用 CPE WAN 管理通訊協定的 ACS 之 URL。 此參數必須為有效的 HTTP 或 HTTPS URL。 當使用 SSL 或 TLS 時,CPE 使用此 URL 的主機部分驗證 ACS 憑證。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <ACS_URL ua="na">https://acs.url.com</ACS_URL>
  • 在電話網頁上,輸入 ACS 的有效 HTTP 或 HTTPS URL。

預設值:空

ACS 使用者名稱

當 ACS 使用 CPE WAN 管理通訊協定時,此使用者名稱會用於驗證連接到 ACS 的 CPE。 此使用者名稱僅用於以 HTTP 為基礎的 CPE 驗證。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <ACS_Username ua="na">acs username</ACS_Username>
  • 在電話網頁上,請就以 HTTPS 為基礎的 CPE 驗證輸入有效的使用者名稱。

預設值:空

ACS 密碼

用於存取特定使用者 ACS 的密碼。 此密碼僅用於以 HTTP 為基礎的 CPE 驗證。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <ACS_Password ua="na"/>
  • 在電話網頁上,請就以 HTTPS 為基礎的 CPE 驗證輸入有效的密碼。

預設值:空

使用中的 ACS URL

目前正在使用的 ACS URL。 這是唯讀欄位。

連接請求 URL

這是唯讀欄位,顯示向 CPE 發送連接請求的 ACS 的 URL。

連線請求使用者名稱

此使用者名稱用於驗證向 CPE 發送連接請求的 ACS。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <Connection_Request_Username ua="na"/>
  • 在電話網頁上,輸入用於驗證 ACS 的有效使用者名稱。

連線請求密碼

此密碼用於驗證向 CPE 發送連接請求的 ACS。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <Connection_Request_Password ua="na"/>
  • 在電話網頁上,輸入用於驗證 ACS 的有效密碼。

預設值:空

定期非正式間隔

當「定期通知啟動」設定為「是」時,而 CPE 嘗試連接至 ACS 期間的間隔秒數。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <Periodic_Inform_Interval ua="na">20</Periodic_Inform_Interval>
  • 在電話網頁上,輸入有效的持續時間 (以秒為單位)。

預設值:20

啟用週期通知

啟用或停用 CPE 連接請求的設定。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <Periodic_Inform_Enable ua="na">Yes</Periodic_Inform_Enable>
  • 在電話網頁上,選擇以啟用此功能,選擇以停用。

有效值:是|否

預設值:是

TR-069 的可追溯性

啟用或停用 TR-069 事務記錄的設定。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <TR-069_Traceability ua="na">Yes</TR-069_Traceability>
  • 在電話網頁上,選擇以啟用此功能,選擇以停用。

有效值:是|否

預設值:否

CWMP V1.2 支援

啟用或停用 CPE WAN 管理通訊協定 (CWMP) 支援的設定。 如果設定為停用,電話便不向 ACS 傳送任何通知訊息,也不接受 ACS 傳送的任何連接請求。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <CWMP_V1.2_Support ua="na">Yes</CWMP_V1.2_Support>
  • 在電話網頁上,選擇以啟用此功能,選擇以停用。

有效值:是|否

預設值:是

TR-069 VoiceObject 初始化

此設定用於修改語音對象。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <TR-069_VoiceObject_Init ua="na">Yes</TR-069_VoiceObject_Init>
  • 在電話網頁上,選擇會將所有語音對象初始化為原廠預設值,也可以選擇 保持目前的值。

有效值:是|否

預設值:是

TR-069 DHCPOption 初始化

此設定用於修改 DHCP 設定。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <TR-069_DHCPOption_Init ua="na">Yes</TR-069_DHCPOption_Init>
  • 在電話網頁上,選擇會從 ACS 初始化 DHCP 設定,也可以選擇保持目前的 DHCP 設定。

有效值:是|否

預設值:是

備份 ACS URL

使用 CPE WAN 管理通訊協定的 ACS 的備份 URL。 此參數必須為有效的 HTTP 或 HTTPS URL。 當使用 SSL 或 TLS 時,CPE 使用此 URL 的主機部分驗證 ACS 憑證。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <BACKUP_ACS_URL ua="na">https://acs.url.com</BACKUP_ACS_URL>
  • 在電話網頁上,輸入使用 CPE WAN 管理通訊協定的有效 URL。

預設值:空

備份 ACS 使用者

當 ACS 使用 CPE WAN 管理通訊協定時,此備份使用者名稱會用於驗證連接到 ACS 的 CPE。 此使用者名稱僅用於以 HTTP 為基礎的 CPE 驗證。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <BACKUP_ACS_User ua="na">backup username</BACKUP_ACS_User>
  • 當 ACS 使用 CPE WAN 管理通訊協定時,在電話網頁上,輸入有效使用者名稱向 ACS 驗證 CPE。

預設值:空

備份 ACS 密碼

用於存取特定使用者 ACS 的備份密碼。 此密碼僅用於以 HTTP 為基礎的 CPE 驗證。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <BACKUP_ACS_Password ua="na"/>
  • 當 ACS 使用 CPE WAN 管理通訊協定時,在電話網頁上,輸入有效密碼向 ACS 驗證 CPE。

預設值:空


 

如果未設定上述參數,您也可以透過 DHCP 選項 60、43 和 125 來獲取這些參數。

當您在使用者電話上啟用 TR-069 時,即可在電話 Web 介面查看 TR-069 參數的狀態。

1

存取電話管理網頁。

2

選擇資訊 > 狀態 > TR-069 狀態

您可以設定分機,以僅接受安全通話。 如果分機設定為僅接受安全通話,則分機發出的任何通話都將是安全的。

您還可以使用 XML (cfg.xml) 代碼在電話組態檔中設定參數。

開始之前

使用 TLS 的 SIP 傳輸可以在電話網頁上靜態設定,也可以使用 DNS NAPTR 記錄中的訊息自動設定。 如果將電話分機的 SIP 傳輸參數設定為 TLS,則電話僅允許 SRTP。 如果 SIP 傳輸參數設定為 AUTO,電話將執行 DNS 查詢以獲取傳輸方法。

1

存取電話管理網頁。

2

選擇語音 > 電話

3

附加服務區段,將安全通話服務設定為

您可以輸入以下格式的字串,在電話組態 XML 檔 (cfg.xml) 中設定此參數:

<Secure_Call_Serv ua="na">是</Secure_Call_Serv>
4

選擇語音 > 分機(n)

5

通話功能設定區段,請將安全通話選項設定為可選必需嚴格

您可以輸入以下格式的字串,在電話組態 XML 檔 (cfg.xml) 中設定此參數:

<Secure_Call_Option_1_ ua="na">Optional</Secure_Call_Option_1_>

選項:「可選」、「必需」和「嚴格」

  • 「可選」 - 保留電話的目前安全通話選項。

  • 「必需」-拒絕來自其他電話的不安全通話。

  • 「限制」 - 僅在 SIP 傳輸設定為 TLS 時才允許 SRTP。 僅在 SIP 傳輸為 UDP/TCP 時才允許 RTP。

預設值:可選

6

按一下提交所有變更

在預設情況下,當有未讀語音留言時,話筒 LED 會閃爍。 您可以將電話配置,在未接來電時讓話筒的 LED 閃爍。

1

存取電話管理網頁。

2

選擇語音 > 使用者

3

附加服務區段中,請針對話筒 LED 警示 參數選擇語音郵件、未接來電

您可以輸入以下格式的字串,在電話組態 XML 檔 (cfg.xml) 中設定此參數:

<Handset_LED_Alert ua="rw">Voicemail,Missed Call</Handset_LED_Alert>

選項:「語音郵件」和「語音郵件、未接來電」

預設值:語音郵件

4

按一下提交所有變更

電話會一次支援線路上的多個通話狀態。 您可以配置一條可一次處理允許通話數量的線路。 當一個通話處於活動狀態時,其他通話可以保持或等待接聽。

1

存取電話管理網頁。

2

選擇語音 > 電話

3

其他線路鍵設定區段,請針對每條線路的通話狀態 參數指定允許加入每條線路的通話數量。

您也可以透過輸入以下格式的字串,在組態檔 (cfg.xml) 中設定此參數:

<Call_Appearances_Per_Line ua="na">6</Call_Appearances_Per_Line>

允許的值範圍從 2 到 10。預設值為 2。

4

按一下提交所有變更

對於 SIP 訊息,您可以設定要使用的每個分機:

  • 特定通訊協定

  • 電話自動選擇的通訊協定

當您設定自動選擇時,電話會根據 DNS 伺服器上的名稱頒發機構指針 (NAPTR) 記錄確定傳輸通訊協定。 電話使用記錄中優先級別最高的通訊協定。

您還可以使用 XML (cfg.xml) 代碼在電話組態檔中設定參數。

1

存取電話管理網頁。

2

選擇語音 > 分機 (n),其中的 n 代表了分機號碼。

3

SIP 設定區段,設定 SIP 傳輸參數,為 SIP 訊息選擇傳輸通訊協定。

您可以輸入以下格式的字串,在電話組態 XML 檔案 (cfg.xml) 中設定此參數:

<SIP_Transport_n_ ua="na">UDP</SIP_Transport_n_>

其中 n 是分機號碼。

選項:UDP、TCP、TLS 和 Auto

自動允許電話根據 DNS 伺服器上的 NAPTR 記錄自動選擇適當的通訊協定。

預設值:UDP

4

按一下提交所有變更

您可以停用電話從非代理伺服器接收傳入 SIP 訊息的功能。 當您啟用此功能時,電話只接受來自以下各項的 SIP 訊息:

  • 代理伺服器

  • 輸出代理伺服器

  • 備用代理伺服器

  • 備用輸出代理伺服器

  • 來自代理伺服器和非代理伺服器的 IN-Dialog 訊息。 例如:「通話作業階段」對話框和「訂閱」對話框

您還可以使用 XML (cfg.xml) 代碼在電話組態檔中設定參數。

開始之前

1

存取電話管理網頁。

2

選擇語音 > 系統

3

系統組態區段,將封鎖非代理 SIP 設定為,以封鎖除對話訊息以外的任何輸入非代理 SIP 訊息。 如果您選擇,則電話不會封鎖任何傳入非代理 SIP 訊息。

對於使用 TCP 或 TLS 傳輸 SIP 訊息的電話,將封鎖非代理 SIP 設定為。 預設封鎖透過 TCP 或 TLS 傳輸的非代理 SIP 訊息。

您可以輸入以下格式的字串,在電話組態 XML 檔 (cfg.xml) 中設定此參數:

<Auto_Answer_Page ua="na">Yes</Auto_Answer_Page>

選項:是及否

預設值:否

4

按一下提交所有變更

SIP 訊息中的使用者隱私標頭設定來自受信任的網路之使用者隱私需求。

您可以為每個線路分機設定使用者隱私標頭值。

1

存取電話管理網頁。

2

選擇語音 > 分機

3

SIP 設定區段,設定私密標題參數以在受信任網路的 SIP 訊息中設定使用者隱私。

您可以輸入以下格式的字串,在電話組態 XML 檔 (cfg.xml) 中設定此參數:

<Privacy_Header_2_ ua="na">header</Privacy_Header_2_>

選項:

  • 預設已停用。

  • 「無」—使用者請求隱私服務不對此 SIP 訊息應用隱私功能。

  • 「標頭」—使用者需要隱私服務來遮蓋無法清除標識訊息的標頭。

  • 「階段作業」—使用者請求隱私服務為作業階段提供匿名性。

  • 「使用者」—使用者請求僅透過中間人的隱私級別。

  • 「id」—使用者請求系統替換不顯示 IP 位址或主機名稱的 id。

預設:已停用

4

按一下提交所有變更

您可以決定是否在去電 SIP 訊息中包含 P-Early-Media 標頭。 P-Early-Media 標頭中包含早期媒體流的狀態。 如果狀態指示網路正在封鎖早期媒體資料流,則電話將播放本機回電聲。 否則,電話會在等待通話接通時播放早期媒體。

您還可以使用 XML (cfg.xml) 代碼在電話組態檔中設定參數。

1

存取電話管理網頁。

2

選擇語音 > 分機 (n)

3

SIP 設定區段,將 P-Early-Media 支援設定為 ,以控制是否在去電的 SIP 訊息中包含 P-Early-Media 標頭。

您可以輸入以下格式的字串,在電話組態 XML 檔 (cfg.xml) 中設定此參數:

<P-Early-Media_Support_1_ ua="na">No</P-Early-Media_Support_1_>

選項:是及否

預設值:否

4

按一下提交所有變更

您可以讓電話在作業階段啟始通訊協定 (SIP) 訊息 (BYE 和 re‑INVITE 訊息) 中傳送通話結束統計訊息。 當通話終止或處於保留狀態時,電話會向通話的另一方傳送通話統計資料。 統計數據包括:

  • 發送或接收的即時傳輸通訊協定 (RTP) 封包

  • 發送或接收的總字節數

  • 遺失的封包總數

  • 延遲抖動

  • 往返延遲

  • 通話持續時間

通話統計資料作為標頭發送到 SIP BYE 訊息和 SIP BYE 回應訊息(200 OK 並在保留期間 re-INVITE)。 對於音訊作業階段,標頭為 RTP-RxStatRTP-TxStat。 對於視訊階段作業,標頭為 RTP-VideoRxStatRTP-VideoTxStat

SIP BYE 訊息中通話統計資料的範例:

Rtp-Rxstat: Dur=13,Pkt=408,Oct=97680,LatePkt=8,LostPkt=0,AvgJit=0,VQMetrics="CCR=0.0017;ICR=0.0000;ICRmx=0.0077;CS=2;SCS=0;VoRxCodec=PCMU;CID=4;VoPktSizeMs=30;VoPktLost=0;VoPktDis=1;VoOneWayDelayMs=281;maxJitter=12;MOScq=4.21;MOSlq=3.52;network=ethernet;hwType=CP-8865;rtpBitrate=60110;rtcpBitrate=0"
Rtp-Txstat: Dur=13,Pkt=417,Oct=100080,tvqMetrics="TxCodec=PCMU;rtpbitrate=61587;rtcpbitrate=0
Rtp-Videorxstat: Dur=12;pkt=5172;oct=3476480;lostpkt=5;avgjit=17;rtt=0;ciscorxvm="RxCodec=H264 BP0;RxBw=2339;RxReso=1280x720;RxFrameRate=31;RxFramesLost=5;rtpBitRate=2317653;rtcpBitrate=0"
Rtp-Videotxstat: Dur=12;pkt=5303;oct=3567031;ciscotxvm="TxCodec=H264 BP0;TxBw=2331;TxReso=1280x720;TxFrameRate=31;rtpBitrate=2378020;rtcpBitrate=0"

有關通話統計資料中的屬性說明,請見下表 SIP 訊息中通話統計資料的屬性

您也可以在電話組態檔中使用通話統計資料參數來啟用此功能。

<Call_Statistics ua="na">Yes</Call_Statistics>
1

存取電話管理網頁。

2

選擇語音 > SIP

3

RTP 參數區段,將通話統計資料欄位設定為,以便電話在 SIP BYE 和 re‑INVITE 訊息中傳送通話統計資料。

您也可以透過輸入以下格式的字串,在組態檔 (cfg.xml) 中設定此參數:

<Call_Statistics ua="na">Yes</Call_Statistics>

允許的值包括:是|否。 預設值為「否」。

4

按一下提交所有變更

SIP 訊息中通話統計資料的屬性

表格 9 音訊:RTP-RxStat 有效負載

屬性

描述

必要

持續時間

媒體作業階段/通話的持續時間

封包

已接收的 RTP 封包數量

十月

已接收的 RTP 封包八位組數量

LatePkt

已接收並因在緩衝視窗外而被丟棄的 RTP 封包數量

LostPkt

遺失的 RTP 封包數

AvgJit

作業階段持續期間的平均抖動

VoRxCodec

已協商的串流/作業階段編解碼器

VoPktSizeMs

以毫秒為單位的封包大小。

maxJitter

偵測到的最大抖動

VoOneWayDelayMs

延遲/單向延遲

MOScq

作業階段的對話品質平均意見得分,請參見 RFC https://tools.ietf.org/html/rfc3611

maxBurstPktLost

遺失的連續封包最大數量

avgBurstPktLost

突發遺失的連續封包平均數量。 此數字可配合總遺失量使用,以比較遺失對通話品質的影響。

networkType

裝置所在網路的類型 (如果可能)。

hwType

正在執行作業階段/媒體的硬體用戶端。 與軟用戶端更相關,但對於硬體電話仍然有用。 例如,型號 CP-8865。

表格 10 音訊:RTP-TxStat 有效負載

屬性

描述

必要

持續時間

作業階段持續時間

封包

已傳輸的 RTP 封包數量

十月

已傳輸的 RTP 封包八位組數量

TxCodec

傳輸編解碼器

rtpBitRate

RTP 傳輸位元率總計 (位元/秒)

rctpBitRate

RCTP 傳輸位元率總計 (位元/秒)

表格 11 視訊:RTP-VideoRxStat 有效負載

屬性

描述

必要

持續時間

作業階段持續秒數

封包

已接收的封包數量

十月

已接收的八位組數量

LostPkt

遺失的封包數

AvgJit

作業階段持續期間的平均抖動

RTT

端到端往返時間

CiscoRxVm.RxCodec

用於已接收視訊串流的視訊編解碼器

CiscoRxVm.RxBw

已接收視訊串流的協商頻寬

CiscoRxVm.RxReso

已接收視訊串流的解析度

CiscoRxVm.RxFrameRate

已接收視訊串流的影格率

CiscoRxVm.RxFrameLost

已接收視訊串流的遺失訊框

CiscoRxVm.rtpBitRate

RTP 位元率 (以秒為單位,包括任何 FEC、重傳等)。 用於估計頻寬使用情况 (位元/秒)。

CiscoRxVm.rtcpBitRate

RTCP 位元率 (以秒為單位,包括任何 FEC、重傳等)。 用於估計頻寬使用情况 (位元/秒)。

表格 12 視訊:RTP-VideoTxStat 有效負載

屬性

描述

必要

持續時間

作業階段持續秒數

封包

已傳輸的封包數量

十月

已傳輸的八位組數量

CiscoTxVm.TxCodec

用於已傳輸視訊串流的視訊編解碼器

CiscoTxVm.TxBw

傳輸的視訊串流的協商頻寬

CiscoTxVm.TxReso

已傳輸視訊串流的解析度

CiscoTxVm.TxFrameRate

已傳輸視訊串流的影格率速率

CiscoRxVm.rtpBitRate

RTP 位元率 (以秒為單位,包括任何 FEC、重傳等)。 用於估計頻寬使用情况 (位元/秒)。

CiscoTxVm.rtcpBitRate

RTCP 位元率 (以秒為單位,包括任何 FEC、重傳等)。 用於估計頻寬使用情况 (位元/秒)。

電話支援階段作業標識符。 此功能允許在符合 RFC 7989 的 IP 多媒體通訊系統中端到端跟蹤 SIP 階段作業。為了支援階段作業標識符,在 SIP 請求和回應訊息中加入了 Session-ID 標頭。

「階段作業標識符」指標識符的值,而「Session-ID」是指用於傳遞標識符的標頭欄位。

  • 如果使用者發起通話,傳送 SIP INVITE 訊息時,電話將產生本地 UUID。

  • 當 UAS 收到 SIP-INVITE 時,電話將使用傳入訊息拾取本機 UUID、將其追加到接收的 Session-ID 標頭並在回應中傳送標頭。

  • 在特定作業階段的所有 SIP 訊息中保留相同的 UUID。

  • 電話會在使用其他功能 (例如會議或轉接) 期間保留相同的本地 UUID。

  • 此標頭在 REGISTER 方法中實現,所有 REGISTER 訊息的本地 UUID 仍保持不變,直到電話無法 REGISTER 為止。

Session-ID 包含參與通話的每個使用者代理的通用唯一標識符 (UUID)。 每個通話都包含兩個 UUID:本地 UUID 和遠端 UUID。 本地 UUID 是從原始使用者代理產生的 UUID,而遠端 UUID 是從終止使用者代理產生的。 UUID 值以小寫十六進制字元的字串形式表示,其中 UUID 的最有效八位組排在最前面。 作業階段標識符由 32 個字元組成,並且在整個作業階段中保持不變。

作業階段 ID 格式

組件將實現 Session-ID,這已經成為全局作業階段 ID。

電話在 http 標頭中傳遞的目前作業階段 ID 範例 (為清楚起見,僅包括破折號) 是 00000000-0000-0000-0000-5ca48a65079a。

作業階段 ID 格式:UUUUUUUUSSSS5000y000DDDDDDDDDDDD,其中

UUUUUUUU - 為作業階段隨機產生的唯一 ID [0-9a-f-f]。 產生的新作業階段 ID 範例:

  • 提起話筒

  • 輸入啟動碼以完成首個 SIP 首次註冊 (加入流程)

SSSS - 產生作業階段的來源。 例如,如果源類型為「Cisco MPP」,則來源值 (SSSS) 可以是「0100」。

Y - 8、9、A 或 B 中的任何值,應符合 UUID v5 RFC。

DDDDDDDDDDDD-電話的 MAC 位址。

SIP 訊息中的作業階段 ID 範例

通話中對話訊息(例如 INVITE/ACK/CANCEL/BYE/UPDATE/INFO/REFER 及其回應) 以及通話外訊息 (基本上是 REGISTER) 都支援此標頭。

請求線路:INVITE sip:901@10.89.107.37:5060 SIP/2.0 Session-ID: 298da61300105000a00000ebd5cbd5c1;remote=00000000000000000000000000000000

狀態列:SIP/2.0 100 正在嘗試會話 ID:fbaa810a00105000a00000ebd5cc118b;遠端=298DA61300105000a00000ebd5cbd5c1

狀態線路:SIP/2.0 180 Ringing Session-ID: fbaa810a00105000a00000ebd5cc118b;remote=298da61300105000a00000ebd5cbd5c1

狀態線路:SIP/2.0 200 OK Session-ID: fbaa810a00105000a00000ebd5cc118b;remote=298da61300105000a00000ebd5cbd5c1

請求線路:ACK sip:901@10.89.107.37:5060 SIP/2.0 Session-ID: 298da61300105000a00000ebd5cbd5c1;remote=fbaa810a00105000a00000ebd5cc118b

請求線路:BYE sip:901@10.89.107.37:5060 SIP/2.0 Session-ID: 298da61300105000a00000ebd5cbd5c1;remote=fbaa810a00105000a00000ebd5cc118b

狀態線路:SIP/2.0 200 OK Session-ID: fbaa810a00105000a00000ebd5cc118b;remote=298da61300105000a00000ebd5cbd5c1

您可以啟用 SIP 作業階段 ID 以克服對現有通話標識符的限制,並允許對 SIP 作業階段進行端到端跟蹤。

1

存取電話管理網頁。

2

選擇語音 > 分機(n)

3

轉至 SIP 設定區段。

4

SIP 階段作薰 ID 支援設定為

您可以輸入以下格式的字串,在電話組態 XML 檔 (cfg.xml) 中設定此參數:

<SIP_SessionID_Support_1_ ua="na">Yes</SIP_SessionID_Support_1_>
5

按一下提交所有變更

您可以在電話管理網頁上配置設定,以啟用電話和伺服器之間的切勿打擾 (DND) 及通話轉接狀態同步。

有兩種方法可以同步功能狀態:

  • 功能鍵同步 (FKS)

  • XSI 同步

FKS 使用 SIP 訊息來傳達功能狀態。 XSI 同步使用 HTTP 訊息。 如果同時啟用 FKS 和 XSI 同步,則 FKS 優先於 XSI 同步。 請參閱下表,了解 FKS 如何與 XSI 同步交互。

表格 13 在 FKS 和 XSI 同步之間互動

功能鍵同步

XSI DND 已啟用

XSI CFWD 已啟用

請勿打擾模式同步

CFWD 同步

是 (SIP)

是 (SIP)

是 (SIP)

是 (SIP)

是 (SIP)

是 (SIP)

是 (HTTP)

是 (HTTP)

是 (HTTP)

是 (HTTP)

如果您啟用功能鍵同步 (FKS),伺服器上的通話轉接和切勿打擾 (DND) 設定將同步到電話。 在電話上進行的 DND 和通話轉接設定更改也會同步到伺服器。

在線路啟用 FKS 時,線路從伺服器獲取 DND 和來電轉接設定,並且不會與語音 > 使用者標籤上的設定進行同步。

1

存取電話管理網頁。

2

選擇語音 > 分機 (n) (其中的 [n] 代表了分機號碼)。

3

通話功能設定區段,將 功能鍵同步欄位設定為

4

按一下提交所有變更

啟用通話轉接同步後,伺服器上與通話轉接相關的設定將同步到電話。 在電話上進行的通話轉接設定更改也會同步到伺服器。

開始之前

  • 語音 > 分機 (n)標籤上,配置 XSI 主機伺服器和相應憑證。

    • 當使用登入憑證進行 XSI 伺服器驗證時,在 XSI 線路服務區段輸入 XSI 主機伺服器登入使用者 ID登入密碼

    • 使用 SIP 憑證進行 XSI 伺服器驗證時,在 XSI 線路服務區段輸入 XSI 主機伺服器登入使用者 ID,在訂閱方訊息區段輸入驗證 ID密碼

  • 透過語音 > 分機 (n)通話功能設定區段,停用功能鍵同步 (FKS)。

1

存取電話管理網頁。

2

選擇語音 > 分機 (n) (其中的 [n] 代表了分機號碼)。

3

XSI 線路服務區段,將啟用 CFWD 參數設定為

您可以輸入以下格式的字串,在電話組態 XML 檔 (cfg.xml) 中設定此參數:

<CFWD_Enable_1_ ua="na">Yes</CFWD_Enable_1_>

選項:是及否

預設值:否

4

按一下提交所有變更

如果啟用切勿打擾 (DND) 同步,伺服器上的 DND 設定將同步到電話。 在電話上進行的 DND 設定更改也會同步到伺服器。

開始之前

  • 語音 > 分機 (n)標籤上,配置 XSI 主機伺服器和相應憑證。

    • 當使用登入憑證進行 XSI 伺服器驗證時,在 XSI 線路服務區段輸入 XSI 主機伺服器登入使用者 ID登入密碼

    • 使用 SIP 憑證進行 XSI 伺服器驗證時,在 XSI 線路服務區段輸入 XSI 主機伺服器登入使用者 ID,在訂閱方訊息區段輸入驗證 ID密碼

  • 透過語音 > 分機 (n)通話功能設定區段,停用功能鍵同步 (FKS)。

1

選擇語音 > 分機 (n) (其中的 [n] 代表了分機號碼)。

2

XSI 線路服務區段,將啟用 DND 參數設定為

您可以輸入以下格式的字串,在電話組態 XML 檔 (cfg.xml) 中設定此參數:

<DND_Enable_1_ ua="na">Yes</DND_Enable_1_>

選項:是及否

預設值:否

3

按一下提交所有變更

您可以將電話上的封鎖來電者 ID 狀態與 BroadWorks XSI 伺服器上的線路 ID 封鎖狀態同步。 當您啟用同步後,使用者在封鎖來電者 ID 設定中進行的更改也會更改 BroadWorks 伺服器設定。

您還可以使用 XML (cfg.xml) 代碼在電話組態檔中設定參數。

1

存取電話管理網頁。

2

選擇語音 > 分機(n)

3

XSI 線路服務區段,設定封鎖 CID 啟用參數。 選擇可使用 XSI 介面允許同步封鎖來電者 ID 狀態與伺服器。 選擇將使用電話的本地封鎖來電者 ID 設定。

您可以輸入以下格式的字串,在電話組態 XML 檔 (cfg.xml) 中設定此參數:

<Block_CID_Enable_1_ ua="na">No</Block_CID_Enable_1_>

選項:是及否

預設值:否

4

按一下提交所有變更

您可以在有限的頻寬條件下確定語音或視訊數據的優先級。

您需要在電話的每條線路上單獨設定優先級。

您可以為不同的流量區域設定不同的優先級。 例如,您可以透過在內部和外部線路上設定不同的設定來為內部和外部流量設定不同的優先級。 為進行有效的流量管理,請在群組中的所有電話線路上指定相同的設定。

封包的服務類型 (ToS) 欄位確定封包在數據流量中的優先級。 您可以透過為每條電話線路指定語音和視訊封包 ToS 欄位的相應值來設定所需的優先級。

對於語音數據,電話應用透過 LLDP 接收的 ToS 值。 沒有透過 LLDP 提供的 ToS 值時,電話會應用您為語音封包指定的值。

對於視訊數據,電話會一直套用您為視訊封包所指定的 ToS 值。

預設值語音優先於視訊。

您還可以使用 XML (cfg.xml) 代碼在電話組態檔中設定參數。 如要配置每個參數,請查看下列優先考慮語音和視訊數據的參數表格的字串語法。

1

存取電話管理網頁。

2

選擇語音 > 分機 (n),其中的 n 代表了分機號碼。

3

網路設定區段中,請按照下列優先考慮語音和視訊數據的參數表格所述來設定參數值。

4

按一下提交所有變更

優先考慮語音和視訊數據的參數

在電話 Web 介面的語音 > 分機(n)標籤下方,下表在網路設定區段中界定了「配置語音和視訊優先級」參數的功能與使用情況。 表格還界定了電話組態檔中所新增的字串語法,其中包含用於配置參數的 XML (cfg.xml) 代碼。

表格 14 將作用中通話移動到位置的參數

參數

描述

SIP TOS/DiffServ 值

包含 SIP 訊息的 UDP IP 封包中的服務時間 (ToS)/區分服務 (DiffServ) 欄位值。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <SIP_TOS_DiffServ_Value_1_ ua="na">0x68</SIP_TOS_DiffServ_Value_1_>
  • 在電話網頁上,輸入包含 SIP 訊息的 UDP IP 封包中的欄位值。

預設:0x68

RTP ToS/DiffServ 值

語音封包 ToS 欄位的值。

設定數據流量中語音封包的優先級。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <RTP_TOS_DiffServ_Value_1_ ua="na">0xb8</RTP_TOS_DiffServ_Value_1_>
  • 在電話網頁上,輸入 ToS 欄位的值。

預設值:0xb8

視訊 RTP ToS/DiffServ 值

視訊封包 ToS 欄位的值。

設定數據流量中視訊封包的優先級。

請執行下列一項操作:

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <Video_RTP_TOS_DiffServ_Value_1_ ua="na">0x80</Video_RTP_TOS_DiffServ_Value_1_>
  • 在電話網頁上,為視訊封包的 ToS 欄位輸入有效的值。 .

預設值:

您可以為電話設定遠端 SDK。 遠端 SDK 提供基於 WebSocket 的通訊協定,可透過該通訊協定控制電話。

開始之前

WebSocket 伺服器的執行位址和連接埠必須可從電話存取。

1

選擇語音 > 電話

2

轉至 WebSocket API區段。

3

如下列 WebSocket API 參數所述,設定控制伺服器 URL允許 API 兩個欄位。

4

按一下提交所有變更

WebSocket API 參數

在電話網頁的語音 > 電話標籤,下表界定了 WebSocket API 區段中每個參數的功能與使用情況。 表格還界定了電話組態檔中所新增的字串語法,其中包含用於配置參數的 XML (cfg.xml) 代碼。

表格 15 WebSocket API 參數

參數名稱

說明和預設值

控制伺服器網址

電話嘗試保持連接的 WebSocket 伺服器的 URL。

  • 在包含 XML (cfg.xml) 的電話組態檔中,請輸入以下格式的字串:

    <Control_Server_URL ua="na"/>
  • 在電話網頁上,輸入 WebSocket 伺服器的 URL。

    例如:

    <Control_Server_URL>wss://my-server.com/ws-server-path</Control_Server_URL>

URL 應採用以下格式之一:

  • 對於不安全的 HTTP 連接:

    ws://your-server-name/path

  • 對於安全的 HTTPS 連接:

    wss://your-server-name/some-path

建議您使用安全連接。

預設值:空。

依預設,由於 SSRC、IP 或通訊埠未變更,因此重新鍵入後,電話的變換計數器(ROC)會保留其值。 這是為了符合 RFC 3711。

但是,如果遠端端不完全符合 RFC 3711,則在 IP 電話和遠端端進行安全通話時,這可能會導致某些互操作問題(例如單向音訊問題)。

要增強電話在這種情況下的相容性,您可以啟用 ROC 重置。

1

存取電話管理網頁。

2

選擇語音 > SIP

3

RTP 參數 “部分中,將參數 ”重新鍵入 時 RX ROC 重置“設置為 ”是“。

您也可以在設定檔中設定此參數:

<RX_ROC_Reset_on_Re 鍵 ua =“na”>是</RX_ROC_Reset_on_Re 鍵>

允許的值:是和否。

預設值:否

若您將參數設定為 「是」,電話將在重新鍵入後重設 Rx ROC 值,而不變更 SSRC/IP/連接埠。 若設定為 「否」,電話在重新鍵入後將保留 Rx ROC 值,而不變更 SSRC/IP/連接埠。

4

按一下提交所有變更