すべてのプロダクト
Search

このプロダクト

    SuperApp:ミニアプリ ディープリンク

    ドキュメントセンター

    SuperApp:ミニアプリ ディープリンク

    最終更新日:Jan 18, 2025

    このトピックでは、ディープリンクを使用してミニアプリに移動する方法について説明します。

    ミニアプリのコンテキストでは、ミニアプリマーケットからミニアプリをタップしてミニアプリのホームページに移動するだけでなく、次の方法でユーザーがミニアプリにアクセスできるようにすることができます。

    • 通知をタップして、ミニアプリ内の特定のページに移動します。

    • バナーをタップして、ミニアプリ内の特定のページに移動します。

    • HTML5 ページのリンクをタップして、ミニアプリ内の特定のページに移動します。

    • 別のアプリ内からミニアプリ内の特定のページに移動します。

    上記のメソッドを実装するには、ミニアプリのディープリンク構文を定義するだけです。

    ディープリンク構文

    ディープリンクは、次の 5 つのコンポーネントで構成されます。

    scheme://miniapp/startapp?appId=[appId]&path=[path]&query=[query]

    パラメーター

    説明

    例

    scheme

    ディープリンクのスキーマ。 Superapp で定義されているスキーマを使用します。

    emasSuperapp

    miniapp/startapp

    ディープリンクの URL パス。 Superapp で定義されているパスを使用します。

    Miniapp/startapp

    appId=[appId]

    ミニアプリの一意の ID。 Enterprise Mobile Application Studio（EMAS）の Application Open Platform から取得できます。

    15116638413925671xxxxx

    path=[path]

    ミニアプリ内の特定のページへのパス。このパラメーターは省略可能です。パスが指定されていない場合、ユーザーはミニアプリのホームページにリダイレクトされます。

    URL エンコード前：

    /about/index

    URL エンコード後：

    %2Fabout%2Findex

    query=[query]

    ディープリンクのプレースホルダー。ここにクエリパラメーターを含めてミニアプリに渡すことができます。ミニアプリにパラメーターを渡す必要がない場合は、このパラメーターを空のままにすることができます。

    URL エンコード前: key1=value1&key2=value2

    URL エンコード後: key1%3Dvalue1%26key2%3Dvalue2

    例

    次の例では、EMAS Superapp で ID が 1511663841392567144448 のミニアプリを起動する方法について説明します。

    ミニアプリのホームページを開く

    ミニアプリのホームページを開くには、次の手順を実行します。

    1. ディープリンクを生成します: emassuperapp://miniapp/startapp?appId=1511663841392567144448

    2. ディープリンクを Superapp に送信します。

    3. Superapp はディープリンクを解析し、ミニアプリ ID を取得します。

    4. ミニアプリ API を使用してミニアプリを起動します。 Android ミニアプリの起動方法については、「ミニアプリを起動する」をご参照ください。 iOS ミニアプリの起動方法については、「ミニアプリを起動する」をご参照ください。

    ミニアプリ内の特定のページを開く

    ミニアプリ内の特定のページ（WindWane ミニアプリの about ページなど）を開くには、次の手順を実行します。

    1. ディープリンクを生成します: emassuperapp://miniapp/startapp?appId=1511663841392567144448&path=%2Fabout

    2. ディープリンクを Superapp に送信します。

    3. Superapp はディープリンクを解析し、ミニアプリ ID とページへのパスを取得します。

    4. ミニアプリ API を使用してミニアプリを起動します。 Android ミニアプリの起動方法については、「ミニアプリ内の特定のページを開く」をご参照ください。 iOS ミニアプリの起動方法については、「ミニアプリ内の特定のページを開く」をご参照ください。

    ミニアプリ内の特定のページを開き、パラメーターをページに渡す

    たとえば、WindVane アプリの about ページを開き、値 EMAS を持つ name パラメーターをページに渡すには、次の手順を実行します。

    1. ディープリンクを生成します: emassuperapp://miniapp/startapp?appId=1511663841392567144448&path=%2Fabout&name=EMAS

    2. ディープリンクを Superapp に送信します。

    3. Superapp はディープリンクを解析し、ミニアプリ ID、ページへのパス、および name パラメーター値を取得します。

    4. ミニアプリ API を使用してミニアプリを起動します。 Android ミニアプリの起動方法については、「ミニアプリ内の特定のページを開く」をご参照ください。 iOS ミニアプリの起動方法については、「ミニアプリ内の特定のページを開く」をご参照ください。