自定义外观

自定义外观

本页向您展示了定制SDK UI的不同方法。

开始之前

在开始之前，您应该了解以下内容:

• 您可以自定义统一SDK UI中使用的几种颜色
• 您不能移动UI元素、删除UI部分或添加新部分

如果自定义UI元素对您很重要，请考虑使用相关的产品SDK API提供程序来构建您自己的UI。看到支持SDK提供程序和Answer Bot SDK提供商。

配置消息传递体验

的MessagingConfiguration类允许您更改跨产品sdk共享的属性。示例包括用于来自bot的消息的代理名称，以及与这些消息一起显示的角色。

             

              
MessagingActivity.builder ().withEngines (getEngines ()).withBotLabelString(“机器人的名字”),告诉(上下文);
             

使用或扩展SDK材质设计主题

统一SDK UI依赖于Material Design主题(一种从主题。MaterialComponents）.SDK尊重浅色、深色和带有深色操作栏主题的浅色。的colorPrimary，colorPrimaryDark,colorAccent属性是由SDK使用的，所以它会从你的应用中继承材质主题。

统一SDK UI不支持暗模式，也不支持任何重定制。扩展这些默认主题不会使统一SDK UI个性化。只支持上面提到的三个属性(改变一些文本、聊天框和应用程序的操作栏的颜色)。

如果自定义UI元素对您很重要，请考虑使用相关的产品SDK API提供程序来构建您自己的UI。看到闲谈，聊天，支持和回答机器人提供者。

您可以扩展SDK主题如下:

             

              
<风格名字=”YourLightTheme”父=”亚博ZendeskSdkTheme。光”>…风格>
             

             

              
<风格名字=”YourDarkTheme”父=”亚博ZendeskSdkTheme。黑暗”>…风格>
             

             

              
<风格名字=”YourLightTheme。DarkActionBar”父=”亚博ZendeskSdkTheme.Light.DarkActionBar”>…风格>
             

然后，您可以在您的AndroidManifest.xml如下:

             

              
<？XML版本="1.0"编码="utf-8"?><清单xmlns:安卓=”http://schemas.android.com/apk/res/android”包=”com.亚博zendesk.example”>…<应用程序…android:主题=”@style / YourTheme”…/>…清单>
             

或者，如果您不想在应用程序级别设置主题，您可以为覆盖主题MessagingActivity在你的AndroidManifest.xml如下:

             

              
<？XML版本="1.0"编码="utf-8"?><清单xmlns:安卓=”http://schemas.android.com/apk/res/android”包=”com.亚博zendesk.example”>…<应用程序…>…<活动android:名字=”亚博zendesk.messaging.MessagingActivity”android:主题=”@style / YourTheme”/>应用程序>…清单>
             

使用自己的主题

如果不扩展SDK主题，则仍然必须应用扩展自的主题主题。MaterialComponents到MessagingActivity类。

             

              
<风格名字=”YourLightTheme”父=”Theme.MaterialComponents.Light”><项名字=”colorPrimary”>@color / my_color_primary项><项名字=”colorPrimaryDark”>@color / my_color_primary_dark项><项名字=”colorAccent”>@color / my_color_accent项>风格>
             

上面的三个属性是主题中统一SDK UI使用的唯一属性。

更改每个组件的外观

如果您希望自定义超出主题中指定的组件，请找到要自定义的组件并查看布局和值统一SDK的目录。这些目录包含SDK布局和样式的所有源代码。要查找这些目录:

1. 包括我们的SDK在您的build.gradle文件，如添加统一SDK。
2. 构建您的项目。
3. 在Android Studio的project View中查看项目结构。使用文件树

窗格的左侧，然后选择项目从顶部的下拉菜单中，默认为安卓。

1. 开放外部库在模块列表的底部找到

统一的SDK。

             

              
！［］（https：//禅-市场营销-文档。s3。amazonaws。com/文档/在/扩大-外部-库。png）！［］（https：//禅-市场营销-文档。s3。amazonaws。com/文档/在/发现-的-支持-sdk。png）所有的SDK包含布局文件在的**布局**目录的的**res**目录在的统一SDK包。！［］（https：//禅-市场营销-文档。s3。amazonaws。com/文档/在/扩大-的-布局-目录。png）
             

zui_activity_messaging.xml的布局文件是MessagingActivity。列出了用于不同视图和组件的许多其他布局文件MessagingActivity。

中定义了相关的样式、尺寸和颜色values.xml。

要自定义其他非统一SDK组件的组件，请查找下面的相关目录外部库。