chrome.app.runtime

คำอธิบาย

ใช้ chrome.app.runtime API เพื่อจัดการวงจรของแอป รันไทม์ของแอปจะจัดการการติดตั้งแอป ควบคุมหน้ากิจกรรม และปิดแอปได้ทุกเมื่อ

ประเภท

EmbedRequest

พร็อพเพอร์ตี้

  • เพิ่มเติม

    ไม่บังคับ

    ข้อมูลที่นักพัฒนาแอประบุ (ไม่บังคับ) ซึ่งแอปที่จะฝังสามารถใช้ได้เมื่อตัดสินใจฝัง

  • embedderId

    สตริง

  • allow

    void

    อนุญาตให้ embedderId ฝังแอปนี้ในองค์ประกอบ <appview> url ระบุเนื้อหาที่จะฝัง

    ฟังก์ชัน allow จะมีลักษณะดังนี้ 

    (url: string) => {...}

    • URL

      สตริง

  • ปฏิเสธ

    void

    ป้องกันไม่ให้ embedderId ฝังแอปนี้ในองค์ประกอบ <appview>

    ฟังก์ชัน deny จะมีลักษณะดังนี้ 

    () => {...}

LaunchData

พร็อพเพอร์ตี้

  • id

    สตริง ไม่บังคับ

    รหัสของไฟล์หรือเครื่องมือจัดการ URL ที่ใช้เรียกใช้แอป รหัสเครื่องจัดการคือคีย์ระดับบนสุดในพจนานุกรม file_handlers และ/หรือ url_handlers ในไฟล์ Manifest

  • isKioskSession

    บูลีน ไม่บังคับ

    แอปเปิดในเซสชันคีออสก์ของ ChromeOS หรือไม่

  • isPublicSession

    บูลีน ไม่บังคับ

    Chrome 47 ขึ้นไป

    แอปเปิดขึ้นในเซสชันสาธารณะของ ChromeOS หรือไม่

  • รายการ

    LaunchItem[] ไม่บังคับ

    รายการไฟล์สำหรับเหตุการณ์ onLaunched ที่ทริกเกอร์โดยเครื่องจัดการไฟล์ที่ตรงกันในคีย์ไฟล์ Manifest file_handlers

  • referrerUrl

    สตริง ไม่บังคับ

    URL ที่มาของเหตุการณ์ onLaunched ที่ทริกเกอร์โดยเครื่องจัดการ URL ที่ตรงกันในคีย์ไฟล์ Manifest url_handlers

  • source

    LaunchSource ไม่บังคับ

    ตำแหน่งที่เปิดแอป

  • URL

    สตริง ไม่บังคับ

    URL สำหรับเหตุการณ์ onLaunched ที่ทริกเกอร์โดยเครื่องมือจัดการ URL ที่ตรงกันในคีย์ไฟล์ Manifest url_handlers

LaunchItem

พร็อพเพอร์ตี้

  • entry

    รายการ

    รายการสำหรับสินค้า

  • ประเภท

    สตริง ไม่บังคับ

    ประเภท MIME ของไฟล์

LaunchSource

การแจกแจงแหล่งที่มาของการเปิดแอป ควรซิงค์ข้อมูลนี้กับ AppLaunchSource ใน components/services/app_service/public/mojom/types.mojom และ GetLaunchSourceEnum() ใน extensions/browser/api/app_runtime/app_runtime_api.cc โปรดทราบว่าระบบจะใช้การแจงนับในฮิสโตแกรม UMA ดังนั้นจึงไม่ควรจัดเรียงใหม่หรือนำรายการออก

ค่าแจกแจง

"untracked"

"app_launcher"

"new_tab_page"

"reload"

"restart"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"keyboard"

"extensions_page"

"management_api"

"ephemeral_app"

"background"

"kiosk"

"chrome_internal"

"test"

"installed_notification"

"context_menu"

"arc"

"intent_url"

"app_home_page"

"focus_mode"

"sparky"

กิจกรรม

onEmbedRequested

chrome.app.runtime.onEmbedRequested.addListener(
  callback: function,
)

เริ่มทำงานเมื่อแอปที่ฝังขอฝังแอปนี้ เหตุการณ์นี้ใช้ได้เฉพาะในเวอร์ชันที่กำลังพัฒนาซึ่งมีแฟล็ก --enable-app-view

พารามิเตอร์

  • callback

    ฟังก์ชัน

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    (request: EmbedRequest) => void

onLaunched

chrome.app.runtime.onLaunched.addListener(
  callback: function,
)

เริ่มทำงานเมื่อมีการเปิดแอปจาก Launcher

พารามิเตอร์

  • callback

    ฟังก์ชัน

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    (launchData?: LaunchData) => void

    • launchData

      LaunchData ไม่บังคับ

onRestarted

chrome.app.runtime.onRestarted.addListener(
  callback: function,
)

เริ่มทำงานเมื่อ Chrome เริ่มต้นระบบไปยังแอปที่ทำงานอยู่เมื่อ Chrome ปิดตัวลงครั้งล่าสุด หรือเมื่อมีการขอให้แอปรีสตาร์ทจากสถานะก่อนหน้าด้วยเหตุผลอื่นๆ (เช่น เมื่อผู้ใช้เพิกถอนสิทธิ์เข้าถึงไฟล์ที่เก็บไว้ของแอป รันไทม์จะรีสตาร์ทแอป) ในสถานการณ์เหล่านี้ หากแอปไม่มีแฮนเดิล onRestarted ระบบจะส่งเหตุการณ์ onLaunched ไปให้แทน

พารามิเตอร์

  • callback

    ฟังก์ชัน

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    () => void