Swelleye 應用程式只需幾個步驟，即可透過 Safari 的「加入主畫面」功能完成安裝。iPhone 與 iPad 均支援。

1. 開啟 Apple 內建瀏覽器 Safari（iOS 上無法透過 Chrome 或 Firefox 安裝應用程式）。
2. 前往 swelleye.com。
3. 點選畫面下方的分享按鈕（方形加上向上箭頭的圖示）。
4. 在分享選單中向下滑動，點選 "加入主畫面"。
5. 點選右上角的 "加入"。

應用程式的圖示將會出現在主畫面上，點選即可以全螢幕模式啟動應用程式——無網址列及瀏覽器分頁。

安裝完成後，請在應用程式內登入您的 Swelleye 帳號啟用推播通知。通知設定位於應用程式頁面的「推播通知」區塊。

Swelleye 應用程式可透過 Chrome（或任何現代 Android 瀏覽器）的「安裝應用程式」提示完成安裝。

1. 開啟 Chrome。
2. 前往 swelleye.com。
3. 點選右上角的選單按鈕（⋮），選擇 "安裝應用程式" 或 "加到主畫面"。
4. 確認 "安裝"。

若選單中沒有出現 "安裝應用程式"，請查看 Chrome 網址列是否有小型安裝圖示（通常看起來像螢幕或下載箭頭）。

Swelleye 應用程式的圖示將會出現在主畫面和應用程式清單中，點選即可以全螢幕模式啟動應用程式——無網址列及瀏覽器分頁。

安裝完成後，請登入您的 Swelleye 帳號以啟用推播通知。通知設定位於應用程式頁面的「推播通知」區塊。

每個帳號僅限使用一台裝置接收推播通知——即主設備。這可以是您的手機、平板、桌上型電腦，或目前日常使用 Swelleye 應用程式的任何裝置。

若您在第二台裝置（新手機、平板、電腦等）上安裝應用程式，該裝置將以唯讀模式顯示通知設定。您可以看到目前的設定內容，但無法進行變更。如需從新裝置管理設定，則須將其切換為主設備。

切換主設備的步驟：

1. 在您想設為主設備的裝置上開啟 Swelleye 應用程式。
2. 前往「應用程式設定」 區塊。
3. 點選「將此設為我的主設備」
4. 確認。

原主設備將自動切換為唯讀模式。

此限制的目的是避免通知重複發送至您的所有裝置。若無此限制，當您同時在手機和平板上安裝應用程式時，每天早上將會收到兩則相同的每日浪況通知。

應用程式內每種推播通知都有各自的開啟 / 關閉按鈕。

1. 開啟 Swelleye 應用程式。
2. 滑動至「推播通知」區塊。
3. 展開管理通知的選項：
   • 每日目前浪況報告
   • 每日浪況的截圖
   • 颱風追蹤器
   • 直播恢復
4. 點取選項內的「開啟」或「關閉」按鈕。

您也可以從裝置的系統設定中完全停用通知：

• iPhone：設定 → 通知 → Swelleye → 允許通知（關閉切換）
• Android：設定 → 應用程式 → Swelleye → 通知 → 允許通知（關閉切換）

注意：在手機/平板系統層級關閉通知會覆蓋應用程式內的個別選項控制。若您已在系統層級停用 Swelleye 的通知，則應用程式內的開啟按鈕將不會生效，直到重新啟用系統通知為止。

若您已在應用程式內啟用某項通知但仍未收到，請依序確認以下項目：

