外部ブラウザでLINEミニアプリを開く

2025年10月1日より外部ブラウザでLINEミニアプリを利用できるようになりました

LINEミニアプリを開発する際は、ユーザーが外部ブラウザでエンドポイントURLにアクセスした場合にも、LINEミニアプリのサービスを利用できるようにしてください。

LINEミニアプリを外部ブラウザで利用する際には、以下の点に注意してください。

LINEログインが必要なサービスの場合は明示的にログイン処理を行う

外部ブラウザでLINEミニアプリを開く場合、LIFFブラウザとは異なりliff.init()メソッドを実行するだけではLINEログインが実行されません。

そのため、サービスを利用するためにLINEログインが必要な場合は、以下のいずれかの方法でLINEログインを明示的に実行する必要があります。

1. 初期化時に自動的にLINEログインを実行する

liff.init()メソッドのconfigオブジェクトのwithLoginOnExternalBrowserプロパティにtrueを指定することで、外部ブラウザでのLIFFアプリ初期化時に、liff.login()メソッドを自動で実行できます。

例：

js
liff
  .init({
    liffId: "1234567890-AbcdEfgh", // LIFF IDを指定する
    withLoginOnExternalBrowser: true, // 自動ログインを有効にする
  })
  .then(() => {
    // LIFF APIの利用を始める
  });

2. 未ログインの場合にLINEログインを実行する

ユーザーのLINEログインが必要になったタイミングで、未ログインの場合にLINEログインを実行します。

liff.isLoggedIn()メソッドでユーザーのログイン状態を確認し、未ログインの場合はliff.login()メソッドを実行します。

例：

js
if (!liff.isLoggedIn()) {
  liff.login();
}

詳しくは、『LIFFドキュメント』の「外部ブラウザでLINEログインを利用する場合」を参照してください。

外部ブラウザで利用できない機能を使う場合はユーザーをLINEアプリに誘導する

LINEミニアプリが外部ブラウザで利用できない機能を使う必要がある場合、ユーザーがLINEアプリ上でLINEミニアプリを開く必要があります。

外部ブラウザで利用できない機能、および動作が保証されていない機能は以下のとおりです。

該当する機能を利用しているLINEミニアプリが外部ブラウザで開かれた場合、画面上に「この機能を利用するにはLINEアプリでLINEミニアプリを開く必要があります。」といった文言とLINEミニアプリへのリンクを設置することを推奨しています。

なお、liff.getContext()メソッドや、liff.isInClient()メソッドを使うことでLINEミニアプリの動作環境を取得できます。LINEミニアプリの動作環境に応じて表示を変更する場合は、これらのメソッドの利用を推奨します。

LINE未使用のユーザーがLINEミニアプリを開くことを想定する

LINE未使用のユーザーでもLINEミニアプリを利用できるようにする場合は、外部ブラウザでLINEミニアプリを開いた後、LINEログインを実行せずにサービスが動作するようにしてください。

外部ブラウザでLINEログインしなくても使用可能なLIFF APIのプロパティとメソッドは以下のとおりです。