기능 및 API 개요

Android 14에는 개발자를 위한 훌륭한 기능과 API가 도입되었습니다. 다음은 앱의 기능을 알아보고 관련 API를 시작하는 데 도움이 됩니다.

추가된 API, 수정된 API, 삭제된 API에 관한 자세한 목록은 API 차이점 보고서를 참고하세요. 추가된 API에 관한 자세한 내용은 Android API 참조를 참고하세요. Android 14의 경우 API 수준 34에 추가된 API를 찾아보세요. 플랫폼 변경이 앱에 영향을 줄 수 있는 분야에 관해 알아보려면 Android 14를 타겟팅하는 앱 및 모든 앱의 Android 14 동작 변경사항을 확인해야 합니다.

다국어 지원

앱별 언어 설정

Android 14에서는 Android 13(API 수준 33)에서 도입된 앱별 언어 기능을 다음과 같은 추가 기능으로 확장합니다.

  • 앱의 localeConfig 자동으로 생성: Android 스튜디오 Giraffe Canary 7 및 AGP 8.1.0-alpha07부터 앱이 앱별 언어 설정을 자동으로 지원하도록 구성할 수 있습니다. Android Gradle 플러그인은 프로젝트 리소스를 기반으로 LocaleConfig 파일을 생성하고 최종 매니페스트 파일에 이에 대한 참조를 추가하므로 더 이상 수동으로 파일을 만들거나 업데이트할 필요가 없습니다. AGP는 앱 모듈의 res 폴더에 있는 리소스 및 모든 라이브러리 모듈 종속 항목을 사용하여 LocaleConfig 파일에 포함할 언어를 결정합니다.

  • 앱의 localeConfig 동적 업데이트: LocaleManager에서 setOverrideLocaleConfig() 및 getOverrideLocaleConfig() 메서드를 사용하여 기기의 시스템 설정에서 앱의 지원되는 언어 목록을 동적으로 업데이트합니다. 앱에서 현지화에 서버 측 푸시를 활용하는 경우 이러한 유연성을 사용하여 지역별 지원되는 언어 목록을 맞춤설정하거나 A/B 실험을 실행하거나 업데이트된 언어 목록을 제공합니다.

  • 입력 방식 편집기(IME)의 앱 언어 공개 상태: IME는 getApplicationLocales() 메서드를 활용하여 현재 앱의 언어를 확인하고 IME 언어를 해당 언어와 일치시킬 수 있습니다.

Grammatical Inflection API

30억 명의 사용자가 성별이 지정된 언어를 사용합니다. 이 언어는 이야기하는 사람과 사물의 성별에 따라 문법적 카테고리(예: 명사, 동사, 형용사, 전치사)가 영향을 받는 언어입니다. 일반적으로 성별이 지정된 많은 언어에서 남성형 문법적 성별을 기본 성별이나 일반 성별로 사용합니다.

여성을 남성형 문법적 성별로 언급하는 등 잘못된 문법적 성별로 사용자를 언급하면 사용자의 실적과 태도에 부정적인 영향을 미칠 수 있습니다. 반면 사용자의 문법적 성별을 올바르게 반영하는 언어로 된 UI는 사용자 참여를 개선하고 보다 맞춤설정되고 자연스러운 사용자 환경을 제공할 수 있습니다.

为帮助您针对区分性别的语言构建以用户为中心的界面，Android 14 引入了 Grammatical Inflection API，让您无需重构应用便能添加对语法性别的支持。

지역 설정

用户可通过地区偏好设置对温度单位、一周的第一天和编号系统进行个性化设置。居住在美国的欧洲用户可能更希望使用摄氏度，而不是华氏度，并且希望应用将星期一视为一周的开始，而不是像美国那样默认从星期日开始。

新 Android 设置菜单包含这些偏好设置，使用户能够在一个位置集中发现这些应用更改偏好设置。这些偏好设置在备份和恢复设备后也会保持不变。多个 API 和 intent（例如 getTemperatureUnit 和 getFirstDayOfWeek）会为您的应用授予读取权限来访问用户偏好设置，因此您的应用可以调整其显示信息的方式。您还可以在 ACTION_LOCALE_CHANGED 上注册 BroadcastReceiver，以便在地区偏好设置发生更改时处理语言区域配置更改。

