メインコンテンツまでスキップ

ミニアプリの起動

ミニアプリは大きく二つの方法で起動できます。 一つ目はポケットサインアプリのホーム画面からの起動で、二つ目は URL からの起動です。

ポケットサインアプリのホーム画面からの起動​

利用を開始した（subscribe した）ミニアプリは、ホーム画面にアイコンが表示されます。 そのアイコンをタップすることでミニアプリを起動できます。 この際、ミニアプリが起動される URL は Platform で指定したものです。

URL からの起動​

Platform から取得できる「起動リンク」を利用することで、通常のブラウザからの遷移や QR コードの読み取りからの起動を実現できます。 この起動リンクは、以下のクエリ引数を指定して動作を変更できます。

  • u=<url> (例: https://p8n.jp/i/aaaaaaaaaaaaaaaa?u=http%3A%2F%2Fexample.com)
    • ミニアプリが起動される URL を指定します
    • 省略時には Platform で指定した URL が利用されます
    • 相対パスを指定した場合は、Platform で指定した URL から解決されます。解決のアルゴリズムは、URL コンストラクタと同様のものが利用されます。

インストール済みの PocketSign Family アプリの中からどのアプリを起動するかを指定する​

ポケットサインアプリの機能を利用できるアプリは、通常のポケットサインアプリ以外にも存在します。 これらのアプリを PocketSign Family アプリと呼びます。

複数の PocketSign Family アプリがインストールされている状態でミニアプリの起動 URL にアクセスした場合、 デフォルトでは OS によってどのアプリを起動するかが異なります。 起動 URL でサブドメインを指定することで、どの PocketSign Family アプリを起動するかを指定することができます。 例えば、https://k.p8n.jp/i/aaaaaaaaaaaaaaaaだと、くまもとアプリが起動します。 また、ポケットサイン（開発）、ポケットサイン（デモ）についても指定できます。

サブドメイン遷移先
u.p8n.jpポケットサイン
k.p8n.jpくまもとアプリ
m.p8n.jpSMILE MIYAZAKI -宮崎市公式アプリ-
o.p8n.jpポケットおおつ
x.p8n.jpポケットサイン（デモ）
d.p8n.jpポケットサイン（開発）

ポケットサインアプリの未インストール時にどの PocketSign Family アプリのストアページに遷移するか選択する​

PocketSign Family アプリがいずれもインストールされていない状態でミニアプリの起動 URL に遷移した場合、 デフォルトでは通常のポケットサインアプリのストアページに遷移します。 起動 URL にtパラメータをつけることで、通常のポケットサインアプリではなく、他の PocketSign Family アプリのストアページに遷移できます。 例えば、https://p8n.jp/i/aaaaaaaaaaaaaaaa?t=kだと、くまもとアプリのストアページに遷移します。

t パラメータの値遷移先
未指定ポケットサイン
kくまもとアプリ
mSMILE MIYAZAKI -宮崎市公式アプリ-
oポケットおおつ