Android 14 bietet tolle Funktionen und APIs für Entwickler. Im Folgenden erfahren Sie mehr über Funktionen für Ihre Apps und erhalten einen Einstieg in die zugehörigen APIs.
Eine detaillierte Liste der hinzugefügten, geänderten und entfernten APIs finden Sie im API-Diff-Bericht. Weitere Informationen zu den hinzugefügten APIs finden Sie in der Android API-Referenz. Suchen Sie bei Android 14 nach APIs, die in API-Level 34 hinzugefügt wurden. Informationen dazu, in welchen Bereichen sich Plattformänderungen auf Ihre Apps auswirken können, finden Sie in den Änderungen am Verhalten von Android 14 für Apps, die auf Android 14 ausgerichtet sind und in den Änderungen am Verhalten von Android 14 für alle Apps.
Lokalisierung
App-spezifische Spracheinstellungen
Android 14 erweitert die Funktionen für die Sprache pro App, die in Android 13 (API-Level 33) eingeführt wurden, um die folgenden zusätzlichen Funktionen:
localeConfig
einer App automatisch generieren: Ab Android Studio Giraffe Canary 7 und AGP 8.1.0-alpha07 können Sie Ihre App so konfigurieren, dass sie automatisch Spracheinstellungen pro App unterstützt. Basierend auf den Projektressourcen generiert das Android Gradle-Plug-in die DateiLocaleConfig
und fügt in der endgültigen Manifestdatei einen Verweis darauf hinzu. Sie müssen die Datei also nicht mehr manuell erstellen oder aktualisieren. AGP verwendet die Ressourcen in denres
-Ordnern Ihrer App-Module und alle Abhängigkeiten von Bibliotheksmodulen, um die Sprachen zu ermitteln, die in dieLocaleConfig
-Datei aufgenommen werden sollen.Dynamische Updates für die
localeConfig
einer App: Verwenden Sie die MethodensetOverrideLocaleConfig()
undgetOverrideLocaleConfig()
inLocaleManager
, um die Liste der unterstützten Sprachen Ihrer App in den Systemeinstellungen des Geräts dynamisch zu aktualisieren. Sie können diese Flexibilität nutzen, um die Liste der unterstützten Sprachen pro Region anzupassen, A/B-Tests durchzuführen oder eine aktualisierte Liste der Sprachen anzugeben, wenn Ihre App serverseitige Pushes für die Lokalisierung verwendet.Sichtbarkeit der App-Sprache für Eingabemethoden-Editoren (IMEs): IMEs können die Methode
getApplicationLocales()
verwenden, um die Sprache der aktuellen App zu prüfen und die IME-Sprache mit dieser Sprache abzugleichen.
Grammatical Inflection API
有 30 亿人在使用区分性别的语言,此类语言的语法类别(例如名词、动词、形容词和介词)会根据您交谈所涉及的人或物的性别而变化。传统上,许多区分性别的语言使用阳性语法性别作为默认或通用性别。
以错误的语法性别来称呼用户,例如以阳性语法性别来称呼女性,可能会对她们的表现和态度产生负面影响。相比之下,界面语言如果能正确反映用户的语法性别,就可以提高用户互动度,并提供更个性化、更自然的用户体验。
To help you build a user-centric UI for gendered languages, Android 14 introduces the Grammatical Inflection API, which lets you add support for grammatical gender without refactoring your app.
Regionale Einstellungen
Regional preferences enable users to personalize temperature units, the first day of the week, and numbering systems. A European living in the United States might prefer temperature units to be in Celsius rather than Fahrenheit and for apps to treat Monday as the beginning of the week instead of the US default of Sunday.
New Android Settings menus for these preferences provide users with a
discoverable and centralized location to change app preferences. These
preferences also persist through backup and restore. Several APIs and
intents—such as
getTemperatureUnit
and
getFirstDayOfWeek
—
grant your app read access to user preferences, so your app can adjust how it
displays information. You can also register a
BroadcastReceiver
on
ACTION_LOCALE_CHANGED
to handle locale configuration changes when regional preferences change.
To find these settings, open the Settings app and navigate to System > Languages & input > Regional preferences.


