你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

自定义标题和副标题

开发人员现在能够在设置期间和通话过程中自定义通话的标题和副标题。 此功能可以更灵活地将通话体验与特定用例相结合。

例如，在客户支持方案中，标题可以显示正在解决的问题，而副标题可以显示客户的名称或工单号。

此外，如果必须跟踪通话的各个环节所花的时间，则副标题可以通过动态更新来显示已过的通话持续时间，这样有助于有效地管理会议或会话。

先决条件

• 具有活动订阅的 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 并将其传递给 CallScreenOptions，方法是使用参数 headerViewData。 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 库