Handler API را راه اندازی کنید

برای مشخص کردن رفتار راه‌اندازی برنامه خود، عضو مانیفست launch_handler به مانیفست خود اضافه کنید. یک زیر فیلد به نام client_mode دارد. این به شما امکان می‌دهد کنترل کنید که آیا یک کلاینت جدید یا موجود باید راه‌اندازی شود و آیا این کلاینت باید هدایت شود. مثال زیر فایلی را با مقادیر نمونه نشان می دهد که همیشه همه راه اندازی ها را به یک کلاینت جدید هدایت می کند.

{
  "launch_handler": {
    "client_mode": "navigate-new"
  }
}

اگر مشخص نشده باشد، launch_handler پیش‌فرض {"client_mode": "auto"} است. مقادیر مجاز برای زیر فیلدها عبارتند از:

• client_mode :
  • navigate-new : یک زمینه مرور جدید در پنجره برنامه وب ایجاد می‌شود تا URL هدف راه‌اندازی بارگیری شود.
  • navigate-existing : جدیدترین موردی که با زمینه مرور در یک پنجره برنامه وب تعامل داشته است به URL هدف راه اندازی هدایت می شود.
  • focus-existing : جدیدترین موردی که با زمینه مرور در یک پنجره برنامه وب تعامل داشته است برای مدیریت راه اندازی انتخاب شده است. یک شی LaunchParams جدید که targetURL آن روی URL راه‌اندازی تنظیم شده است در window.launchQueue سند قرار می‌گیرد.launchQueue.
  • auto : این رفتار به عامل کاربر بستگی دارد که تصمیم بگیرد چه چیزی برای پلتفرم بهتر است. به عنوان مثال، دستگاه‌های تلفن همراه فقط از کلاینت‌های منفرد پشتیبانی می‌کنند و از existing-client استفاده می‌کنند، در حالی که دستگاه‌های دسک‌تاپ از چندین پنجره پشتیبانی می‌کنند و از navigate-new برای جلوگیری از از دست رفتن داده‌ها استفاده می‌کنند.

ویژگی client_mode نیز یک لیست (آرایه) از مقادیر را می پذیرد که در آن اولین مقدار معتبر استفاده می شود. این اجازه می دهد تا مقادیر جدیدی به مشخصات اضافه شود بدون اینکه سازگاری با پیاده سازی های موجود را به هم بزند.

به عنوان مثال، اگر مقدار فرضی "focus-matching-url" اضافه شود، سایت ها "client_mode": ["focus-matching-url", "navigate-existing"] تا همچنان رفتار مرورگرهای قدیمی را کنترل کنند که از "focus-matching-url" پشتیبانی نمی کنند.

if ('launchQueue' in window) {
  launchQueue.setConsumer((launchParams) => {
    if (launchParams.targetURL) {
      const songID = extractSongId(launchParams.targetURL);
      if (songID) {
        playSong(songID);
      }
    }
  });
}