Bedienungshilfen
Nicht lineare Schriftskalierung auf 200%
Ab Android 14 unterstützt das System eine Schriftgrößenänderung von bis zu 200 %. So erhalten sehbehinderte Nutzer zusätzliche Optionen für Barrierefreiheit, die den Richtlinien für barrierefreie Webinhalte (Web Content Accessibility Guidelines, WCAG) entsprechen.
Damit große Textelemente auf dem Bildschirm nicht zu groß skaliert werden, verwendet das System eine nichtlineare Skalierungskurve. Durch diese Skalierungsstrategie werden große Textgrößen nicht in gleicher Geschwindigkeit skaliert wie kleinerer Text. Mit einer nicht linearen Schriftskalierung die proportionale Hierarchie zwischen Elementen unterschiedlicher Größe beibehalten, zur Minimierung von Problemen mit linearer Textskalierung in hohem Maße (z. B. abgeschnittener Text oder Text, der aufgrund des extrem großen Displays schwerer lesbar ist Größen).
App mit nicht linearer Schriftskalierung testen

Wenn Sie bereits skalierbare Pixel (sp) zum Definieren der Textgröße verwenden, werden diese zusätzlichen Optionen und Skalierungsverbesserungen automatisch auf den Text in Ihrer App angewendet. Sie sollten jedoch weiterhin UI-Tests mit aktivierter maximaler Schriftgröße (200 %) durchführen, um sicherzustellen, dass die Schriftgrößen in Ihrer App korrekt angewendet werden und größere Schriftgrößen ohne Beeinträchtigung der Nutzerfreundlichkeit möglich sind.
So aktivieren Sie die Schriftgröße von 200 %:
- Öffnen Sie die Einstellungen und navigieren Sie zu Bedienungshilfen > Anzeigegröße und Text.
- Tippen Sie für die Option Schriftgröße auf das Pluszeichen (+), bis die maximale Schriftart Größeneinstellung aktiviert ist, wie in der zugehörigen Abbildung gezeigt. .
Skalierte Pixeleinheiten (sp) für Textgrößen verwenden
Geben Sie Textgrößen immer in sp-Einheiten an. Wann? Ihre App sp-Einheiten verwendet, kann Android die bevorzugte Textgröße des Nutzers und und skalieren Sie es entsprechend.
Verwenden Sie keine sp-Einheiten für das Padding und definieren Sie keine Ansichtshöhen bei implizitem Padding: mit nicht linearer Schriftskalierung sind die Abmessungen sp möglicherweise nicht proportional. Daher ist 4sp + 20 sp ist möglicherweise nicht gleich 24 sp.
Skalierte Pixeleinheiten (sp) umrechnen
Verwenden Sie TypedValue.applyDimension()
, um von sp-Einheiten in Pixel umzuwandeln, und TypedValue.deriveDimension()
, um Pixel in sp umzuwandeln. Bei diesen Methoden wird die entsprechende nichtlineare Skalierungskurve automatisch angewendet.
Vermeiden Sie das Hartkodieren von Gleichungen mit
Configuration.fontScale
oder
DisplayMetrics.scaledDensity
Da die Schrift skaliert wird, ist das Feld scaledDensity
nicht mehr korrekt. Das Feld fontScale
sollte nur zu Informationszwecken verwendet werden, da Schriftarten nicht mehr mit einem einzelnen Skalarwert skaliert werden.
Verwenden Sie sp-Einheiten für „lineHeight“.
Definieren Sie android:lineHeight
immer in sp-Einheiten anstelle von dp, damit die Zeilenhöhe mit dem Text skaliert. Andernfalls, wenn Ihr Text in sp, Ihre lineHeight
aber in dp oder px ist, wird er nicht skaliert und wirkt überladen.
TextView korrigiert lineHeight
automatisch so, dass die beabsichtigte
Proportionen werden beibehalten, aber nur, wenn sowohl textSize
als auch lineHeight
in sp-Einheiten definiert.
Kamera und Medien
Ultra HDR für Bilder