如需找到这些设置，请打开“设置”应用，然后依次前往系统 > 语言和输入法 > 地区偏好设置。

Android 系统设置中的地区偏好设置界面。
Android 系统中地区偏好设置的温度选项 设置。

접근성

비선형 글꼴 크기 200%로 조정

Android 14부터 시스템은 글꼴 크기를 최대 200%까지 지원하므로 사용자에게 추가 접근성 옵션을 제공할 수 있습니다.

화면의 큰 텍스트 요소가 너무 커지지 않도록 시스템에서는 비선형 크기 조정 곡선을 적용합니다. 이 크기 조정 전략은 큰 텍스트가 작은 텍스트와 동일한 비율로 조정되지 않음을 의미합니다. 비선형 글꼴 크기 조정은 다양한 크기의 요소 간에 비례 계층 구조를 유지하는 동시에 높은 수준으로 크기가 조정되는 선형 텍스트 문제 (예: 텍스트가 잘리거나 너무 큰 디스플레이 크기로 인해 텍스트를 읽기 어려워지는 경우)를 완화하는 데 도움이 됩니다.

비선형 글꼴 크기 조정으로 앱 테스트

기기의 접근성 설정에서 최대 글꼴 크기를 사용 설정하여 앱을 테스트합니다.

이미 확장 가능 픽셀 (sp) 단위를 사용하여 텍스트 크기를 정의하는 경우 이러한 추가 옵션과 크기 조정 개선사항이 앱의 텍스트에 자동으로 적용됩니다. 하지만 앱이 글꼴 크기를 올바르게 적용하고 사용성에 영향을 미치지 않으면서 더 큰 글꼴 크기를 수용할 수 있는지 확인하려면 최대 글꼴 크기 (200%)를 사용 설정하여 UI 테스트를 실행해야 합니다.

200% 글꼴 크기를 사용 설정하려면 다음 단계를 따르세요.

  1. 설정 앱을 열고 접근성 > 디스플레이 크기 및 텍스트로 이동합니다.
  2. 글꼴 크기 옵션의 경우 이 섹션에 제공되는 이미지와 같이 최대 글꼴 크기 설정이 사용 설정될 때까지 더하기(+) 아이콘을 탭합니다.

텍스트 크기에 조정된 픽셀(sp) 단위 사용

항상 sp 단위로 텍스트 크기를 지정해야 합니다. 앱에서 sp 단위를 사용하면 Android에서는 사용자의 기본 텍스트 크기를 적용하고 적절하게 크기를 조정할 수 있습니다.

패딩에 sp 단위를 사용하거나 암시적 패딩을 가정하여 뷰 높이를 정의하지 마세요. 비선형 글꼴 크기 조정 sp 치수는 비례하지 않을 수 있으므로 4sp + 20sp가 24sp와 같지 않을 수 있습니다.

조정된 픽셀(sp) 단위 변환

TypedValue.applyDimension()을 사용하여 sp 단위에서 픽셀로 변환하고 TypedValue.deriveDimension()을 사용하여 픽셀을 sp로 변환합니다. 이러한 메서드는 적절한 비선형 크기 조정 곡선을 자동으로 적용합니다.

Configuration.fontScale 또는 DisplayMetrics.scaledDensity를 사용하여 수식을 하드코딩하지 마세요. 글꼴 크기 조정이 비선형이므로 scaledDensity 필드가 더 이상 정확하지 않습니다. 글꼴은 더 이상 단일 스칼라 값으로 확장되지 않으므로 fontScale 필드는 정보 제공 목적으로만 사용해야 합니다.

lineHeight에 sp 단위 사용

항상 dp 대신 sp 단위를 사용하여 android:lineHeight를 정의하여 행 간격이 텍스트와 함께 조정되도록 합니다. 그렇지 않고 텍스트가 sp인데 lineHeight가 dp 또는 px인 경우 크기가 조정되지 않고 답답해 보입니다. TextView는 의도한 비율이 유지되도록 lineHeight를 자동으로 수정하지만, textSize와 lineHeight가 모두 sp 단위로 정의된 경우에만 가능합니다.

