iOS 捷徑筆記

使用環境： iPhone SE (2022) iOS 16.3
因較習慣日文介面及英文資料，部分 action 或物件的名稱可能不一樣。

操作

• 長按各個動作的 icon 可以查看該動作的詳情(輸入輸出格式 etc)或複製該動作，或是將複製的動作貼在該動作上面或下面。
• 輸入變數時，按 選擇變數（魔法棒圖式） 可以看各個動作的輸出，以免搞不清楚類似名稱的變數是哪一個。
• 承上，設定辭典中的子辭典或子列表的值時，如果想要設定承別的變數，按了魔法棒之後直接把彈出的畫面往下滑，再從最上層畫面選變數即可。

條件/迴圈

當條件及迴圈不只一個，且互相包含時，可能會出現錯位，例如最外層應該是迴圈，最下面出現的卻是 if 的結束。
此現象會直接影響到捷徑執行，可能因此出現 crash。
最直接的修正方式為刪除所有條件及迴圈(可選擇將中間的動作留下)，再由最外層一層一層加回來。

變數

辭典 (JSON)

Array 讀入問題

於 iOS 16 使用 JSON 檔讀入成辭典時，似乎不可為 array，若為 array 需先轉換成 object。
來源 reddit 討論串
例如，以下 JSON

[
    {
        "key": 0,
        "value": "haha"
    },
    {
        "key": 1,
        "value": "hahaha"
    }
]

須置換成

{
    "data":
    [
        {
            "key": 0,
            "value": "haha"
        },
        {
            "key": 1,
            "value": "hahaha"
        }
    ]
}

才可以使用。
從遠端取得，無法事前編輯檔案之 JSON 資料，可能須用其他方式存檔後再行輸入，或是將副檔名改為 txt 後使用文字功能帶入變數，依照上述方始改變再引入辭典，之後用迴圈來跑過每個項目。
若是真的無法編輯，或有太多變數，建議使用 Scriptable，但各個 App 間的串接支援度較差。

辭典中的變數型態問題

這是個人使用上碰到的問題，若有其他方法可以處理，敬請留言指教。

在使用辭典 action 設定巢狀時，會出現變數型態自己跑掉的問題。
假設我們想要一個如下的物件：

{
    "key1": "some text",
    "key2": 123,
    "key3": [
        {
            "subkey1": "text",
            "subkey2": "other text"
        },
        {
            "subkey1": "more text",
            "subkey2": "yeah"
        }
    ]
}

當你使用辭典 action 設定好 key1 是文字、key2 是數字、key3 是列表，接著在 key3 中新增一個辭典項目。
設定 subkey1 時，你會發現你才打了 key，值的地方被自動代入 some text，但沒關係，手動改成 text 就可以。
問題在於要來設定 subkey2 時，你可能會發現你輸入 key 可能才到一半，變數型態突然自動變成數字，還自動代入 123 了。
這時不管你想改值或是用外部變數代入值，pass 到別的地方時還是會被自動轉成數字，同時我也沒有找到任何方法可以不把項目刪掉直接改型態。(刪掉重設就是 loop 上一步)
這時只能在最上層 key1 的前後加入一個文字的項目，輸入好 key3 裡面的東西之後再改最上層了。

長話短說

1. 巢狀辭典中的子辭典的項目會自動變成跟最上層的型態順序相同的型態，因此要先把最上層的型態順序改成子辭典的型態順序，設定好子辭典的值之後再設定最上層。
2. 之後要再修改子辭典的值時，也需要再把最上層改掉。
3. 子辭典的項目數量超過最上層時，似乎會直接閃退。

類型轉換

大部分時候，可以選擇辭典物件，點開類型並且在最下面輸入 key 以取得 key 中的值。
有些如 if 等條件式的 aciont，捷徑會自動根據變數類型提供不同的運算子，一般的變數可以直接點開變數並點選需要的類型來使用需要的邏輯條件。
但是從辭典中取值時，直接使用 if，用辭典變數輸入 key 的話，變數似乎無法強制變更型態。
因此我會使用設定變數，先將欲使用的值讀到另一個變數中，再用 if 讀取該變數，同時強制變更變數型態。