Android 14 adds support for High Dynamic Range (HDR) images that retain more of the information from the sensor when taking a photo, which enables vibrant colors and greater contrast. Android uses the Ultra HDR format, which is fully backward compatible with JPEG images, allowing apps to seamlessly interoperate with HDR images, displaying them in Standard Dynamic Range (SDR) as needed.
Rendering these images in the UI in HDR is done automatically by the framework
when your app opts in to using HDR UI for its Activity Window, either through a
manifest entry or at runtime by calling
Window.setColorMode()
. You can also capture compressed Ultra
HDR still images on supported devices. With more colors recovered
from the sensor, editing in post can be more flexible. The
Gainmap
associated with Ultra HDR images can be used to render
them using OpenGL or Vulkan.
Zoom, Fokus, Postview und mehr in Kameraerweiterungen
Android 14 upgrades and improves camera extensions, allowing apps to handle longer processing times, which enables improved images using compute-intensive algorithms like low-light photography on supported devices. These features give users an even more robust experience when using camera extension capabilities. Examples of these improvements include:
- Dynamic still capture processing latency estimation provides much more
accurate still capture latency estimates based on the current scene and
environment conditions. Call
CameraExtensionSession.getRealtimeStillCaptureLatency()
to get aStillCaptureLatency
object that has two latency estimation methods. ThegetCaptureLatency()
method returns the estimated latency betweenonCaptureStarted
andonCaptureProcessStarted()
, and thegetProcessingLatency()
method returns the estimated latency betweenonCaptureProcessStarted()
and the final processed frame being available. - Support for capture progress callbacks so that apps can display the current
progress of long-running, still-capture processing operations. You can check
if this feature is available with
CameraExtensionCharacteristics.isCaptureProcessProgressAvailable
, and if it is, you implement theonCaptureProcessProgressed()
callback, which has the progress (from 0 to 100) passed in as a parameter. Extension specific metadata, such as
CaptureRequest.EXTENSION_STRENGTH
for dialing in the amount of an extension effect, such as the amount of background blur withEXTENSION_BOKEH
.Postview Feature for Still Capture in camera extensions, which provides a less-processed image more quickly than the final image. If an extension has increased processing latency, a postview image could be provided as a placeholder to improve UX and switched out later for the final image. You can check if this feature is available with
CameraExtensionCharacteristics.isPostviewAvailable
. Then you can pass anOutputConfiguration
toExtensionSessionConfiguration.setPostviewOutputConfiguration
.Support for
SurfaceView
allowing for a more optimized and power-efficient preview render path.Support for tap to focus and zoom during extension usage.
Zoomen im Sensor
当 CameraCharacteristics
中的 REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE
包含 SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW
时,您的应用可以使用高级传感器功能,将剪裁后的 RAW 数据流的像素与全视野范围相同,方法是将 CaptureRequest
与将数据流用例设置为 CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW
的 RAW 目标搭配使用。通过实现请求替换控件,更新后的相机可让用户在其他相机控件准备就绪之前使用缩放控件。
Verlustfreie USB-Audioübertragung
Android 14 unterstützt jetzt verlustfreie Audioformate für eine audiophile Wiedergabe über USB-Kopfhörer. Du kannst ein USB-Gerät nach seinen bevorzugten Mixerattributen abfragen, einen Listener für Änderungen an bevorzugten Mixerattributen registrieren und Mixerattribute mit der Klasse AudioMixerAttributes
konfigurieren. Diese Klasse stellt das Format dar, z. B. Kanalmaske, Abtastrate und Verhalten des Audiomixers. Mit dieser Klasse kann Audio direkt gesendet werden, ohne dass es gemischt, die Lautstärke angepasst oder Verarbeitungseffekte angewendet werden.
Produktivität und Tools für Entwickler
Anmeldedaten-Manager
Android 14 将 Credential Manager 添加为平台 API,并通过使用 Google Play 服务的 Jetpack 库,向后额外支持 Android 4.4(API 级别 19)设备。Credential Manager 旨在通过 API 使用用户配置的凭据提供程序检索和存储凭据,让用户更轻松地登录。Credential Manager 在单个 API 中支持多种登录方法,包括用户名和密码、通行密钥和联合登录解决方案(如“使用 Google 账号登录”)。
通行密钥具有许多优势。例如,通行密钥是基于业界标准构建的,可在各种不同的操作系统和浏览器生态系统中使用,并且可用于网站和应用。
如需了解详情,请参阅 Credential Manager 和通行密钥文档以及介绍 Credential Manager 和通行密钥的博文。
Health Connect
Health Connect ist ein On-Device-Repository für Gesundheits- und Fitnessdaten von Nutzern. Nutzer können Daten zwischen ihren Lieblings-Apps teilen und an einem zentralen Ort festlegen, welche Daten sie für diese Apps freigeben möchten.
Auf Geräten mit Android-Versionen vor Android 14 kann Health Connect als App im Google Play Store heruntergeladen werden. Ab Android 14 ist Health Connect Teil der Plattform und erhält Updates über Google Play-Systemupdates, ohne dass ein separater Download erforderlich ist. So kann Health Connect häufig aktualisiert werden und Ihre Apps können davon ausgehen, dass Health Connect auf Geräten mit Android 14 oder höher verfügbar ist. Nutzer können über die Einstellungen auf ihrem Gerät auf Health Connect zugreifen. Die Datenschutzeinstellungen sind in die Systemeinstellungen integriert.