카메라 및 미디어

이미지용 울트라 HDR

标准动态范围 (SDR) 与高动态范围 (HDR) 图片质量对比示意图。

Android 14 新增了对高动态范围 (HDR) 图片的支持，可在拍摄照片时保留更多来自传感器的信息，从而实现鲜艳的色彩和更高的对比度。Android 使用 Ultra HDR 格式，该格式与 JPEG 图片完全向后兼容，可让应用与 HDR 图片无缝互操作，并根据需要以标准动态范围 (SDR) 显示这些图片。

当您的应用选择为其 activity 窗口使用 HDR 界面（通过清单条目或通过在运行时调用 Window.setColorMode()）时，框架会自动在界面中以 HDR 格式渲染这些图片。您还可以在受支持的设备上拍摄压缩的 Ultra HDR 静态图片。从传感器中恢复的颜色越多，后期编辑的灵活性就越高。与 Ultra HDR 图片关联的 Gainmap 可用于使用 OpenGL 或 Vulkan 渲染这些图片。

카메라 확장 프로그램의 확대/축소, 초점, Postview 등

Android 14에서는 카메라 확장 프로그램을 업그레이드하고 개선하여 앱이 더 긴 처리 시간을 처리할 수 있도록 지원합니다. 이를 통해 지원되는 기기에서 저조도 사진과 같은 컴퓨팅 집약적인 알고리즘을 사용하여 이미지를 개선할 수 있습니다. 이러한 기능을 통해 사용자는 카메라 확장 기능을 사용할 때 더욱 강력한 환경을 경험할 수 있습니다. 이러한 개선사항의 예는 다음과 같습니다.

인센서 줌

当 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 目标搭配使用。通过实现请求替换控件，更新后的相机可让用户在其他相机控件准备就绪之前使用缩放控件。

무손실 USB 오디오

Android 14 支持无损音频格式，可通过 USB 有线耳机提供发烧友级体验。您可以查询 USB 设备的首选混音器属性，注册监听器以监听首选混音器属性的更改，以及使用 AudioMixerAttributes 类配置混音器属性。此类表示音频混音器的格式，例如声道掩码、采样率和行为。该类允许直接发送音频，而无需混音、调节音量或处理效果。

개발자 생산성 및 도구

인증 관리자

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 is an on-device repository for user health and fitness data. It allows users to share data between their favorite apps, with a single place to control what data they want to share with these apps.

On devices running Android versions prior to Android 14, Health Connect is available to download as an app on the Google Play store. Starting with Android 14, Health Connect is part of the platform and receives updates through Google Play system updates without requiring a separate download. With this, Health Connect can be updated frequently, and your apps can rely on Health Connect being available on devices running Android 14 or higher. Users can access Health Connect from the Settings in their device, with privacy controls integrated into the system settings.

Users can get started using Health Connect without a separate app download on devices running Android 14 or higher.
Users can control which apps have access to their health and fitness data through system settings.

Health Connect includes several new features in Android 14, such as exercise routes, allowing users to share a route of their workout which can be visualized on a map. A route is defined as a list of locations saved within a window of time, and your app can insert routes into exercise sessions, tying them together. To ensure that users have complete control over this sensitive data, users must allow sharing individual routes with other apps.

For more information, see the Health Connection documentation and the blogpost on What's new in Android Health.

OpenJDK 17 업데이트

Android 14 continues the work of refreshing Android's core libraries to align with the features in the latest OpenJDK LTS releases, including both library updates and Java 17 language support for app and platform developers.

The following features and improvements are included:

  • Updated approximately 300 java.base classes to Java 17 support.
  • Text Blocks, which introduce multi-line string literals to the Java programming language.
  • Pattern Matching for instanceof, which allows an object to be treated as having a specific type in an instanceof without any additional variables.
  • Sealed classes, which allow you restrict which classes and interfaces can extend or implement them.

Thanks to Google Play system updates (Project Mainline), over 600 million devices are enabled to receive the latest Android Runtime (ART) updates that include these changes. This is part of our commitment to give apps a more consistent, secure environment across devices, and to deliver new features and capabilities to users independent of platform releases.

Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