字串

如果不是需要使用搜尋取代等較複雜的字串處理，單純需要字串結合或前後增加固定文字時，可以直接使用文字動作，在方框中輸入需要的固定字串，或從鍵盤上方選擇變數名稱就可代入變數。

我不確定是否為字串變數的問題，或是捷徑在輸出時的狀況，但當我使用base64編碼將照片轉為 base64 時，即使開了不換行，在將結果輸出到畫面或檔案時都會出現被換行的狀況，應是字串過長，請小心處理。

搜尋類型 Action 的回傳

音樂搜尋

當你搜尋複數個音樂時，用加入播放列表、加入待播清單等功能非常簡單，可以直接 pass 整個結果。
但如果想要一個一個處理結果時，就會有點麻煩。
首先很直覺的，我們可以使用「重複每一個」來對每一個結果進行操作，但當你從「重複項目」中想要拿出「歌名」、「播放次數」等等的細節時，你會發現拿到的是用換行符號把所有結果合在一起的字串。

想要分別拿到每一個結果的「歌名」等內容，要再多加一個 「取得音樂的詳細資訊」 的動作來將重複項目的內容放入變數。

行事曆

新增行程

缺點

• 只能預先設定一個通知。(可以在執行時顯示新增的頁面，手動調整)。

優點

• 把整日 打開時，選擇通知時間為「開始時刻」或是「x 分鐘/小時」前，就可以設定午夜或前一天晚上的通知時間，或是直接使用客製化設定時間

與其他程式互動

除了有提供捷徑功能的 app 以外，只要將捷徑的第一個動作設定為從捷徑輸入，就可以把捷徑放在分享的清單中。
可以使用剪貼簿當作捷徑的輸入，但需要再設定權限。權限為每個捷徑獨立設定，權限不足時應會有彈窗提示。

Siri

執行

理論上可以直接對著 Siri 說出捷徑的名稱來執行捷徑，但如果捷徑的名稱與 Siri 語言不一致可能會聽不懂，又或者跟其他關鍵字衝突可能會無法順利執行。
因此建議將常用的捷徑設定為慣用語言，或是把捷徑名稱中包含的外文加入用語集，用慣用的語言轉換。

輸入

使用 Siri 執行捷徑時，即使沒有開啟語音輸入，捷徑中要求的輸入(數字、文字)也都會變成用語音。(前提是你的 Siri 不是鍵盤模式)
Siri 會唸出 placeholder 來要求輸入，若你的 Siri 設定成英文，可能會唸不出中文或日文的 placeholder。
從清單中選取的類型的輸入，可以對著 Siri 說出選項，也可以用觸控選擇。

輸出

若有任何執行結果的表示，Siri 會把文字唸出來。

其他問題

拷貝到剪貼板

之前在製作一些主要用來分享處理過的文字的捷徑時，使用「拷貝到剪貼板」這個動作，有時無法正常運作。(後來在貼上時沒有東西)
因此建議使用「分享」這個動作，直接打開內建的分享畫面，雖然這樣可能會造成在分享中又分享的奇妙畫面。

將輸出轉成語音

除了用 Siri 執行捷徑之外，也可以直接將變數 pass 到轉成語音的 action 使手機念出變數內容。
此動作可以設定與 Siri 不同的語音跟語速等等細節。
但此動作不如 Siri 順暢，有時會 delay 或 crash，若是常有這種狀況可以改用將文字轉成語音檔案的 action，再用播放聲音的 action 來播放。缺點是可能會需要一些轉換時間。

其他 iOS 筆記

• 行事曆

  加入行事曆可使用 .ics (iCalendar)格式，但須以 Safari 開啟。
  Safari 無法直接開啟 local 檔案，因此需用捷徑（例）將檔案內容轉送給 Safari。
  （可從網頁下載的檔案無需使用此方法）