创建笔记应用

笔记功能是 Android 的核心功能，可增强用户在大屏幕设备上的生产力。笔记应用使用户能够在浮动窗口或全屏中进行书写和绘图，捕获和注释屏幕内容，以及保存笔记以供日后查看和修订。

用户可以从锁定屏幕或在运行其他应用时访问笔记应用。

对笔记的触控笔支持提供了卓越的用户体验。

笔记角色

“RoleManager.ROLE_NOTES” 角色用于识别记笔记应用，并授予其 LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE 权限。

要为您的应用获取笔记角色，请执行以下操作

调用 isRoleAvailable() 检查角色的状态。
如果笔记角色可用，则调用 createRequestRoleIntent() 获取特定于笔记的 Intent。
使用笔记 Intent 调用 startActivityForResult() 以提示用户授予您的应用笔记角色。

只有一个应用可以拥有笔记角色。

应用会响应隐式 ACTION_CREATE_NOTE Intent 操作而打开。如果从设备锁定屏幕调用，则应用会全屏打开；如果在屏幕解锁时调用，则会在浮动窗口中打开。

应用清单

要符合笔记角色的资格，您的应用必须在应用清单中包含以下声明

<activity
    android:name="YourActivityName"
    android:exported="true"
    android:showWhenLocked="true"
    android:turnScreenOn="true">
    <intent-filter>
        <action android:name="android.intent.action.CREATE_NOTE" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

此声明允许用户将笔记角色分配给您的应用，使其成为默认的记笔记应用

ACTION_CREATE_NOTE 将 Intent 操作设置为您的应用响应的操作
showWhenLocked 使您的应用可从设备锁定屏幕访问
turnScreenOn 使您的应用能够在应用运行时打开设备屏幕

应用功能

大型屏幕差异化的记笔记应用提供了全套的记笔记功能。

触笔支持

当您的应用使用 EXTRA_USE_STYLUS_MODE Intent 附加信息设置为 true 调用时，应用应打开一个接受触笔（或手指触摸）输入的笔记。

如果 Intent 附加信息设置为 false，则您的应用应打开一个接受键盘输入的笔记。

锁定屏幕访问

您的应用必须提供一个全屏 Activity，当应用从设备锁定屏幕打开时运行。

如果用户已同意（在解锁设备状态下）显示过去的笔记，则您的应用应仅显示历史笔记。否则，当从锁定屏幕打开时，您的应用应始终创建新笔记。

您可以使用 KeyguardManager#isKeyguardLocked() 检查您的应用是否是从锁定屏幕启动的。要要求用户进行身份验证并解锁设备，请调用 KeyguardManager#requestDismissKeyguard()

val keyguardManager =
getSystemService(KEYGUARD_SERVICE) as KeyguardManager
keyguardManager.requestDismissKeyguard(  this, object :
KeyguardDismissCallback() {  override fun onDismissError() {  // Unlock failed.
Dismissing keyguard is not feasible.  }  override fun onDismissSucceeded() {  //
Unlock succeeded. Device is now unlocked.  }  override fun onDismissCancelled()
{  // Unlock failed. User cancelled operation or request otherwise cancelled.  }
 } )

浮动窗口

对于情境记笔记，您的应用必须提供一个在另一个应用运行时在浮动窗口中打开的 Activity。

您的应用应支持 multi-instance 模式，以便用户即使在您的记笔记应用以全屏或分屏模式启动时，也可以在多个浮动窗口中创建多个笔记。

内容捕获

内容捕获是记笔记应用的关键功能。通过内容捕获，用户可以截取记笔记应用浮动窗口后面的显示屏的屏幕截图。用户可以捕获全部或部分显示屏，将内容粘贴到他们的笔记中，并对捕获的内容进行注释或突出显示。

您的记笔记应用应提供一个 UI 控件，该控件启动由 registerForActivityResult() 创建的 ActivityResultLauncher。 ACTION_LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE Intent 操作直接或通过 ActivityResultContract 提供给启动器。

系统 Activity 会捕获内容，将其保存在设备上，并在 registerForActivityResult() 的回调参数中将内容 URI 返回到您的应用。

以下示例使用通用的 StartActivityForResult 合同

private val startForResult =
registerForActivityResult(  ActivityResultContracts.StartActivityForResult()) {
 result: ActivityResult ->  if (result.resultCode ==
Intent.CAPTURE_CONTENT_FOR_NOTE_SUCCESS) {  val uri = result.data?.data  // Use
the URI to paste the captured content into the note.  }  } override fun
onCreate(savedInstanceState: Bundle?) {  super.onCreate(savedInstanceState)
setContent {  NotesTheme {  Surface(color =
MaterialTheme.colorScheme.background) {  CaptureButton(  onClick = {
Log.i("ContentCapture", "Launching intent...")
startForResult.launch(Intent(ACTION_LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE))
})  }  }  } } @Composable fun CaptureButton(onClick: () -> Unit) {
Button(onClick = onClick)
 {Text("Capture Content")} }

您的应用应处理所有结果代码

当内容捕获成功时，将捕获的图像粘贴到笔记中，例如

registerForActivityResult(ActivityResultContracts.StartActivityForResult()) {
 result: ActivityResult ->  if (result.resultCode ==
Intent.CAPTURE_CONTENT_FOR_NOTE_SUCCESS) {  val uri = result.data?data  // Use
the URI to paste the captured content into the note.  } }

只有当您的记笔记应用在浮动窗口中运行时（而不是以全屏模式运行或从设备锁定屏幕启动时），才应通过 UI 控件公开内容捕获功能。（用户可以使用设备屏幕截图功能截取记笔记应用本身的屏幕截图。）

要确定您的应用是否位于浮动窗口（或气泡）中，请调用以下方法

isLaunchedFromBubble() 检查您的记笔记应用是否不是从设备锁定屏幕以全屏模式启动的
isRoleHeld(RoleManager.ROLE_NOTES) 验证您的应用是否为默认的记笔记应用（如果应用不持有笔记角色，则您的应用可以在对话或其他类型的泡泡中运行）

其他资源

获取 Activity 的结果

上一个

高级触笔功能