chrome.app.runtime

คำอธิบาย

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

ประเภท

ActionData

Chrome 54 ขึ้นไป

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

  • actionType

    "new_note"

ActionType

Chrome 54 ขึ้นไป

แอปจะเปิดขึ้นได้โดยมีการดำเนินการบางอย่างอยู่ในใจ เช่น การสร้างโน้ตใหม่ ประเภทของการดำเนินการที่เปิดแอปจะพร้อมใช้งานในช่อง actionData จากอินสแตนซ์ LaunchData

ค่า

"new_note"

EmbedRequest

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

  • ข้อมูล

    ใดก็ได้ไม่บังคับ

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

  • embedderId

    สตริง

  • allow

    เป็นโมฆะ

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

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

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

    • URL

      สตริง

  • ปฏิเสธ

    เป็นโมฆะ

    ป้องกันไม่ให้ embedderId ฝังแอปนี้ใน <appview>

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

    () => {...}

LaunchData

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

  • actionData

    ActionData ไม่บังคับ

    Chrome 54 ขึ้นไป

    มีข้อมูลที่ระบุActionTypeที่แอปนี้เปิดตัว ค่านี้เป็นค่าว่างหากแอปไม่ได้เปิดตัวโดยมี Intent สำหรับการดำเนินการที่เฉพาะเจาะจง

  • id

    string ไม่บังคับ

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

  • isKioskSession

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

    ระบุว่าเปิดแอปในเซสชันคีออสก์ของ Chrome OS หรือไม่

  • isPublicSession

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

    Chrome 47 ขึ้นไป

    ระบุว่าแอปจะเปิดตัวในเซสชันสาธารณะของ Chrome OS หรือไม่

  • รายการ

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

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

  • referrerUrl

    string ไม่บังคับ

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

  • source

    LaunchSource ไม่บังคับ

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

  • URL

    string ไม่บังคับ

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

LaunchItem

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

  • รายการ

    รายการ

    รายการสำหรับรายการ

  • ประเภท

    string ไม่บังคับ

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

LaunchSource

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

ค่าแจกแจง

"ไม่ได้ติดตาม"

&quot;app_launcher&quot;

"new_tab_page"

"โหลดซ้ำ"

"รีสตาร์ท"

&quot;load_and_launch&quot;

"command_line"

&quot;file_handler&quot;

"url_handler"

"system_tray"

"about_page"

"keyboard"

&quot;extensions_page&quot;

"management_api"

&quot;ephemeral_app&quot;

"background"

"คีออสก์"

"chrome_internal"

"ทดสอบ"

&quot;installed_notification&quot;

&quot;context_menu&quot;

"arc"

&quot;intent_url&quot;

&quot;app_home_page&quot;

&quot;focus_mode&quot;

"sparky"

กิจกรรม

onEmbedRequested

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

เริ่มทำงานเมื่อแอปที่ฝังขอฝังแอปนี้ กิจกรรมนี้มีเฉพาะในเวอร์ชันที่กำลังพัฒนาที่มี Flag --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