自 2025 年 3 月 27 日起,我們建議您使用 android-latest-release
而非 aosp-main
建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。
全域可設定值
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
請使用本文提供的資源自訂撥號程式。不同的檢視畫面會使用從全域值重新導向的資源。詳情請參閱 AOSP 使用者體驗設計 (可能需要登入)。
<!-- Boolean config to gate the dialpad input motion -->
<bool name="config_enable_dial_motion">true</bool>
<!-- Font scale for the last input digit -->
<item name="config_dial_motion_scale_start" format="float" type="integer">1.5</item>
<!-- Scale down motion duration for the last input digit -->
<integer name="config_dial_motion_duration">200</integer>
<!-- 8388629 stands for Gravity.END |
Gravity.CENTER_VERTICAL-->
<integer name="config_dialed_number_gravity">8388629</integer>
詳細使用者個人資料
設定在找到與輸入號碼相符的聯絡人時,顯示詳細的使用者個人資料。如果設為 False,系統會「僅」顯示聯絡人名稱。如果為 true,系統會顯示聯絡人的顯示圖片、聯絡人名稱和電話號碼標籤。
<bool name="config_show_detailed_user_profile_on_dialpad">false</bool>
背景圖片 Alpha
設為 0 時,背景圖片將不會顯示。
<!-- Alpha when there is a contact avatar -->
<item name="config_background_image_alpha" format="float"
type="dimen">1.0</item>
<!-- Alpha when there are no contact avatars and uses the letter tile drawable color as background. -->
<item name="config_background_image_error_alpha" format="float" type="dimen">1.0</item>
「最近」和「聯絡人」頁面上的動作按鈕
<!-- A config determines whether to show divider and callog_action_button for callog items that
are not stored as contacts. "true" will show divider and button as disable state and "false" will
make divider and button invisible for non contacts. -->
<bool name="config_show_calllog_action_button_for_non_contact">false</bool>
<!-- A config determines whether to show divider and the button on the right side for contacts
without any contact details. "true" will show divider and button as disable state and "false" will
make divider and button invisible for empty contacts. -->
<bool name="config_show_contact_detail_button_for_empty_contact">false</bool>
聯絡人詳細資料頁面上的閘門地址和導覽功能
使用這個布林值設定,在「聯絡人詳細資料」頁面上限制地址和導覽功能。
<!-- A config determines whether to show postal address in contact details page. -->
<bool name="config_show_postal_address">false</bool>
「聯絡人詳細資料」頁面上的工具列
<!-- A config determines whether to show the action bar view in the contact details page.-->
<bool name="config_show_contact_details_action_bar_view">false</bool>
<!-- A config determines if to show the action bar avatar in the contact details page.-->
<bool name="config_show_contact_details_action_bar_avatar">true</bool>
工具列標題模式的設定:
- 0 代表應用程式名稱。
- 1 代表沒有工具列標題。
- 2 代表已連線的藍牙裝置名稱。
<!-- Use app name as toolbar title. Supported value see @attr/toolbarTitleMode -->
<integer name="config_toolbar_title_mode">0</integer>
全螢幕通話期間的使用者介面
全螢幕通話期間 UI 的設定閘道。將其設為 true 後,無論撥號應用程式使用者為何,接聽來電時都會顯示全螢幕通話 UI。如果設為 false,當使用者不在撥號應用程式時,接聽來電會關閉 HUN,但不會顯示全螢幕通話 UI。
<bool name="config_show_fullscreen_incall_ui">true</bool>
顯示圖片角落
變更這個值會影響所有顯示圖形,包括通知顯示圖形:
- 0.5 代表圓形顯示圖片。
- 1 代表正方形顯示圖片。
<dimen name="contact_avatar_corner_radius_percent" format="float">0.5</dimen>
清單項目使用的圖像大小
使用這個設定,為這些頁面上的清單項目設定顯示圖片大小:
- 「通話記錄」頁面
- 「聯絡人」頁面
- 搜尋頁面
- Dialpad 頁面上的個人資料顯示圖片
<dimen name="avatar_icon_size">76dp</dimen>
使用者透過 Dialpad 撥打電話時的即時搜尋結果
<!-- A config determines whether to show type down list on Dialpad -->
<bool name="config_show_type_down_list_on_dialpad">true</bool>
控制列高度
設定持續通話控制列、來電控制列高度和通話按鈕高度。
<dimen name="control_bar_height">96dp</dimen>
清單項目維度
<dimen name="list_item_height">116dp</dimen>
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2025-08-09 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-08-09 (世界標準時間)。"],[],[],null,["# Global configurable values\n\nUse the resources provided in this article to customize Dialer. Different views will use\nresources redirected from the global values. For more information, see the AOSP UX design (may\nrequire sign-in).\n\n### Dialpad input motion\n\n```carbon\n\u003c!-- Boolean config to gate the dialpad input motion --\u003e\n\u003cbool name=\"config_enable_dial_motion\"\u003etrue\u003c/bool\u003e\n\u003c!-- Font scale for the last input digit --\u003e\n\u003citem name=\"config_dial_motion_scale_start\" format=\"float\" type=\"integer\"\u003e1.5\u003c/item\u003e\n\u003c!-- Scale down motion duration for the last input digit --\u003e\n\u003cinteger name=\"config_dial_motion_duration\"\u003e200\u003c/integer\u003e\n```\n\n### Gravity of input digits in Dialpad\n\n```component-pascal\n\u003c!-- 8388629 stands for Gravity.END |\nGravity.CENTER_VERTICAL--\u003e\n\u003cinteger name=\"config_dialed_number_gravity\"\u003e8388629\u003c/integer\u003e\n```\n\n### Detailed user profile\n\nConfig to display a detailed user profile when a matching contact for the input number is found.\nWhen false, display contact name *only*. When true, display the contact avatar, contact name,\nand phone number label. \n\n```scdoc\n\u003cbool name=\"config_show_detailed_user_profile_on_dialpad\"\u003efalse\u003c/bool\u003e\n```\n\n### Background image alpha\n\nWhen set to 0, the background image is invisible. \n\n```carbon\n\u003c!-- Alpha when there is a contact avatar --\u003e\n\u003citem name=\"config_background_image_alpha\" format=\"float\"\ntype=\"dimen\"\u003e1.0\u003c/item\u003e\n\u003c!-- Alpha when there are no contact avatars and uses the letter tile drawable color as background. --\u003e\n\u003citem name=\"config_background_image_error_alpha\" format=\"float\" type=\"dimen\"\u003e1.0\u003c/item\u003e\n```\n\n### Action buttons on the Recents and Contacts pages\n\n```scdoc\n\u003c!-- A config determines whether to show divider and callog_action_button for callog items that\nare not stored as contacts. \"true\" will show divider and button as disable state and \"false\" will\nmake divider and button invisible for non contacts. --\u003e\n \u003cbool name=\"config_show_calllog_action_button_for_non_contact\"\u003efalse\u003c/bool\u003e\n\n\u003c!-- A config determines whether to show divider and the button on the right side for contacts\nwithout any contact details. \"true\" will show divider and button as disable state and \"false\" will\nmake divider and button invisible for empty contacts. --\u003e\n \u003cbool name=\"config_show_contact_detail_button_for_empty_contact\"\u003efalse\u003c/bool\u003e\n```\n\n### Gate address and navigation feature on Contact Details page\n\nUse this Boolean config to gate the address and navigation reature on the Contact Details\npage. \n\n```carbon\n\u003c!-- A config determines whether to show postal address in contact details page. --\u003e\n\u003cbool name=\"config_show_postal_address\"\u003efalse\u003c/bool\u003e\n```\n\n### Toolbar on the Contact Details page\n\n```scdoc\n\u003c!-- A config determines whether to show the action bar view in the contact details page.--\u003e\n\u003cbool name=\"config_show_contact_details_action_bar_view\"\u003efalse\u003c/bool\u003e\n\u003c!-- A config determines if to show the action bar avatar in the contact details page.--\u003e\n\u003cbool name=\"config_show_contact_details_action_bar_avatar\"\u003etrue\u003c/bool\u003e\n```\n\n### Toolbar title mode\n\nConfig for toolbar title mode:\n\n- 0 denotes app name.\n- 1 denotes no toolbar title.\n- 2 denotes connected Bluetooth device name.\n\n```gdscript\n\u003c!-- Use app name as toolbar title. Supported value see @attr/toolbarTitleMode --\u003e\n\u003cinteger name=\"config_toolbar_title_mode\"\u003e0\u003c/integer\u003e\n```\n\n### Fullscreen incall UI\n\nConfig gate for the fullscreen incall UI. When set to true, answering an incoming call\ndisplays the fullscreen incall UI regardless of Dialer user. When set to false, answering an\nincoming call dismisses the HUN without displaying the fullscreen incall UI when a user is not in\nDialer. \n\n```scdoc\n\u003cbool name=\"config_show_fullscreen_incall_ui\"\u003etrue\u003c/bool\u003e\n```\n\n### Avatar corner\n\nChanging this value affects all avatar shapes, including the notifications avatar:\n\n- 0.5 denotes round avatar.\n- 1 denotes square avatar.\n\n```scdoc\n\u003cdimen name=\"contact_avatar_corner_radius_percent\" format=\"float\"\u003e0.5\u003c/dimen\u003e\n```\n\n### Avatar size used for list items\n\nUse this config to set the avatar size for list items on these pages:\n\n- Call History page\n- Contacts page\n- Search page\n- Profile avatar on the Dialpad page\n\n```scdoc\n\u003cdimen name=\"avatar_icon_size\"\u003e76dp\u003c/dimen\u003e\n```\n\n### Live search result when user dials with Dialpad\n\n```carbon\n\u003c!-- A config determines whether to show type down list on Dialpad --\u003e\n\u003cbool name=\"config_show_type_down_list_on_dialpad\"\u003etrue\u003c/bool\u003e\n```\n\n### Control bar height\n\nSet the height of the Ongoing Call control bar, Incoming Call control bar height, and Call\nbutton height. \n\n```scdoc\n\u003cdimen name=\"control_bar_height\"\u003e96dp\u003c/dimen\u003e\n```\n\n### List item dimensions\n\n```scdoc\n\u003cdimen name=\"list_item_height\"\u003e116dp\u003c/dimen\u003e\n```"]]