1. 確認應用程式內的通知已開啟。 展開「推播通知」下的對應選項，確認按鈕顯示「關閉」（表示通知目前已開啟）。
2. 確認系統通知已允許。 檢查 iPhone 設定 → 通知 → Swelleye，或 Android 設定 → 應用程式 → Swelleye → 通知。允許通知必須開啟。
3. 確認目前使用的是主設備。 Swelleye 僅會將通知發送至您的主設備。若您最近在新手機或平板上安裝了應用程式，該裝置可能尚未設定為主設備。請參閱上方「什麼是主要裝置上限？」。
4. 確認您已登入有效的 Swelleye 帳號（註冊時所使用的電件郵件地址）。推播通知需要登入有效的 Swelleye 帳號，請點選應用程式內的個人檔案按鈕確認。
5. 確認「推播通知」設定完成。「每日目前浪況報告」與「直播恢復」知至少需選擇一個浪點；「目前浪況的截圖」則需選擇浪點並設定推播時間。
6. 發送排程時間。「每日目前浪況報告」和「目前浪況的截圖」會根據您選擇的時間固定發送。「直播恢復」與「颱風追蹤器」，將依實際情況發送。
7. 確認「勿擾模式或專注模式」已關閉， 並且將 Swelleye 加入允許清單。勿擾模式下，通知可能會無聲發送且不會出現於鎖定畫面。

如以上項目確認後仍無法接收推播通知，請使用下方的「聯絡我們 / 應用程式回饋」 表單，並提供以下資訊：

• 您註冊 Swelleye 帳號的電子郵件地址。
• 使用的裝置型號 + 系統版本（例如：「iPhone 15 Pro, iOS 17.5」）。
• 缺少的推播通知項目。
• 最後一次收到該項目推播通知的時間（如果曾收到的話）。

每種通知都有各自的開啟設定，部分通知有其他的限制規則：

• 在「應用程式設定」中分別檢查各項通知的開關。 每日目前浪況報告、每日浪況的截圖、颱風追蹤器與直播恢復通知各自擁有獨立的「開啟 / 關閉」按鈕，關閉其中一項不會影響其他項目。
• iPhone 無法接收每日浪況的截圖。 iOS 不允許應用程式在推播通知中嵌入遠端圖片，因此無法顯示每日浪況的截圖 (請參考下方 iPhone 圖片說明)。iPhone 用戶完全收不到每日浪況的截圖推播；這是系統的限制，並非錯誤。
• iPhone 的颱風追蹤器為純文字（不含颱風路徑圖。與上方所述的 iOS 限制相同）。通知內容仍會顯示颱風更新資訊，並提供 APP 中颱風追蹤器的連結。
• 颱風追蹤器僅在您啟用的時段發送。 您可以任意選擇在台灣時間 03:00、09:00、15:00、21:00 接收通知。若您於設定中關閉某時段，將不會於該時段收到通知。海上及陸上颱風警報的發布／解除通知仍會發送，不受時段設定影響。
• 浪點直播恢復通知。 僅可收到您自訂的浪點的通知，請參考下方「直播恢復」說明。

這是正常現象，通常代表您的通知端點（endpoint）已過期失效。

所有安裝 Swelleye 應用程式的裝置都有一個專屬的推播端點（push endpoint），也就是伺服器用來發送通知的位址。端點可能隨時間或長時間未開啟應用程式而過期。一旦過期，伺服器仍會嘗試發送，但通知會在無聲中遺失。

開啟應用程式後，系統會喚醒背景助手（即「Service Worker」），讓通知功能重新開始運作。Service Worker 會檢查通知端點是否仍然有效，若已過期則自動更新，同時清除暫時的「彈跳」標記。完成後，通知即可恢復正常發送。

若您發現通知在一兩天未開啟應用程式後又再次停止發送 ，可能是手機把瀏覽器置於深度休眠模式，導致背景推播功能受到限制。請參考下一則 Samsung / Android 的解決方式，或養成每天至少打開一次應用程式的習慣，讓端點維持有效。

Samsung 手機（以及部分其他 Android 廠牌）採用了較積極的省電機制：當 Chrome 長時間未使用時，系統可能會在背景將其置於休眠狀態。 Chrome 處於休眠狀態時，手機雖然會接收來自 Swelleye 的推播通知，但系統會在顯示前直接將通知捨棄，因此通知不會出現在鎖定畫面，也不會跳出提醒，而打開應用程式會喚醒 Chrome，這就是通知會立刻恢復的原因。

若要避免 Samsung 手機發生此情況：