Health Connect bietet in Android 14 mehrere neue Funktionen, z. B. Trainingsrouten. Damit können Nutzer eine Route ihres Trainings teilen, die auf einer Karte visualisiert werden kann. Eine Route wird als Liste von Orten definiert, die innerhalb eines bestimmten Zeitraums gespeichert wurden. Ihre App kann Routen in Trainingseinheiten einfügen und so miteinander verknüpfen. Damit Nutzer die vollständige Kontrolle über diese sensiblen Daten haben, müssen sie die Freigabe einzelner Routen für andere Apps zulassen.
Weitere Informationen finden Sie in der Health Connect-Dokumentation und im Blogpost Neuerungen in Android Health.
OpenJDK 17-Updates
Android 14 将继续更新 Android 的核心库,以与最新 OpenJDK LTS 版本中的功能保持一致,包括适合应用和平台开发者的库更新和 Java 17 语言支持。
其中包含以下功能和改进:
- 将大约 300 个
java.base
类更新为支持 Java 17。 - 文本块 - 为 Java 编程语言引入了多行字符串字面量。
- instanceof 模式匹配:可让对象在
instanceof
中被视为具有特定类型,而无需任何额外的变量。 - 密封类:允许您限制哪些类和接口可以扩展或实现它们。
得益于 Google Play 系统更新 (Project Mainline),6 亿多台设备能够接收包含这些更改的最新 Android 运行时 (ART) 更新。我们致力于为应用提供更加一致、安全的跨设备环境,并为用户提供独立于平台版本的新功能。
Java 和 OpenJDK 是 Oracle 及/或其关联公司的商标或注册商标。
Verbesserungen für App-Shops
Android 14 引入了多个 PackageInstaller
API,可帮助应用商店改善其用户体验。
下载之前请求批准安装
安装或更新应用可能需要用户批准。例如,当使用 REQUEST_INSTALL_PACKAGES
权限的安装程序尝试安装新应用时。在之前的 Android 版本中,只有在将 APK 写入安装会话并且提交会话后,应用商店才能请求用户批准。
从 Android 14 开始,requestUserPreapproval()
方法可让安装程序在提交安装会话之前请求用户批准。此项改进可让应用商店将任何 APK 的下载操作推迟到用户批准安装之后。此外,用户批准安装后,应用商店可以在后台下载并安装应用,而不会干扰用户。
承担未来更新的责任
借助 setRequestUpdateOwnership()
方法,安装程序可以向系统表明它打算负责将被安装的应用未来的更新。此 capability 可实现更新所有权强制执行,即仅允许更新所有者为应用安装自动更新。更新所有权强制执行有助于确保用户仅收到来自预期应用商店的更新。
任何其他安装程序(包括使用 INSTALL_PACKAGES
权限的安装程序)都必须获得用户的明确批准,才能安装更新。如果用户决定继续从其他来源安装更新,则会失去更新所有权。
在干扰较少的时段更新应用
应用商店通常希望避免更新正在使用的应用,因为这会导致应用正在运行的进程被终止,而这可能会中断用户正在执行的操作。
从 Android 14 开始,InstallConstraints
API 让安装程序可以确保其应用更新在适当的时机进行。例如,应用商店可以调用 commitSessionAfterInstallConstraintsAreMet()
方法来确保仅在用户不再与相应应用互动时才进行更新。
无缝安装可选拆分
借助拆分 APK,应用的功能可以通过单独的 APK 文件提供,而不是以单体式 APK 的形式提供。借助拆分 APK,应用商店可以优化不同应用组件的提供。例如,应用商店可能会根据目标设备的属性进行优化。自在 API 级别 22 中引入以来,PackageInstaller
API 一直支持拆分。
在 Android 14 中,setDontKillApp()
方法可让安装程序指明在安装新的拆分项时应用的运行进程不应终止。应用商店可以使用此功能,在用户使用应用时无缝安装应用的新功能。
App-Metadaten-Bundles
从 Android 14 开始,Android 软件包安装程序可让您指定应用元数据(例如数据安全做法),以在 Google Play 等应用商店页面上架。
Erkennen, wenn Nutzer Screenshots auf dem Gerät erstellen
为了打造更加标准化的屏幕截图检测体验,Android 14 引入了可保护隐私的屏幕截图检测 API。借助此 API,应用可以按 activity 注册回调。如果用户在该 activity 可见时截取屏幕截图,系统会调用这些回调并通知用户。
Nutzererfahrung
Benutzerdefinierte Aktionen für die Freigabeseite und verbessertes Ranking
Android 14 updates the system sharesheet to support custom app actions and more informative preview results for users.
Add custom actions
With Android 14, your app can add custom actions to the system sharesheet it invokes.

