說明
使用 chrome.app.runtime
API 管理應用程式的生命週期。應用程式執行階段會管理應用程式安裝、控制事件頁面,並可隨時關閉應用程式。
類型
ActionData
屬性
-
actionType
"new_note"
ActionType
您可以選擇要啟動應用程式來啟動特定動作,例如建立新記事。您可以透過 LaunchData 執行個體的 actionData
欄位,找到啟動應用程式的動作類型。
值
"new_note"
EmbedRequest
屬性
-
資料或曾存取這類資料的人員
任何選填
選用的開發人員指定的資料,供應用程式在做出嵌入決定時使用。
-
embedderId
字串
-
allow
void
允許
embedderId
將這個應用程式嵌入 <appview> 元素。url
會指定要嵌入的內容。allow
函式如下所示:(url: string)=> {...}
-
網址
字串
-
-
deny
void
禁止
embedderId
將這個應用程式嵌入 <appview> 元素。deny
函式如下所示:()=> {...}
LaunchData
屬性
-
actionData
ActionData 選用
Chrome 54 以上版本包含的資料指出用於啟動這個應用程式的
ActionType
。如果應用程式未使用特定動作意圖啟動,此值會是空值。 -
id
字串 選用
用於叫用應用程式的檔案或網址處理常式的 ID。處理常式 ID 是資訊清單中
file_handlers
和/或url_handlers
字典中的頂層鍵。 -
isKioskSession
布林值 (選用)
應用程式是否在 Chrome 作業系統資訊站工作階段中啟動。
-
isPublicSession
布林值 (選用)
Chrome 47 以上版本應用程式是否在 Chrome 作業系統公開工作階段中啟動。
-
items
LaunchItem[] 選用
onLaunched
事件的檔案項目,由file_handlers
資訊清單檔案中的相符檔案處理常式觸發。 -
referrerUrl
字串 選用
onLaunched
事件的參照網址,由url_handlers
資訊清單金鑰中的相符網址處理常式觸發。 -
來源
LaunchSource 選用
啟動應用程式的來源。
-
網址
字串 選用
onLaunched
事件的網址,由url_handlers
資訊清單索引鍵中的相符網址處理常式觸發。
LaunchItem
屬性
-
項目
項目
項目項目。
-
類型
字串 選用
檔案的 MIME 類型。
LaunchSource
應用程式啟動來源的列舉。這項指令應與 Component/services/app_service/public/mojom/types.mojom 中的 AppLaunchSource 和 Extensions/browser/api/app_runtime/app_runtime_api.cc 中的 GetLaunchSourceEnum() 保持同步。請注意,列舉功能用於 UMA 直方圖,因此項目不應重新排序或移除。
列舉
"app_launcher"
"new_tab_page"
"load_and_launch"
"command_line"
"file_handler"
"url_handler"
"system_tray"
"about_page"
"extensions_page"
"management_api"
"chrome_internal"
"arc"
"intent_url"
"focus_mode"
活動
onEmbedRequested
chrome.app.runtime.onEmbedRequested.addListener(
callback: function,
)
當嵌入應用程式要求嵌入這個應用程式時觸發。這個事件僅適用於帶有旗標 --enable-app-view 的開發人員頻道。
參數
-
回呼
功能
callback
參數如下所示:(request: EmbedRequest)=>void
-
申請。
-
onLaunched
chrome.app.runtime.onLaunched.addListener(
callback: function,
)
透過啟動器啟動應用程式時觸發。
參數
-
回呼
功能
callback
參數如下所示:(launchData?: LaunchData)=>void
-
launchData
LaunchData 選用
-
onRestarted
chrome.app.runtime.onRestarted.addListener(
callback: function,
)
當 Chrome 上次關閉時執行的應用程式,或是基於其他原因提出要求,讓應用程式從先前的狀態重新啟動 (例如使用者撤銷應用程式保留檔案的存取權時),會在 Chrome 啟動時啟動該應用程式。在這類情況下,如果應用程式沒有 onRestarted
處理常式,就會改為傳送 onLaunched
事件。
參數
-
回呼
功能
callback
參數如下所示:()=>void