앱 스토어 개선사항

Android 14에서는 앱 스토어에서 사용자 환경을 개선할 수 있는 여러 PackageInstaller API를 도입했습니다.

다운로드하기 전에 설치 승인 요청

앱을 설치하거나 업데이트하려면 사용자 승인이 필요할 수 있습니다. 예를 들어 REQUEST_INSTALL_PACKAGES 권한을 사용하는 설치 프로그램이 새 앱을 설치하려고 할 때를 예로 들 수 있습니다. 이전 Android 버전에서는 APK가 설치 세션에 기록되고 세션이 커밋된 후에만 앱 스토어에서 사용자 승인을 요청할 수 있습니다.

Android 14부터 requestUserPreapproval() 메서드를 사용하면 설치 프로그램이 설치 세션을 커밋하기 전에 사용자 승인을 요청할 수 있습니다. 이러한 개선을 통해 사용자가 설치를 승인할 때까지 앱 스토어에서 APK 다운로드를 연기할 수 있습니다. 또한 사용자가 설치를 승인하면 앱 스토어는 사용자를 방해하지 않고 백그라운드에서 앱을 다운로드하여 설치할 수 있습니다.

향후 업데이트에 관한 책임 주장

setRequestUpdateOwnership() 메서드를 사용하면 설치 프로그램이 설치되는 앱의 향후 업데이트를 책임진다고 시스템에 알릴 수 있습니다. 이 기능은 업데이트 소유권 적용을 사용 설정합니다. 즉, 업데이트 소유자만 앱에 자동 업데이트를 설치할 수 있습니다. 업데이트 소유권 적용은 사용자가 예상되는 앱 스토어에서만 업데이트를 수신하도록 합니다.

업데이트를 설치하려면 INSTALL_PACKAGES 권한을 사용하는 설치 프로그램을 비롯한 다른 모든 설치 프로그램이 명시적인 사용자 승인을 받아야 합니다. 사용자가 다른 소스의 업데이트를 진행하기로 하면 업데이트 소유권이 손실됩니다.

방해가 되지 않는 시간에 앱 업데이트

앱 스토어는 일반적으로 활발히 사용되고 있는 앱은 업데이트하지 않으려고 합니다. 이 경우 앱의 실행 중인 프로세스가 종료되어 사용자가 하던 작업이 중단될 수 있기 때문입니다.

Android 14부터 InstallConstraints API를 사용하면 설치 프로그램이 적절한 시점에 앱 업데이트를 실행할 수 있습니다. 예를 들어 앱 스토어는 commitSessionAfterInstallConstraintsAreMet() 메서드를 호출하여 사용자가 더 이상 앱과 상호작용하지 않을 때만 업데이트가 커밋되도록 할 수 있습니다.

선택적 분할을 원활하게 설치

분할 APK를 사용하면 앱의 기능을 모놀리식 APK가 아닌 별도의 APK 파일로 제공할 수 있습니다. 분할 APK를 사용하면 앱 스토어에서 다양한 앱 구성요소의 전송을 최적화할 수 있습니다. 예를 들어 앱 스토어는 대상 기기의 속성을 기반으로 최적화할 수 있습니다. PackageInstaller API는 API 수준 22에 도입된 이후 분할을 지원했습니다.

Android 14에서 setDontKillApp() 메서드를 사용하면 설치 프로그램이 새 분할이 설치될 때 앱의 실행 중인 프로세스를 종료해서는 안 된다고 나타낼 수 있습니다. 앱 스토어는 이 기능을 사용하여 사용자가 앱을 사용하는 동안 앱의 새로운 기능을 원활하게 설치할 수 있습니다.

앱 메타데이터 번들

从 Android 14 开始，Android 软件包安装程序可让您指定应用元数据（例如数据安全做法），以在 Google Play 等应用商店页面上架。

사용자가 기기 스크린샷을 찍을 때 감지

To create a more standardized experience for detecting screenshots, Android 14 introduces a privacy-preserving screenshot detection API. This API lets apps register callbacks on a per-activity basis. These callbacks are invoked, and the user is notified, when the user takes a screenshot while that activity is visible.

사용자 환경

