匯出報告與分享你的資料

匯出報告面板

匯出報告面板是主要的匯出工具。它會把你的資料整理成 CSV 試算表檔案，放進單一個 ZIP 壓縮檔，並可選擇一併附上錄音。要開啟它，先切換到你想匯出的那一夜，點一下打鼾事件清單頂端的下載圖示，再開啟匯出報告。

在面板中，你要做兩個選擇：

• 日期範圍。從三個預設選項中擇一：最近 7 天、最近 30 天或全部時間。範圍決定報告涵蓋多少 CSV 資料。
• 類別。切換要納入哪些類型的資料。每個類別都會成為 ZIP 中各自獨立的 CSV 檔案：
  • 每夜摘要：每一夜的彙總統計。
  • 睡眠階段：隨時間變化的睡眠階段，來自手機與手錶兩種來源。
  • 偵測到的事件：打鼾、夢話、咳嗽、喘氣，以及呼吸中斷。
  • 手錶生理數據：來自已連接 Apple Watch 的心率、HRV、SpO2 與呼吸速率。
  • 錄音（選用）：各事件片段、整夜錄音，或兩者皆有。

這裡有一個細節很重要：即使你為 CSV 資料選了較廣的日期範圍，錄音也只涵蓋你目前正在檢視的那一夜。這能讓報告大小維持在可控範圍，因為一整週的連續錄音會遠遠蓋過試算表。App 會在產生報告前先顯示大小估計值。

需要多久，以及如何取消

匯出進行時，App 會顯示從 0 到 100 % 的進度，並搭配狀態訊息，例如「正在寫入每夜摘要……」、「正在寫入睡眠階段……」、「正在準備錄音……」和「正在打包壓縮檔……」。純資料的匯出完成得較快；錄音則佔了大部分時間。如果估計的錄音大小超過 1 GB，App 會警告你這次匯出可能需要好幾分鐘，並會用掉相當多的暫存空間。

你隨時都可以停止。產生過程中按鈕會顯示「點一下以取消」；點下去就會中止匯出，並把面板重設為閒置狀態。

「所選範圍內沒有資料」

如果你選的範圍內沒有任何錄音，App 會顯示錯誤「所選範圍內沒有資料」，且不會建立任何檔案。這通常表示你在那段期間內沒有任何一夜有錄音。把範圍放寬到最近 30 天或全部時間，或挑選涵蓋你有錄音那幾夜的日期。

CSV 檔案逐欄說明

每個 CSV 都能在 Excel、Numbers、Google Sheets 或任何其他試算表 App 中開啟。時間戳記使用含時區資訊的 ISO 8601 格式，例如 2024-01-15T22:30:45-08:00，而夜晚識別碼使用 YYYY-MM-DD 格式的單純 ISO 日期。含有逗號、引號或換行的文字會加上引號，讓檔案能乾淨地解析。一致的格式是刻意的：它讓你可以橫跨好幾個月的夜晚排序、篩選和製作圖表，而不必先清理資料。

每夜摘要

每一夜一列，呈現那一夜的整體樣貌。欄位分成四個區塊：

• 錄音：夜晚、備註、總錄音時長（秒）、總大小（MB）、第一次錄音開始、最後一次錄音結束。
• 睡眠：睡眠分數、睡眠效率、總睡眠（秒）、入睡時間（秒）、睡眠偵測來源、淺眠（秒）、深眠（秒）、REM 睡眠（秒）、靜默（秒）、清醒（秒）、WASO（秒）、醒來次數、平均呼吸速率（bpm）。睡眠分數與睡眠階段頁面說明了這些數值如何計算得出。
• 打鼾：第一個事件開始、最後一個事件結束、事件數、總打鼾時間（秒）、最大音量峰值（dB）、平均峰值（dB）。
• 事件：打鼾事件總數、喘氣事件總數、咳嗽事件總數、夢話事件總數、呼吸中斷總數。

單位依欄位名稱而定：時長以秒計、大小以 MB 計、呼吸速率以每分鐘呼吸次數計。最大音量峰值與平均峰值是那一夜所有偵測到的事件中，分貝的最大值與平均值。

睡眠階段

每一個階段區段一列，欄位有：夜晚、來源、階段、開始時間、結束時間、時長（秒）、原因、呼吸速率（bpm）。來源會告訴你該階段是來自 Snore Timeline 的音訊分析，還是來自已連接的手錶或 Apple Health 來源，方便你並排比較兩者。

偵測到的事件

每一個偵測到的聲音一列，欄位有：類型、時間戳記、結束時間、峰值 dB、來源、靜默開始、靜默時長（秒）、恢復強度（dB）。類型代表事件的種類，例如打鼾、夢話、咳嗽、喘氣或呼吸中斷。靜默與恢復欄位會在呼吸中斷事件中填入數值，其中靜默間隔與恢復聲音的強度正是重要的資料點。

