D4DJ GroovyMix のリザルトを Scrapbox のページにまとめやすくする iOS ショートカットを作った

この記事は GMOペパボエンジニア Advent Calendar 2020 - Adventar 21日目の記事です。昨日20日目は Tatsumi0000 くんの App Store Connect APIからアプリのダウンロード数を取得する時にハマったポイントとその解決法でした。

動機

D4DJ Groovy Mixとかいうスマホの音ゲーをちょっと真面目に触ってる。スコアモチベを上げるためにグルミク1日1PFCアドベントカレンダーを作りたくなった。Twitter以外のストックできる場所にまとめたいと考え、Scrapbox を採用したが、都度都度iOSでページを作るのが面倒だった。

作ったもの

グルミクスコアをスクラップ

D4DJ GroovyMix のエキスパートスコアのクリアリザルトに対して

スコアキャプチャを保存する
リザルトテキストを本文、曲名をタイトルにしてScrapboxのページを作成する
- 追加するScrapboxのアカウントは簡単に設定できる

という要件を満たすiOSのショートカットを作った。

ScrapboxのページにしたいEXPERTのリザルトが出たときにショートカットを実行すると、曲名をタイトルにしたページを作ってくれる。画像アップロードまでは自動でできないので、そこは手動で。iOSで上記リンクに飛ぶことで実際に端末のショートカットとして使用することができる。

手法

Scrapboxにページを追加する

ページを作る - Scrapbox ヘルプにあるように、ページタイトルとURLエンコードされた本文があれば、ページを作ることができる。

iOSショートカット

コンテンツの中身を確認する

ショートカットの入力を「コンテンツグラフを表示」にわたすと、入力内容の詳細を確認できる。例えばグルミクのリザルトをショートカットの入力にしてコンテンツグラフを表示にわたすと、 [イメージ, テキスト, テキスト] という複数のコンテンツタイプのリストになってる事がわかる。最後のテキストは空っぽなので、よくわからないけど。

なにか決まった入力に対してショートカットを作りたいと考えたのならば、まずは入力を解析するのにコンテンツグラフを表示させると良さそうと思った。

f:id:uvb_76:20201221065030j:plain — スコアリザルトの入力リスト

コンテンツグラフ

「ショートカット」のコンテンツ・グラフ・エンジン - Apple サポート

「ショートカット」の能力の多くは、コンテンツ・グラフ・エンジンによるものであり、iOSおよびiPadOSの機能やAppからショートカットアクションへのデータをその場でインテリジェントに変換します。アクションがある種類のコンテンツを想定しているのに別の種類のコンテンツが渡された場合、コンテンツグラフがそのコンテンツを適切な種類へ自動的に変換します。

この仕組のおかげで、ある程度のコンテンツの種類の違いを許容して色々と変換してくれる。たとえばテキストに対して「写真に保存」をすると、テキストを画像に変換して保存する。逆に画像をテキストとして表示すると [イメージ] というテキストになって表示される。ショートカットの入力を確認するには「コンテンツグラフの表示」を使う。ショートカットの入力に対して変換できるコンテンツの種類をグラフにして表示してれる。