Improve ranking of Direct Share targets
Android 14 uses more signals from apps to determine the ranking of the direct share targets to provide more helpful results for the user. To provide the most useful signal for ranking, follow the guidance for improving rankings of your Direct Share targets. Communication apps can also report shortcut usage for outgoing and incoming messages.

Unterstützung für integrierte und benutzerdefinierte Animationen für die intelligente „Zurück“-Touch-Geste
Android 13 在开发者选项背后引入了预测性“返回主屏幕”动画。在已启用开发者选项的受支持应用中使用时,滑回手势会显示动画,表明返回手势会使应用退回到主屏幕。
Android 14 包含针对“预测性返回”的多项改进和新指南:
- 您可设置
android:enableOnBackInvokedCallback=true
,以便为每个 activity 选择启用预测性返回系统动画,而不是为整个应用选择启用。 - 我们添加了新的系统动画,以配合 Android 13 中的“返回主屏幕”动画。新的系统动画是跨 activity 和跨任务的,您可在迁移到预测性返回后自动获得该动画。
- 我们为底部动作条、侧边动作条和搜索添加了新的 Material 组件动画。
- 我们制作了有关如何创建自定义应用内动画和转换的设计指南。
- 我们添加了许多新 API 来支持自定义的应用内转换动画:
在此 Android 14 预览版中,所有预测性返回功能都是位于开发者选项背后。请参阅与将您的应用迁移到预测性返回有关的开发者指南,以及与创建自定义应用内转换有关的开发者指南。
App-spezifische Überschreibungen von Geräteherstellern mit großem Display
Mit Überschreibungen pro App können Gerätehersteller das Verhalten von Apps auf Geräten mit großen Bildschirmen ändern. Die Überschreibung FORCE_RESIZE_APP
weist das System beispielsweise an, die App an die Displayabmessungen anzupassen (um den Kompatibilitätsmodus zu vermeiden), auch wenn resizeableActivity="false"
im App-Manifest festgelegt ist.
Überschreibungen sollen die Nutzererfahrung auf großen Bildschirmen verbessern.
Mit neuen Manifesteigenschaften können Sie einige Überschreibungen von Geräteherstellern für Ihre App deaktivieren.
Nutzer mit großem Bildschirm – App-spezifische Überschreibungen
按应用替换项会更改应用在大屏设备上的行为。例如,无论应用的配置如何,OVERRIDE_MIN_ASPECT_RATIO_LARGE
设备制造商替换项都会将应用宽高比设置为 16:9。
借助 Android 14 QPR1,用户可以在大屏设备上通过新的设置菜单应用按应用替换项。
App-Bildschirmfreigabe
App screen sharing enables users to share an app window instead of the entire device screen during screen content recording.
With app screen sharing, the status bar, navigation bar, notifications, and other system UI elements are excluded from the shared display. Only the content of the selected app is shared.
App screen sharing improves productivity and privacy by enabling users to run multiple apps but limit content sharing to a single app.
LLM-basierte intelligente Antworten in Gboard auf Google Pixel 8 Pro
On Pixel 8 Pro devices with the December Feature Drop, developers can try out higher-quality smart replies in Gboard powered by on-device Large Language Models (LLMs) running on Google Tensor.
This feature is available as a limited preview for US English in WhatsApp, Line, and KakaoTalk. It requires using a Pixel 8 Pro device with Gboard as your keyboard.
To try it out, first enable the feature in Settings > Developer Options > AiCore Settings > Enable Aicore Persistent.
Next, open a conversation in a supported app to see LLM-powered Smart Reply in Gboard's suggestion strip in response to incoming messages.
Grafik
Pfade können abgefragt und interpoliert werden
Android 的 Path
API 是一种强大且灵活的机制,可用于创建和渲染矢量图形,能够描边或填充路径、根据线段或二次曲线或立方曲线构建路径、执行布尔运算以获取更复杂的形状,或同时执行所有这些操作。但有一个限制是,您无法了解 Path 对象中实际包含的内容;该对象的内部信息在创建后对调用方是不透明的。
如需创建 Path
,您可以调用 moveTo()
、lineTo()
和 cubicTo()
等方法来添加路径段。但是,无法询问该路径有哪些片段,因此您必须在创建时保留该信息。
从 Android 14 开始,您可以查询路径以了解其内部内容。首先,您需要使用 Path.getPathIterator
API 获取 PathIterator
对象:
Kotlin
val path = Path().apply { moveTo(1.0f, 1.0f) lineTo(2.0f, 2.0f) close() } val pathIterator = path.pathIterator
Java
Path path = new Path(); path.moveTo(1.0F, 1.0F); path.lineTo(2.0F, 2.0F); path.close(); PathIterator pathIterator = path.getPathIterator();
接下来,您可以调用 PathIterator
逐个遍历片段,并检索每个片段的所有必要数据。以下示例使用了 PathIterator.Segment
对象,它会为您打包数据:
Kotlin
for (segment in pathIterator) { println("segment: ${segment.verb}, ${segment.points}") }
Java
while (pathIterator.hasNext()) { PathIterator.Segment segment = pathIterator.next(); Log.i(LOG_TAG, "segment: " + segment.getVerb() + ", " + segment.getPoints()); }
PathIterator
还有一个非分配版 next()
,您可以在其中传入缓冲区来保存点数据。
查询 Path
数据的一个重要用例是插值。例如,您可能想在两个不同的路径之间添加动画(或变形)。为了进一步简化该用例,Android 14 针对 Path
还包含 interpolate()
方法。假设两个路径具有相同的内部结构,interpolate()
方法会使用该插值结果创建一个新的 Path
。以下示例返回了一个形状介于 path
和 otherPath
之间的一半(线性插值为 0.5)的路径:
Kotlin
val interpolatedResult = Path() if (path.isInterpolatable(otherPath)) { path.interpolate(otherPath, .5f, interpolatedResult) }
Java
Path interpolatedResult = new Path(); if (path.isInterpolatable(otherPath)) { path.interpolate(otherPath, 0.5F, interpolatedResult); }
Jetpack graphics-path 库也为早期版本的 Android 启用了类似的 API。
Benutzerdefinierte Shader mit Vertex- und Fragment-Shadern
Android has long supported drawing triangle meshes with custom shading, but the input mesh format has been limited to a few predefined attribute combinations. Android 14 adds support for custom meshes, which can be defined as triangles or triangle strips, and can, optionally, be indexed. These meshes are specified with custom attributes, vertex strides, varying, and vertex and fragment shaders written in AGSL.
The vertex shader defines the varyings, such as position and color, while the
fragment shader can optionally define the color for the pixel, typically by
using the varyings created by the vertex shader. If color is provided by the
fragment shader, it is then blended with the current Paint
color using the blend mode selected when
drawing the mesh. Uniforms can be passed
into the fragment and vertex shaders for additional flexibility.
Hardware-Puffer-Renderer für Canvas
协助使用 Android 的 Canvas
API 通过
硬件加速至 HardwareBuffer
、Android 14
引入了 HardwareBufferRenderer
。如果您的用例涉及通过 SurfaceControl
与系统合成器通信以实现低延迟绘制,此 API 特别有用。