chrome.app.runtime

คำอธิบาย

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

ประเภท

ActionData

Chrome 54 ขึ้นไป

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

  • actionType

    "new_note"

ActionType

Chrome 54 ขึ้นไป

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

ค่า

"new_note"

EmbedRequest

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

  • ข้อมูล

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

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

  • embedderId

    string

  • allow

    void

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

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

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

    • url

      string

  • ปฏิเสธ

    void

    ป้องกันไม่ให้ 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 หรือไม่

  • items

    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 ดังนั้นไม่ควรเรียงลำดับใหม่หรือนำรายการออก

ค่าแจกแจง

"app_launcher"

"new_tab_page"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"keyboard"

"extensions_page"

"management_api"

"ephemeral_app"

"background"

"chrome_internal"

"arc"

"intent_url"

"app_home_page"

"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