Sharesheet 맞춤 작업 및 개선된 순위 지정

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.

Screenshot of custom actions on the sharesheet.

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.

Direct Share row in the sharesheet, as shown by 1

뒤로 탐색 예측을 위한 내장 및 맞춤 애니메이션 지원

동영상: 뒤로 탐색 예측 애니메이션

Android 13에서는 개발자 옵션 뒤에 홈으로 이어지는 뒤로 탐색 예측 애니메이션이 도입되었습니다. 개발자 옵션이 사용 설정된 지원 앱에서 사용하면 뒤로 스와이프할 때 뒤로 동작이 앱에서 나와 다시 홈 화면으로 돌아갔음을 나타내는 애니메이션이 표시됩니다.

Android 14에는 뒤로 탐색 예측을 위한 여러 개선사항과 새로운 안내가 포함되어 있습니다.

이 Android 14 미리보기 출시에서는 뒤로 탐색 예측의 모든 기능이 개발자 옵션 뒤에 남아 있습니다. 뒤로 탐색 예측으로 앱을 이전하기 위한 개발자 가이드와 맞춤 인앱 전환 생성을 위한 개발자 가이드를 참고하세요.

대형 화면 기기 제조업체 앱별 재정의

앱별 재정의를 사용하면 기기 제조업체가 대형 화면 기기에서 앱의 동작을 변경할 수 있습니다. 예를 들어 FORCE_RESIZE_APP 재정의는 앱 매니페스트에 resizeableActivity="false"가 설정되어 있더라도 디스플레이 크기에 맞게 앱의 크기를 조절하도록 시스템에 지시합니다 (크기 호환성 모드 피하기).

재정의는 대형 화면에서 사용자 환경을 개선하기 위한 것입니다.

새 매니페스트 속성을 사용하면 앱에 대한 일부 기기 제조업체 재정의를 사용 중지할 수 있습니다.

대형 화면 사용자 앱별 재정의

앱별 재정의는 대형 화면 기기에서 앱의 동작을 변경합니다. 예를 들어 OVERRIDE_MIN_ASPECT_RATIO_LARGE 기기 제조업체 재정의는 앱 구성과 관계없이 앱 가로세로 비율을 16:9로 설정합니다.

Android 14 QPR1을 사용하면 사용자가 대형 화면 기기에서 새 설정 메뉴를 통해 앱별 재정의를 적용할 수 있습니다.

앱 화면 공유

借助应用界面共享功能，用户可以在录制屏幕内容时共享应用窗口，而不是整个设备屏幕。

在应用屏幕共享模式下，状态栏、导航栏、通知和其他系统界面元素会从共享显示屏中排除。系统只会分享所选应用的内容。

应用屏幕共享功能可让用户运行多个应用，但将内容共享限制为单个应用，从而提高工作效率并保护隐私。

Pixel 8 Pro의 Gboard에서 LLM 기반 스마트 답장

在搭载 12 月功能分块的 Pixel 8 Pro 设备上，开发者可以在 Gboard 中试用质量更高的智能回复，这些回复由在 Google Tensor 上运行的设备端大语言模型 (LLM) 提供支持。

此功能目前仅在 WhatsApp、Line 和 KakaoTalk 中以美式英语的形式提供给用户进行小范围测试。此功能需要使用 Pixel 8 Pro 设备，并将 Gboard 用作键盘。

如需试用此功能，请先依次前往设置 > 开发者选项 > AiCore 设置 > 启用 Aicore 持久性，启用该功能。

接下来，在受支持的应用中打开对话，即可在 Gboard 的建议栏中看到依托 LLM 的智能回复，以便回复收到的消息。

Gboard 利用设备端 LLM 提供更高质量的智能回复。

그래픽

경로를 쿼리하고 보간할 수 있음

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。

버텍스 및 프래그먼트 셰이더가 있는 맞춤 메시

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.

캔버스의 하드웨어 버퍼 렌더러

协助使用 Android 的 Canvas API 通过 硬件加速至 HardwareBuffer、Android 14 引入了 HardwareBufferRenderer。如果您的用例涉及通过 SurfaceControl 与系统合成器通信以实现低延迟绘制，此 API 特别有用。