本頁面由 Cloud Translation API 翻譯而成。

建立筆記應用程式

記事應用程式是 Android 的核心功能，可以提高使用者在各種平台上的工作效率大螢幕裝置。記事應用程式可讓使用者在擷取畫面內容並加上註解並儲存筆記，以便日後檢查及修改

記事應用程式可以從螢幕鎖定畫面存取，也可以在執行其他操作時存取應用程式。

支援使用觸控筆做記事，帶來卓越的使用者體驗。

「記事」角色

RoleManager.ROLE_NOTES敬上可識別記事應用程式，並授予 LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE。權限。

如要取得應用程式的記事角色，請按照下列步驟操作：

呼叫 isRoleAvailable() 檢查角色狀態
如果有記事角色可用，請呼叫 createRequestRoleIntent() 以便獲得記事專屬的意圖
呼叫 startActivityForResult() 附註意圖，提示使用者授予記事角色應用程式。

只有一個應用程式可擁有記事角色。

應用程式開啟以回應隱含 ACTION_CREATE_NOTE敬上意圖動作如果從裝置螢幕鎖定畫面叫用，應用程式會完整開啟螢幕；會在螢幕解鎖時叫用。

應用程式資訊清單

應用程式必須加入下列宣告，才能使用記事角色：

<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敬上設定應用程式回應的意圖動作
showWhenLocked敬上方便您從裝置螢幕鎖定畫面存取您的應用程式
turnScreenOn 啟用應用程式，在應用程式執行時開啟裝置螢幕

應用程式功能

一款與眾不同的應用程式，提供完善的記事應用程式像是筆記功能

觸控筆支援

使用 EXTRA_USE_STYLUS_MODE敬上意圖額外項目設為 true，應用程式應開啟接受觸控筆的記事 (或。

如果意圖 Extra 設為 false，應用程式應開啟一則記事，表示接受鍵盤輸入。

螢幕鎖定畫面存取權

您的應用程式必須提供全螢幕活動，在啟動應用程式時執行並在裝置螢幕鎖定畫面上開啟相關檔案。

只有在使用者同意時 (在解鎖裝置狀態) 來顯示過往的記事。否則當您從以下位置開啟檔案時螢幕鎖定時，應用程式應一律建立新記事。

您可以使用下列程式碼，檢查應用程式是否已從螢幕鎖定畫面啟動 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.  }
 } )

浮動視窗

針對上下文的記事，您的應用程式必須提供可在浮動視窗

您的應用程式必須支援 multi-instance敬上模式讓使用者可以在多個浮動視窗中建立多則記事系統以全螢幕模式啟動記事應用程式，或在分割畫面中啟動記事應用程式模式。

內容擷取

內容擷取是記事應用程式的重要功能，包含內容可讓使用者擷取記事背後的螢幕畫面浮動視窗。使用者可以擷取全部或部分內容，並將編輯擷取的內容，並加上註解或醒目顯示擷取的內容。

記事應用程式應提供 UI 預設用途，啟動 ActivityResultLauncher敬上建立者： registerForActivityResult()。 ACTION_LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE敬上意圖動作是直接或透過 ActivityResultContract。

系統活動會擷取內容並將其儲存在裝置上，然後將內容 URI registerForActivityResult()。

以下範例使用通用 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)敬上，驗證您的應用程式是否為預設的記事應用程式 (您的應用程式可以在對話或其他類型的對話框中，如果應用程式沒有回應記事角色)

，瞭解如何調查及移除這項存取權。

其他資源

取得活動結果

進階觸控筆功能

關於 Ink API