1. 開啟 設定 → 電池 → 背景使用限制 → 休眠應用程式。
2. 若 Chrome 出現在 休眠應用程式 或 深度休眠應用程式 清單中，請將它從兩處移除。
3. 同時請檢查 設定 → 應用程式 → Chrome → 電池，並設定為 不受限（預設為「最佳化」可能會限制背景活動）。

其他 Android 手機亦有類似的電池最佳化設定，名稱不盡相同。可尋找「電池最佳化」、「背景活動」或「允許背景數據」中對 Chrome 的相關設定。

是的。iPhone 上的 Swelleye 推播通知只在應用程式被加入主畫面且至少從主畫面圖示啟動過一次之後才會生效。僅在 Safari 分頁中瀏覽 swelleye.com 是不夠的，iOS 不會將推播發送至 Safari 分頁。

若您原本在 Safari 分頁中使用 Swelleye 並想啟用推播通知：

1. 在 Safari 開啟 swelleye.com。
2. 點選畫面下方的 分享 按鈕（方形加上向上箭頭的圖示）。
3. 向下捲動點選 「加入主畫面」，再點選右上角的 「加入」。
4. 關閉 Safari，並從主畫面圖示首次開啟 Swelleye 應用程式。
5. 當系統詢問時，請允許通知權限。

安裝完成並授權通知後，推播通知就會開始發送。

iPhone 的端點同樣可能在長時間未開啟應用程式時停止推播通知。若通知停止推播，請從主畫面圖示打開一次應用程式即可，與 Android 採用相同的喚醒方式與刷新機制。

iPhone 不允許加入主畫面安裝的網頁應用程式（這也是 Swelleye 在 iPhone 上的安裝方式）在推播通知中嵌入遠端圖片。這是 iOS 系統層級的限制，所有加入主畫面安裝的網頁應用程式（不只是 Swelleye）皆會受到相同限制。

實際影響如下：

• 每日浪況的截圖：此通知的核心內容是浪況截圖。由於 iPhone 無法顯示，因此完全不會發送至 iPhone。Android 用戶則可以在通知內容中看到截圖。
• 颱風追蹤器：由於 iOS 通知圖片限制，此通知不含颱風路徑圖。但通知內容仍會顯示颱風更新資訊，並提供 APP 中颱風追蹤器的連結。

若 iPhone 日後解除此限制，我們會立即為 iPhone 加上圖片支援。在此之前，僅 Android 系統能夠在通知中顯示每日浪況的截圖與颱風追蹤器圖片。

「直播恢復」通知有幾項特定規則，同時也可以解釋幾乎所有「沒收到通知」的情況：

• 必須已選擇該浪點。 浪點清單依使用者個別設定。首次啟用時預設為「所有浪點」，但您可在「應用程式設定」中依個人喜好調整。若恢復上線通知的浪點不在您的選擇中，您將不會收到該浪點的通知。
• 直播必須真正由離線轉為上線。 若您啟用通知時直播本來就已上線，那麼您將不會收到通知。須等到下次離線 → 上線循環才會發送。
• 直播恢復通知於 60 秒內發送。 直播恢復上線後，通知應在 60 秒內送達您的手機。不過根據您手機的設定，您可能要等到開啟或喚醒螢幕時才會看到通知。

若您已選擇浪點、直播也確實由離線轉為上線，但仍未收到推播，請使用「聯絡我們 / 應用程式回饋」表單，並附上浪點名稱與您預期收到通知的時間。

PRO 訂閱到期後，推播通知仍會有一段短暫的緩衝期繼續發送，緩衝期約為 8 小時（台灣時間）。這是設計上的選擇而非錯誤，我們不希望您因為半夜 3 點到期的訂閱，而錯過當日早晨的每日浪況報告。

緩衝期結束後（通常為訂閱到期翌日的台灣時間中午），PRO 檢查就會啟動，該帳號的推播通知便會停止（除非您再次購買 PRO 訂閱）。

若您是不小心取消，希望繼續接收推播通知，可隨時於「我的帳號」頁面重新訂閱。重新訂閱無等待期，立即生效。