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 ที่ใช้เปิดแอปนี้ ค่านี้จะว่างเปล่าหากไม่ได้เปิดแอปโดยมีเจตนาดำเนินการที่เฉพาะเจาะจง

  • id

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

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

  • isKioskSession

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

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

  • isPublicSession

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

    Chrome 47 ขึ้นไป

    แอปกำลังเปิดในเซสชันสาธารณะของ Chrome OS หรือไม่

  • รายการ

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

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

  • referrerUrl

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

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

  • source

    LaunchSource ไม่บังคับ

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

  • URL

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

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

LaunchItem

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

  • รายการ

    รายการ

    รายการของสินค้า

  • ประเภท

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

    ประเภท 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,
)

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    (request: EmbedRequest) => void

onLaunched

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

เริ่มทํางานเมื่อเปิดแอปจากตัวเปิด

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    (launchData?: LaunchData) => void

    • launchData

      LaunchData ไม่บังคับ

onRestarted

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    () => void