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การเปิดใช้แอปนี้ ค่าจะเป็น Null หากแอปไม่ได้เปิดใช้งานโดยมีเจตนาที่จะดําเนินการอย่างใดอย่างหนึ่ง

• 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 ในองค์ประกอบ/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"

"extensions_page"

"management_api"

"chrome_internal"

"installed_notification"

"arc"

"intent_url"

"app_home_page"

กิจกรรม

onEmbedRequested

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

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

พารามิเตอร์

• Callback

  ฟังก์ชัน

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

  (request: EmbedRequest)=>void

  • ส่งคำขอ

    EmbedRequest

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