自訂標題和子標題

無論是在安裝期間還是通話進行中，開發人員現在都能自訂通話的標題和子標題。 這項功能更靈活地讓通話體驗與特定使用案例保持一致。

例如，在客戶支援案例中，標題可能會顯示正在解決的問題，而子標題可能會顯示客戶的名稱或票證號碼。

此外，如果追蹤各段通話所花費的時間非常重要，子標題可動態更新以顯示經過的通話持續時間，有助於有效地管理會議或工作階段。

必要條件

• 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
• 已部署通訊服務資源。 建立通訊服務資源。
• 用來啟用通話用戶端的使用者存取權杖。 取得使用者存取權杖。
• 選擇性：完成開始使用 UI 程式庫複合的快速入門。

設定功能

自訂標題和子標題

若要設定和更新通話畫面標頭 title 和 subtitle，請使用 CallCompositeCallScreenOptions 來設定 CallCompositeCallScreenHeaderViewData。 如果未設定 title 值，則會顯示預設 UI 程式庫標題。

Kotlin

// create call screen header view data to set title and subtitle
val callScreenHeaderViewData = CallCompositeCallScreenHeaderViewData()
callScreenHeaderViewData.title = "title"
callScreenHeaderViewData.subtitle = "subtitle"

// create call screen options
val callScreenOptions = CallCompositeCallScreenOptions()
callScreenOptions.setHeaderViewData(callScreenHeaderViewData)

// create call composite
val callComposite = CallCompositeBuilder().build()

val localOptions = CallCompositeLocalOptions()
localOptions.setCallScreenOptions(callScreenOptions)

// launch composite
callComposite.launch(applicationContext, locator, localOptions)

// use any event from call composite to update title subtitle when call is in progress
// callScreenHeaderViewData.title = "updated title"
// callScreenHeaderViewData.subtitle = "updated subtitle"

Java

// Create call screen header view data to set title and subtitle
CallCompositeCallScreenHeaderViewData callScreenHeaderViewData = new CallCompositeCallScreenHeaderViewData();
callScreenHeaderViewData.setTitle("title");
callScreenHeaderViewData.setSubtitle("subtitle");

// Create call screen options
CallCompositeCallScreenOptions callScreenOptions = new CallCompositeCallScreenOptions();
callScreenOptions.setHeaderOptions(callScreenHeaderViewData);

// Create call composite
CallComposite callComposite = new CallCompositeBuilder().build();

CallCompositeLocalOptions localOptions = new CallCompositeLocalOptions();
localOptions.setCallScreenOptions(callScreenOptions);

// Launch composite
callComposite.launch(getApplicationContext(), locator, localOptions);

// Use any event from call composite to update title and subtitle when the call is in progress
// callScreenHeaderViewData.setTitle("updated title");
// callScreenHeaderViewData.setSubtitle("updated subtitle");

自訂標題和子標題

若要設定及更新通話畫面 infoHeader title 和 subtitle，我們有 CallScreenHeaderViewData 可設定並經由 param headerViewData 傳遞至 CallScreenOptions。 CallScreenHeaderViewData 中的 title、Subtitle 是選用參數，而 headerViewData 本身也是選用的。 如果未設定 title 值，則會顯示預設 UI 程式庫標題。

var headerViewData = CallScreenHeaderViewData(
            title: "This is a custom InfoHeader",
            subtitle: "This is a custom subtitle")
var callScreenOptions = CallScreenOptions(controlBarOptions: barOptions,
                                          headerViewData: headerViewData)

// Use any event from call composite to update title & subtitle when the call is in progress.
headerViewData.title = "Custom updated title"
headerViewData.subtitle = "Custom updated subtitle"

下一步

• 深入了解 UI 程式庫