手錶生理數據

納入手錶生理數據會增加兩個 CSV 檔案：

• 手錶生理數據樣本列出個別的讀數，欄位有夜晚、來源、指標、時間戳記、數值與單位，涵蓋心率、HRV、SpO2 與呼吸速率等指標。
• 手錶生理數據彙總提供每夜的摘要：總睡眠與在床時間、各睡眠階段時長、含最小值、最大值與靜息估計值的心率平均、HRV、SpO2 平均與最小值、呼吸速率，以及手腕溫度。

這些資料來自透過 Apple Health 連接的 Apple Watch。

匯出錄音

CSV 檔案描述你的夜晚；錄音則提供佐證。有三種方式可以把錄音從手機取出。

單一事件

在事件清單中，點一下某個事件旁的下載按鈕來保存它的錄音片段。每段片段都會在事件前後各加上 2 秒的緩衝，讓你聽到聲音的前後脈絡，而不是從打鼾中途開始。圖示會告訴你下載的狀態：

• 下載圖示：可供下載。
• 旋轉的進度圓圈：正在進行中。
• 時鐘圖示：排隊中。App 一次最多下載 2 段片段；其餘的會等待，並在先前的完成後接著開始。
• 分享圖示：已完成並保存。點一下即可開啟 iOS 分享面板，把檔案傳到任何地方。
• X：下載失敗。

片段保存完成後，你會看到類似「已將事件『[開始時間]』儲存至檔案資料夾。」的訊息。第一次下載之後，App 會保留一份備妥的副本，因此再次分享同一片段是即時的。

整夜，或一次匯出所有事件

點一下打鼾事件清單頂端的下載圖示，並選擇匯出整夜錄音，即可把整夜存成一個連續檔案；檔案會儲存，並出現分享面板。同一個選單也讓你一次大量下載當夜所有事件，而不必逐一點選。

打包進報告中

匯出報告面板提供兩種錄音選項：各事件片段會為當夜每個偵測到的事件各打包一段獨立片段，而整夜錄音則打包成一個連續檔案。兩者都會與 CSV 一起放進 ZIP。請記得，這段錄音永遠來自你目前正在檢視的那一夜，無論你為資料選了哪個日期範圍。

你的檔案會存到哪裡

在 iPhone 上，你匯出的一切都放在 Snore Timeline 資料夾中，可在「檔案」App 裡瀏覽：

1. 開啟檔案 App
2. 點一下螢幕底部的瀏覽
3. 在「位置」下，點一下在我的 iPhone 上
4. 開啟 Snore Timeline 資料夾

在裡面，檔案會依類型整理：

ZIP 報告以 YYYY-MM-DD 格式的日期範圍命名，例如單一日期是「SnoreTimeline Report 2024-01-15」，一段範圍則是「SnoreTimeline Report 2024-01-08 to 2024-01-15」，因此一整個報告資料夾都能保持排序整齊、方便搜尋。每一夜的錄音資料夾還會包含一個整體統計的 Nightly Summary.csv 和一個各事件指標的 Snoring Episodes.csv，所以你按夜下載的錄音會與它的資料同行。

你不必到處找就能直接跳到這個資料夾：匯出畫面包含一個「在檔案 App 中檢視先前的匯出」連結，可直接開啟它。

在 Android 上，開啟「檔案」App，前往下載，再開啟 Exported Recordings 或 Snoring Episodes。Android 頁面涵蓋了其他平台差異。

分享給醫師

產生匯出後，點一下分享匯出按鈕，即可開啟標準的 iOS 分享面板。在那裡，你可以透過電子郵件、訊息或 AirDrop 傳送 ZIP 報告，或把它儲存到另一個 App。報告包含你每夜摘要、睡眠階段、偵測到的事件與手錶生理數據的 CSV 試算表，並可選擇一併附上錄音。

較廣的日期範圍能造就更有力的報告。單一一夜可能是特例；最近 30 天或全部時間能讓醫師看到趨勢，而趨勢正是他們在意的。如果某一夜特別突出，匯出前先檢視那一夜，讓它的錄音一併帶上，因為當醫師能聽到喘氣與靜默間隔時，這些就更容易討論。醫師備妥資料指南會一步步帶你為看診組裝一份報告。

請把這份報告當成可供討論的資訊，而非診斷。Snore Timeline 分析音訊與睡眠資料，供你個人參考。它不是醫療裝置，也不會診斷睡眠呼吸中止症或任何其他病症。在你選擇分享之前，你的資料絕不會離開你的裝置；隱私權政策涵蓋了細節。