日本語

# LIFF v2 APIリファレンス

# クライアントAPI

# 動作環境

LIFF v2の動作環境については、『LIFFドキュメント』の「概要」を参照してください。

なお、LIFFアプリをLIFFブラウザで開いた場合と、外部ブラウザで開いた場合では、使用できる機能が異なります。たとえば、liff.scanCode()は、外部ブラウザでは利用できません。詳しくは、各クライアントAPIの説明をご覧ください。

OpenChatでのLIFFアプリの利用はサポートされていません

現在のところ、OpenChatではLIFFアプリの利用は正式にサポートされていません。たとえば、LIFFアプリからプロフィール情報を取得できない場合があります。

# LIFF SDKのエラー

LIFF SDKのエラーはLiffErrorオブジェクトで返されます。

例

    # LiffErrorオブジェクト

    code

    String

    エラーコード

    message

    String

    エラーメッセージ。定義されたメッセージが存在する場合に返されます。

    # エラー内容

    エラーコード 説明
    400 リクエストに問題があります。リクエストパラメータとJSONの形式を確認してください。
    401 Authorizationヘッダーを正しく送信していることを確認してください。
    403 APIを使用する権限がありません。ご契約中のプランやアカウントに付与されている権限を確認してください。
    429 リクエスト頻度をレート制限内に抑えてください。
    500 APIサーバーの一時的なエラーです。
    INIT_FAILED LIFF SDKの初期化時にエラーが発生しました。
    INVALID_ARGUMENT 無効な引数が指定されました。
    UNAUTHORIZED
    • ユーザーが認可しませんでした。
    • アクセストークンを指定せずにAPIが呼ばれました。
    • ログイン処理を行う前に、シェアターゲットピッカーを呼び出しました。
    FORBIDDEN
    • 必要な権限がありません。
    • サポートされていない環境で機能を利用しようとしました。
    INVALID_CONFIG 無効な設定です。
    • liff.init()を使ってLIFFアプリを初期化するには、liffIdを指定する必要があります。
    • liff.permanentLink.createUrl()を実行したページのURLが、［エンドポイントURL］に指定したURLで始まりません。
    INVALID_ID_TOKEN IDトークンが正規のものであることを確認できませんでした。
    EXCEPTION_IN_SUBWINDOW サブウィンドウで問題が発生しました。
    • ターゲットピッカー（グループまたは友だちを選択する画面）を表示後、10分以上操作しなかった場合など
    THINGS_NO_LINKED_DEVICES デバイスがありません。
    BLUETOOTH_SETTING_OFF Bluetooth機能がオフになっています。
    THINGS_TERMS_NOT_AGREED ユーザーがLINE Thingsの利用規約に同意していません。
    BLUETOOTH_NO_LOCATION_PERMISSION ユーザーが位置情報の取得を許可していません。
    BLUETOOTH_LOCATION_DISABLED 位置情報取得機能がオフになっています。
    BLUETOOTH_LE_API_UNAVAILABLE LIFFのBluetoothプラグインが使用できません。
    BLUETOOTH_CONNECT_FAILED デバイスとの接続に失敗しました。
    BLUETOOTH_ALREADY_CONNECTED デバイスは接続済みです。
    BLUETOOTH_CONNECTION_LOST デバイスが接続されていません。
    BLUETOOTH_UNSUPPORTED_OPERATION 指定したcharacteristicでは、指定した操作がサポートされていません。
    BLUETOOTH_SERVICE_NOT_FOUND 指定したサービスが、GATTサーバーに存在しません。
    BLUETOOTH_CHARACTERISTIC_NOT_FOUND 指定したcharacteristicが、サービスに存在しません。
    UNKNOWN 不明なエラーです。

    # LIFF SDKのプロパティ

    # liff.ready

    LIFFアプリ起動後、liff.init()の実行が初めて終了したときにresolveするPromiseオブジェクトを保持するプロパティです。

    liff.readyを利用すると、liff.init()の終了を待って、任意の処理を実行できます。

    LIFFアプリ初期化前でも実行できます

    liff.readyは、liff.init()によるLIFFアプリの初期化が終了する前でも実行できます。

    例

      注意

      liff.init()実行中に何か問題が起きても、liff.readyはrejectしません。また、LiffErrorオブジェクトを返すこともありません。

      # liff.id

      liff.init()に渡したLIFFアプリID（String型）を保持するプロパティです。

      liff.init()を実行するまでは、nullです。

      例

        # liff.init()

        LIFFアプリを初期化します。このメソッドを実行すると、LIFF SDKの他のメソッドを実行できるようになります。このとき、LIFF SDKは、現在のユーザーのアクセストークンやIDトークンをLINEプラットフォームから取得します。

        • LIFF SDKが取得したアクセストークンを利用するには、「liff.getAccessToken()」を呼び出します。
        • LIFF SDKが取得したIDトークンのペイロードを利用するには、「liff.getDecodedIDToken()」を呼び出します。
        LIFFアプリ初期化時の注意事項

        • liff.init()メソッドは、1次リダイレクト先URLに付与されるliff.stateやaccess_token=xxxなどの情報を元に初期化処理を行います。エンドポイントURLにクエリパラメータやパスが含まれている場合、正しくLIFFアプリを初期化するために、1次リダイレクト先URLと2次リダイレクト先URLで、1回ずつliff.init()メソッドを実行してください。リダイレクトについて詳しくは、「LIFF URLにアクセスしてからLIFFアプリが開くまでの動作について」を参照してください。

        • liff.init()メソッドが返すPromiseオブジェクトがresolveする前に、サーバーやフロントエンド側の処理などでURLを変更しないようにしてください。URLを変更すると、INIT_FAILEDが返され、LIFFアプリを開けません。たとえば、liff.init()実行後にlocation.replace()などでリダイレクトする場合は、Promiseオブジェクトがresolveされてから画面遷移するように設計してください。

          liff.init({liffId: myLiffId}).then(() => {
    // Redirect to another page after the returned Promise object has been resolved
    location.replace("https://line.me/{liffId}/path");
})

        • 1次リダイレクト先URLに自動的に付与されるaccess_token=xxxはユーザーのアクセストークン（機密情報）です。Google Analyticsなど外部のロギングツールに、1次リダイレクト先URLを送らないように注意してください。
          なお、LIFF v2.11.0以降のバージョンでは、liff.init()がresolveされたタイミングでURLから機密情報が除外されます。そのため、以下のようにthen()メソッド内でページビューを送信することで、機密情報の漏洩を防ぐことができます。ロギングツールを利用する場合は、LIFFアプリをv2.11.0以降にバージョンアップすることをお勧めします。LIFF v2.11.0の更新内容について詳しくは、『LIFFドキュメント』の「リリースノート」を参照してください。

          liff.init({liffId: myLiffId}).then(() => {
    ga('send', 'pageview');
})
        LIFFアプリのクエリパラメータについて

        LIFF URLへのアクセス時やLIFF間遷移時などに、URLに liff.* のようなクエリパラメータが付与されることがあります。

        例：

        • liff.state（LIFF URLに指定した追加情報を示す）
        • liff.referrer（LIFF間遷移前のURLを示す。詳しくは、「LIFF間遷移前のURLを取得する」を参照してください）

        上記は、LIFFアプリを正常に動作させるために、SDK側から付与されるクエリパラメータです。 LIFFアプリのURLに独自の処理を行う場合は、LIFFアプリの起動やLIFF間遷移などLIFFアプリの正常な動作を保証するため、liff.initがresolveされるまでliff.*のクエリパラメータを変更しないように設計してください。

        LIFFアプリを初期化する前でも実行できるメソッド

        以下のプロパティおよびメソッドは、liff.init()メソッドを実行する前でも利用できます。
        LIFFアプリを初期化する前にLIFFアプリを動作させている環境を取得したり、LIFFアプリ初期化に失敗した際にLIFFアプリを閉じたりできます。

        liff.closeWindow()メソッドは、LIFF SDKバージョンが2.4.0以上、ユーザーのLINEバージョンが10.15.0以上の場合のみ、liff.init()によるLIFFアプリの初期化が終了する前でも実行できます。

        例

          # 構文

          liff.init(
  config,
  successCallback,
  errorCallback
)

          # 引数

          config

          Object

          必須

          LIFFアプリの設定

          config.liffId

          String

          必須

          LIFFアプリID。LIFFアプリをチャネルに追加すると取得できます。詳しくは、「LIFFアプリをチャネルに追加する」を参照してください。
          ここで指定したLIFFアプリIDは、liff.idで取得できます。

          config.withLoginOnExternalBrowser

          Boolean

          任意

          外部ブラウザでのLIFFアプリ初期化時にliff.login()メソッドを自動で実行するかどうかを、以下のどちらかの値で指定します。デフォルト値はfalseです。

          • true：外部ブラウザでliff.login()メソッドを自動で実行します。
          • false：外部ブラウザでliff.login()メソッドを自動で実行しません。

          successCallback

          Function

          任意

          LIFFアプリの初期化に成功したときにデータオブジェクトを返すコールバック

          注意

          successCallbackは、戻り値のPromiseオブジェクトのresolveと同じタイミングで処理されます。ただし、処理の順番は保証されません。

          errorCallback

          Function

          任意

          LIFFアプリの初期化に失敗したときにエラーオブジェクトを返すコールバック

          注意

          errorCallbackは、戻り値のPromiseオブジェクトのrejectと同じタイミングで処理されます。ただし、処理の順番は保証されません。

          # 戻り値

          Promiseオブジェクトが返されます。

          # エラーレスポンス

          Promiseがrejectされたときは、LiffErrorが渡されます。

          # liff.getOS()

          ユーザーがLIFFアプリを動作させている環境を取得します。

          LIFFアプリ初期化前でも実行できます

          このメソッドは、liff.init()によるLIFFアプリの初期化が終了する前でも実行できます。

          # 構文

          liff.getOS()

          # 引数

          なし

          # 戻り値

          ユーザーがLIFFアプリを動作させている環境が、文字列で返されます。戻り値はユーザーエージェント文字列中のOS名に基づくため、返却される値はブラウザの種類（LIFFブラウザ、LINE内ブラウザ、外部ブラウザ）を問いません。

          たとえば、ユーザーがiOSを使用している場合、使用しているブラウザがLIFFブラウザかSafariかは問わず、ios が返却されます。

          戻り値 説明
          ios iOSもしくはiPadOS
          android Android
          web 上記以外

          LIFFアプリをサポートするOSやブラウザについては、動作環境を参照してください。

          # liff.getLanguage()

          LIFFアプリを動作させている環境の言語設定を取得します。

          LIFFアプリ初期化前でも実行できます

          このメソッドは、liff.init()によるLIFFアプリの初期化が終了する前でも実行できます。

          # 構文

          liff.getLanguage()

          # 引数

          なし

          # 戻り値

          LIFFアプリを動作させている環境のnavigator.languageで取得できる言語設定が、文字列で返されます。

          # liff.getVersion()

          LIFF SDKのバージョンを取得します。

          LIFFアプリ初期化前でも実行できます

          このメソッドは、liff.init()によるLIFFアプリの初期化が終了する前でも実行できます。

          # 構文

          liff.getVersion()

          # 引数

          なし

          # 戻り値

          LIFF SDKのバージョンが、文字列で返されます。

          # liff.getLineVersion()

          ユーザーのLINEバージョンを取得します。

          LIFFアプリ初期化前でも実行できます

          このメソッドは、liff.init()によるLIFFアプリの初期化が終了する前でも実行できます。

          # 構文

          liff.getLineVersion()

          # 引数

          なし

          # 戻り値

          ユーザーがLIFFブラウザでLIFFアプリを開くと、ユーザーのLINEバージョンが文字列で返されます。 ユーザーが外部ブラウザでLIFFアプリを開くと、 nullが返されます。

          # liff.isInClient()

          LIFFアプリをLIFFブラウザで動作させているかどうかを取得します。

          LIFFアプリ初期化前でも実行できます

          このメソッドは、liff.init()によるLIFFアプリの初期化が終了する前でも実行できます。

          # 構文

          liff.isInClient()

          # 引数

          なし

          # 戻り値

          # liff.isLoggedIn()

          ユーザーがログインしているかどうかを取得します。

          例

            # 構文

            liff.isLoggedIn()

            # 引数

            なし

            # 戻り値

            • true：ログインしている
            • false：ログインしていない

            # liff.isApiAvailable()

            指定したAPIが、LIFFアプリを起動した環境で使用可能かどうかを確認します。 たとえば、APIが対応しているLINEバージョンであることや、APIを呼び出すために特別な同意が必要な場合は同意していることを確認します。

            例

              # 構文

              liff.isApiAvailable(apiName)

              # 引数

              apiName

              String

              必須

              LIFFのクライアントAPIの名前。以下のAPI名を指定できます。

              multipleLiffTransitionについて

              multipleLiffTransitionは、LIFFアプリを閉じずに別のLIFFアプリを開くこと（LIFF間遷移）が可能かどうか、という状態を表すプロパティで、APIの名前ではありません。詳しくは、『LIFFドキュメント』の「LIFFアプリから別のLIFFアプリを開いた場合の動作について（LIFF間遷移）」を参照してください。

              # 戻り値

              指定したAPIが、現在の環境で使用可能かどうかが返されます。

              戻り値 説明
              true 使用可能
              false 使用不可能。以下の場合は、falseが返されます。
              • APIが対応していないLINEバージョンでLIFFアプリを起動した場合
              • 使用するために特別な同意が必要なAPIにもかかわらず、同意していない場合

              # liff.login()

              外部ブラウザおよびLINE内ブラウザ上で、ログイン処理を行います。

              注意

              LIFFブラウザの場合、liff.init()実行時に自動でログイン処理が実行されるため、liff.login()は利用できません。

              LIFFブラウザ内での認可リクエストについて

              LIFFブラウザ内でLINEログインによる認可リクエストを行った際の動作は保証されません。また、LIFFアプリを外部ブラウザやLINE内ブラウザで開く場合には、必ず本メソッドでログイン処理を行い、LINEログインによる認可リクエストは行わないでください。

              例

                # 構文

                liff.login(loginConfig)

                # 引数

                loginConfig

                Object

                任意

                ログインの設定

                loginConfig.redirectUri

                String

                任意

                ログイン後にLIFFアプリで表示するURL。デフォルト値は、LIFFアプリをチャネルに追加したときに設定したエンドポイントURLです。エンドポイントURLの設定方法について詳しくは、『LIFFドキュメント』の「LIFFアプリをチャネルに追加する」を参照してください。

                URL検証機能

                redirectUriを指定した場合、指定したURL（例：https://example.com/path）が［エンドポイントURL］のドメイン名およびパスと一致しているか検証されます。不一致だった場合はエラー画面が表示され、ログイン処理に失敗します。

                if (!liff.isLoggedIn()) {
  liff.login({ redirectUri: "https://example.com/path" });
  // 指定したURL（https://example.com/path）のドメイン名と
  // パスがエンドポイントURLと一致しているか検証します。
}

                なお、クエリパラメータ（?key=value）やURLフラグメント（#URL-fragment）の一致は検証されません。詳しくは、『LIFFドキュメント』の「URL検証機能」を参照してください。

                # 戻り値

                なし

                # liff.logout()

                ログアウトします。

                例

                  # 構文

                  liff.logout()

                  # 引数

                  なし

                  # 戻り値

                  なし

                  # liff.getAccessToken()

                  LIFF SDKが取得した「現在のユーザーのアクセストークン」を取得します。

                  LIFFアプリからサーバーにユーザー情報を送信するときに、このAPIで取得したアクセストークンを利用できます。 サーバーでユーザー情報を使用する方法について詳しくは、『LIFFドキュメント』の「LIFFアプリおよびサーバーでユーザー情報を使用する」を参照してください。

                  アクセストークンの有効性

                  アクセストークンは、発行後12時間有効です。 なお、ユーザーがLIFFアプリを閉じると、アクセストークンは無効化されます。

                  LIFF SDKがアクセストークンを取得するタイミング
                  • LIFFブラウザでLIFFアプリを起動した場合は、liff.init()を呼び出したときに、LIFF SDKがアクセストークンを取得します。
                  • 外部ブラウザでLIFFアプリを起動した場合は、以下の手順を行ったのちに、LIFF SDKがアクセストークンを取得します。
                    1. LIFFアプリで、liff.login()を呼び出す。
                    2. ユーザーがログインする。
                    3. LIFFアプリで、再度liff.init()を呼び出す。

                  例

                    # 構文

                    liff.getAccessToken()

                    # 引数

                    なし

                    # 戻り値

                    現在のユーザーのアクセストークンを文字列で返します。

                    # liff.getIDToken()

                    LIFF SDKが取得した「現在のユーザーの生のIDトークン」を取得します。IDトークンは、ユーザー情報を含むJSONウェブトークン（JWT）です。

                    LIFFアプリからサーバーにユーザー情報を送信するときに、このAPIで取得したIDトークンを利用できます。 サーバーでユーザー情報を使用する方法について詳しくは、『LIFFドキュメント』の「LIFFアプリおよびサーバーでユーザー情報を使用する」を参照してください。

                    スコープを選択してください

                    LIFFアプリをチャネルに追加するときに、openidスコープを選択してください。スコープを選択しなかった場合やユーザーが認可しなかった場合は、IDトークンを取得できません。スコープの選択は、LIFFアプリ追加後もLINE DevelopersコンソールのLIFFタブで変更できます。

                    LIFF SDKがIDトークンを取得するタイミング
                    • LIFFブラウザでLIFFアプリを起動した場合は、liff.init()を呼び出したときに、LIFF SDKがIDトークンを取得します。
                    • 外部ブラウザでLIFFアプリを起動した場合は、以下の手順を行ったのちに、LIFF SDKがIDトークンを取得します。
                      1. LIFFアプリで、liff.login()を呼び出す。
                      2. ユーザーがログインする。
                      3. LIFFアプリで、再度liff.init()を呼び出す。
                    メールアドレスを取得できます

                    LIFFアプリをチャネルに追加するときに、emailスコープを選択し、ユーザーが認可すると、メールアドレスも取得できます。スコープの選択は、LIFFアプリ追加後もLINE DevelopersコンソールのLIFFタブで変更できます。

                    例

                      # 構文

                      liff.getIDToken()

                      # 引数

                      なし

                      # 戻り値

                      生のIDトークンが返されます。

                      # liff.getDecodedIDToken()

                      LIFF SDKが取得したIDトークンの「ペイロード」を取得します。ペイロードには、ユーザーの表示名、プロフィール画像のURL、メールアドレスなどの情報が含まれます。

                      LIFFアプリでユーザーの表示名などを利用する場合に、このAPIを利用してください。

                      ユーザー情報をサーバーに送信しないでください

                      このAPIで取得したユーザー情報をサーバーに送信しないでください。 サーバーでユーザー情報を使用する方法について詳しくは、『LIFFドキュメント』の「LIFFアプリおよびサーバーでユーザー情報を使用する」を参照してください。

                      スコープを選択してください

                      LIFFアプリをチャネルに追加するときに、openidスコープを選択してください。スコープを選択しなかった場合やユーザーが認可しなかった場合は、IDトークンを取得できません。スコープの選択は、LIFFアプリ追加後もLINE DevelopersコンソールのLIFFタブで変更できます。

                      LIFF SDKがIDトークンを取得するタイミング
                      • LIFFブラウザでLIFFアプリを起動した場合は、liff.init()を呼び出したときに、LIFF SDKがIDトークンを取得します。
                      • 外部ブラウザでLIFFアプリを起動した場合は、以下の手順を行ったのちに、LIFF SDKがIDトークンを取得します。
                        1. LIFFアプリで、liff.login()を呼び出す。
                        2. ユーザーがログインする。
                        3. LIFFアプリで、再度liff.init()を呼び出す。
                      メールアドレスを取得できます

                      LIFFアプリをチャネルに追加するときに、emailスコープを選択し、ユーザーが認可すると、メールアドレスも取得できます。スコープの選択は、LIFFアプリ追加後もLINE DevelopersコンソールのLIFFタブで変更できます。

                      例

                        # 構文

                        liff.getDecodedIDToken()

                        # 引数

                        なし

                        # 戻り値

                        IDトークンのペイロードが返されます。

                        IDトークンのペイロードについて詳しくは、「IDトークンからプロフィール情報を取得する」の「ペイロード」を参照してください。

                        例

                          # liff.getContext()

                          LIFFアプリが起動された画面（1対1のトーク、グループ、トークルーム、または外部ブラウザ）に関する情報を取得します。 なお、1対1のトーク、グループ、およびトークルームの場合は、一意に識別できる値も取得できます。

                          例

                            # 構文

                            liff.getContext()

                            # 引数

                            なし

                            # 戻り値

                            各種APIを呼び出すために必要な情報を含むデータオブジェクトが返されます。

                            type

                            String

                            LIFFアプリが起動された画面の種類。以下のいずれかの値が含まれます。

                            • utou：1対1のトーク
                            • group：グループ
                            • room：トークルーム
                            • external：外部ブラウザ
                            • none：LINEの1対1のトーク、グループ、トークルーム、外部ブラウザ以外から起動した場合。例：ウォレットタブ

                            LIFF間遷移後のLIFFアプリでも、このプロパティが返ります。

                            viewType

                            String

                            LIFFアプリの画面サイズ。typeプロパティがutou、group、またはroomの場合に、以下のいずれかの値が含まれます。

                            • compact
                            • tall
                            • full

                            詳しくは、「LIFFアプリをチャネルに追加する」を参照してください。

                            accessTokenHash

                            String

                            SHA256でハッシュ化したアクセストークンの前半部分。アクセストークンの検証に使用されます。

                            userId

                            String

                            ユーザーID。typeプロパティが、utou、room、group、noneまたはexternalの場合に含まれます。ただし、typeプロパティがexternalの場合は、nullが返されることがあります。

                            utouId

                            String

                            1対1トークID。typeプロパティがutouの場合に含まれます。

                            groupId

                            String

                            グループID。typeプロパティがgroupの場合に含まれます。

                            roomId

                            String

                            トークルームID。typeプロパティがroomの場合に含まれます。

                            availability.shareTargetPicker.permission

                            Boolean

                            LIFFアプリを起動した環境で、liff.shareTargetPicker()が使用可能かどうかを表します。

                            • true：liff.shareTargetPicker()が使用可能。
                            • false：liff.shareTargetPicker()が使用不可。

                            ※liff.shareTargetPicker()の使用可否は、このプロパティではなく、liff.isApiAvailable('shareTargetPicker')で確認することをお勧めします。

                            availability.shareTargetPicker.minVer

                            String

                            liff.shareTargetPicker()が使用可能なLINEの最小バージョン

                            availability.multipleLiffTransition.permission

                            Boolean

                            LIFFアプリを起動した環境で、LIFFアプリを閉じずにliff.openWindow()で別のLIFFアプリへ遷移することが可能かどうかを表します。

                            • true：現在表示しているLIFFアプリを閉じずに別のLIFFアプリを開くことが可能。
                            • false：現在表示しているLIFFアプリを閉じずに別のLIFFアプリを開くことが不可。

                            ※LIFF間遷移可否の情報は、このプロパティではなく、liff.isApiAvailable('multipleLiffTransition')で確認することをお勧めします。

                            availability.multipleLiffTransition.minVer

                            String

                            LIFFアプリを閉じずに別のLIFFアプリを開くことが可能なLINEの最小バージョン

                            endpointUrl

                            String

                            LIFFアプリのエンドポイントURL。

                            permanentLinkPattern

                            String

                            LIFF URLの追加情報の処理方法。concatが返されます。

                            詳しくは、『LIFFドキュメント』の「LIFFアプリを開く」を参照してください。

                            例（LIFFブラウザの場合）

                              例（外部ブラウザの場合）

                                # liff.getProfile()

                                現在のユーザーのプロフィール情報を取得します。

                                スコープを選択してください

                                LIFFアプリをチャネルに追加するときに、profileスコープを選択してください。スコープを選択しなかった場合やユーザーが認可しなかった場合は、プロフィール情報を取得できません。スコープの選択は、LIFFアプリ追加後もLINE DevelopersコンソールのLIFFタブで変更できます。

                                例

                                  # 構文

                                  liff.getProfile()

                                  # 引数

                                  なし

                                  # 戻り値

                                  Promiseオブジェクトが返されます。

                                  Promiseがresolveされると、ユーザーのプロフィール情報を含むオブジェクトが渡されます。

                                  userId

                                  String

                                  ユーザーID

                                  displayName

                                  String

                                  表示名

                                  pictureUrl

                                  String

                                  画像のURL。ユーザーが設定していない場合は返されません。

                                  statusMessage

                                  String

                                  ステータスメッセージ。ユーザーが設定していない場合は返されません。

                                  # エラーレスポンス

                                  Promiseがrejectされたときは、LiffErrorが渡されます。

                                  例

                                    # liff.getFriendship()

                                    ユーザーとLINE公式アカウントの友だち関係を取得します。

                                    ただし、LIFFアプリが追加されているLINEログインのチャネルに、LINE公式アカウントがリンクされている場合に、そのLINE公式アカウントとの友だち関係のみを取得できます。LINEログインのチャネルに、LINE公式アカウントをリンクする方法については、『LINEログインドキュメント』の「LINEログインしたときにLINE公式アカウントを友だち追加する（ボットリンク）」を参照してください。

                                    スコープを選択してください

                                    LIFFアプリをチャネルに追加するときに、profileスコープを選択してください。スコープを選択しなかった場合やユーザーが認可しなかった場合は、友だち関係を取得できません。スコープの選択は、LIFFアプリ追加後もLINE DevelopersコンソールのLIFFタブで変更できます。

                                    例

                                      # 構文

                                      liff.getFriendship()

                                      # 引数

                                      なし

                                      # 戻り値

                                      Promiseオブジェクトが返されます。

                                      友だち関係を取得できると、Promiseがresolveされ、友だち関係に関する情報が渡されます。

                                      friendFlag

                                      Boolean

                                      • true：ユーザーがLINE公式アカウントを友だち追加済みで、ブロックしていない。
                                      • false：それ以外の場合。
                                      # エラーレスポンス

                                      Promiseがrejectされたときは、LiffErrorが渡されます。

                                      例

                                        # liff.permission.query

                                        ユーザーが指定した権限の付与に同意しているかどうかを確認します。

                                        例

                                          # 構文

                                          liff.permission.query(permission)

                                          # 引数

                                          permission

                                          String

                                          必須

                                          確認対象の権限。以下のいずれかのスコープを指定します。

                                          # 戻り値

                                          Promiseオブジェクトが返されます。

                                          Promiseがresolveされると、以下のプロパティを持つオブジェクトが渡されます。

                                          status

                                          String

                                          以下のいずれかの値が含まれます。

                                          • granted: 権限付与にユーザーが同意済み
                                          • prompt: 権限付与にユーザーが未同意
                                          • unavailable: 指定したスコープをチャネルが持たないため、利用不可

                                          # liff.permission.requestAll

                                          LINEミニアプリが要求する権限の「アクセス許可要求画面」を表示します。

                                          アクセス許可要求画面

                                          liff.permission.requestAll()の動作環境

                                          liff.permission.requestAll()はLINEミニアプリでのみ動作します。

                                          このメソッドを実行するには、あらかじめLINE Developersコンソールで、［チャネル同意の簡略化］をオンにする必要があります。チャネル同意の簡略化の設定方法について詳しくは、『LINEミニアプリドキュメント』の「「チャネル同意の簡略化」の設定方法」を参照してください。

                                          ユーザーが未同意の権限があるかどうか確認してから実行してください

                                          権限付与にユーザーがすべて同意済みの場合、liff.permission.requestAll()を実行すると、Promiseがrejectされ、LiffErrorが渡されます。そのため、liff.permission.query()を使って、ユーザーが未同意の権限があるかどうかを確認してください。未同意の権限がある場合にのみ、liff.permission.requestAll()を実行するようにしてください。

                                          例

                                            # 構文

                                            liff.permission.requestAll()

                                            # 引数

                                            なし

                                            # 戻り値

                                            Promiseオブジェクトが返されます。

                                            # エラーレスポンス

                                            ［チャネル同意の簡略化］がオンになっていない場合や、権限付与にユーザーがすべて同意済みの場合は、Promiseがrejectされ、LiffErrorが渡されます。

                                            LIFFアプリの任意のページのパーマネントリンクを取得します。

                                            パーマネントリンクの形式：

                                            https://liff.line.me/{liffId}/{path}?{query}#{URL fragment}

                                            例

                                              liff.permanentLink.createUrlBy(url)

                                              url

                                              String

                                              必須

                                              パーマネントリンクを取得するURL。任意のクエリパラメータを追加できます。

                                              Promiseオブジェクトが返されます。

                                              Promiseがresolveされると、パーマネントリンクの文字列が渡されます。

                                              現在のページのURLがLINE Developersコンソールの［エンドポイントURL］に指定したURLで始まらない場合、Promiseがrejectされ、LiffErrorが渡されます。

                                              liff.permanentLink.createUrl()は次回メジャーバージョン以降に非推奨になる可能性があります

                                              技術的な問題があり、liff.permanentLink.createUrl()は、次回メジャーバージョン以降に非推奨になる可能性があります。現在のページのパーマネントリンクを取得するには、liff.permanentLink.createUrlBy()を使用することをお勧めします。

                                              現在のページのパーマネントリンクを取得します。

                                              パーマネントリンクの形式：

                                              https://liff.line.me/{liffId}/{path}?{query}#{URL fragment}

                                              例

                                                liff.permanentLink.createUrl()

                                                なし

                                                現在のページのパーマネントリンクが、文字列で返されます。

                                                現在のページのURLがLINE Developersコンソールの［エンドポイントURL］に指定したURLで始まらない場合、LiffError例外が発生します。

                                                # liff.permanentLink.setExtraQueryParam()

                                                現在のページのパーマネントリンクに、任意のクエリパラメータを追加できます。

                                                liff.permanentLink.setExtraQueryParam()を実行するたびに、前回追加したクエリパラメータは破棄されます。

                                                追加したクエリパラメータの削除について
                                                • 追加したクエリパラメータを削除するには、liff.permanentLink.setExtraQueryParam("")を実行します。
                                                • 追加したクエリパラメータは、ユーザーが別のページに移動すると破棄されます。

                                                例

                                                  liff.permanentLink.setExtraQueryParam(extraString)

                                                  extraString

                                                  String

                                                  必須

                                                  追加するクエリパラメータ

                                                  なし

                                                  # liff.sendMessages()

                                                  ユーザーの代わりに、LIFFアプリが開かれているトーク画面にメッセージを送信します。この機能は1対1のトークルームから起動したLIFFアプリのLIFFブラウザ内でのみ利用できます。

                                                  この機能の利用にはスコープが必要です

                                                  LIFFアプリをチャネルに追加するときに、chat_message.writeスコープを選択してください。スコープを選択しなかった場合やユーザーが認可しなかった場合は、メッセージは送信できません。スコープの選択は、LIFFアプリ追加後もLINE DevelopersコンソールのLIFFタブで変更できます。

                                                  1対1のトークルームから起動したLIFFアプリでのみ利用できます

                                                  liff.sendMessages()メソッドは、ユーザー同士、またはLINE公式アカウントとユーザーの1対1のトークルーム内で、LIFFアプリを開くためのURLスキームでLIFFアプリを起動した場合のみ利用できます。

                                                  そのため、以下の場合はliff.sendMessages()メソッドが利用できず、エラーコード403のuser doesn't grant required permissions yetエラーが発生します。

                                                  例

                                                    # 構文

                                                    liff.sendMessages(messages)

                                                    # 引数

                                                    messages

                                                    Objectの配列

                                                    必須

                                                    メッセージオブジェクト
                                                    最大件数：5
                                                    Messaging APIの以下のタイプのメッセージを送信できます。

                                                    ボットのLINE公式アカウントが参加しているトークでメッセージが送信されると、LINEプラットフォームからボットサーバーにWebhookイベントが送信されます。liff.sendMessages()メソッドで画像、動画、および音声のメッセージが送信されると、結果として送信されるWebhookイベントのcontentProvider.typeプロパティの値はexternalになります。詳しくは、『Messaging APIリファレンス』の「メッセージイベント」を参照してください。

                                                    # 戻り値

                                                    Promiseオブジェクトが返されます。

                                                    • メッセージの送信が成功すると、Promiseがresolveされます。値は渡されません。
                                                    • メッセージの送信が失敗すると、Promiseがrejectされ、LiffErrorが渡されます。

                                                    # liff.openWindow()

                                                    指定したURLをLINE内ブラウザまたは外部ブラウザで開きます。

                                                    liff.openWindow()の動作環境

                                                    liff.openWindow()の外部ブラウザでの利用は、保証対象外です。

                                                    iOS版LINEかつLIFF v2.16.1以前でliff.openWindow()を実行すると、URLフラグメントの末尾に意図しないクエリパラメータが追加されたURLが開かれます

                                                    iOS版LINEかつLIFF v2.16.1以前で、urlプロパティにクエリパラメータ（?key=value）が含まれず、かつURLフラグメント（#URL-fragment）が含まれていると、URLフラグメントの末尾に意図しないクエリパラメータが追加されたURLが開かれます。

                                                    以下は、liff.openWindow()実行時に開かれるURLの例です。

                                                    LIFF SDKバージョン urlプロパティ 開かれるURL
                                                    v2.16.1 https://example.com#URL-fragment https://example.com#URL-fragment?is_liff_external_open_window=false
                                                    v2.17.0 https://example.com#URL-fragment https://example.com#URL-fragment

                                                    例

                                                      # 構文

                                                      liff.openWindow(params)

                                                      # 引数

                                                      params

                                                      Object

                                                      必須

                                                      パラメータオブジェクト

                                                      params.url

                                                      String

                                                      必須

                                                      URL。絶対パスで指定します。

                                                      params.external

                                                      Boolean

                                                      任意

                                                      指定したURLを外部ブラウザで開くかどうかを、以下のどちらかの値で指定します。デフォルト値はfalseです。

                                                      • true：外部ブラウザで開きます。
                                                      • false：LINE内ブラウザで開きます。

                                                      # 戻り値

                                                      なし

                                                      # liff.shareTargetPicker()

                                                      ターゲットピッカー（グループまたは友だちを選択する画面）を表示し、ターゲットピッカーで選択した相手に、開発者が作成したメッセージを送信します。このメッセージは、ユーザーが送信したかのように、グループまたは友だちに表示されます。

                                                      注意
                                                      ターゲットピッカーの動作環境について
                                                      • ターゲットピッカーは、iOS版とAndroid版のLINE 10.3.0以降でサポートされます。
                                                      • liff.shareTargetPicker()を実行する前に、liff.isApiAvailable()を実行すると、LIFFアプリを起動した環境でターゲットピッカーが使用可能であることを確認できます。
                                                      ユーザーがシェアターゲットピッカーでメッセージを送信した人数は、取得できません

                                                      ユーザーのプライバシーを保護するため、シェアターゲットピッカーで、何人にメッセージが送信されたかの情報は取得できません。また、提供も行なっておりません。

                                                      例

                                                        # 構文

                                                        liff.shareTargetPicker(messages, options)

                                                        # 引数

                                                        messages

                                                        Objectの配列

                                                        必須

                                                        メッセージオブジェクト
                                                        最大件数：5
                                                        Messaging APIの以下のタイプのメッセージを送信できます。

                                                        options

                                                        Object

                                                        任意

                                                        シェアターゲットピッカーのオプション

                                                        options.isMultiple

                                                        Boolean

                                                        任意

                                                        ユーザーがターゲットピッカーで選択するメッセージ送信先として、複数の送信先を選択可能にするかどうかを、以下のどちらかの値で指定します。デフォルト値はtrueです。

                                                        • true：ユーザーはグループ、友だち、トークの中から、複数の送信先を選択できます。
                                                        • false：ユーザーは友だちの中から、1人のみを送信先として選択できます。
                                                        isMultipleにfalseを設定しても、1人の友だちのみにメッセージが送信されることは保証できません

                                                        isMultipleプロパティにfalseを設定しても、シェアターゲットピッカーを複数回呼び出すことや、シェア後のメッセージをユーザー側で再度シェアすることで、複数のユーザーへのメッセージ送信が可能です。厳密にユーザーから1人の友だちに対して、一度しかメッセージを送信できないようにする場合には、LIFFアプリ実装時に制限をかける必要があります。

                                                        URLを含むメッセージを送信し、URLへのアクセスを制限する場合の例を紹介します。

                                                        1. URLにユニークなトークンを付与し、メッセージを送信します。
                                                        2. メッセージ内のURLへアクセスされた際にサーバー側でトークンを検証し、複数のユーザーからのアクセスを制限します。

                                                        # 戻り値（LINE 10.3.0～10.10.0）

                                                        Promiseオブジェクトが返されます。

                                                        • ターゲットピッカーが表示されると、Promiseがresolveされます。

                                                        • ターゲットピッカーが表示される前に問題が発生した場合は、Promiseがrejectされ、LiffErrorが渡されます。LiffErrorオブジェクトについては、「LIFF SDKのエラー」を参照してください。

                                                        注意
                                                        • 表示されたターゲットピッカーでユーザーが送信先を選択しなかった場合など、ターゲットピッカーが表示されたあとの状況は検知できません。
                                                        • Promiseがresolveした場合とrejectした場合のコールバック関数内で、alert()を実行すると一部端末で正しく動作しません。

                                                        # 戻り値（LINE 10.11.0～）

                                                        Promiseオブジェクトが返されます。

                                                        • 正しくメッセージが送信されると、Promiseがresolveされ、以下のプロパティを持つオブジェクトが渡されます。

                                                          status

                                                          String

                                                          常にsuccessです。

                                                        • メッセージを送信する前に、ユーザーがキャンセルしてターゲットピッカーを閉じると、Promiseがresolveされますが、オブジェクトは渡されません。

                                                        • ターゲットピッカーが表示される前に問題が発生した場合は、Promiseがrejectされ、LiffErrorが渡されます。LiffErrorオブジェクトについては、「LIFF SDKのエラー」を参照してください。

                                                        注意

                                                        Promiseがresolveした場合とrejectした場合のコールバック関数内で、alert()を実行すると一部端末で正しく動作しません。

                                                        # liff.scanCodeV2()

                                                        二次元コードリーダーを起動し、読み取った文字列を取得します。二次元コードリーダーを起動するには、あらかじめLINE Developersコンソールで、 [Scan QR] をオンにする必要があります。

                                                        liff.scanCodeV2()の動作環境

                                                        liff.scanCodeV2()は以下の環境で動作します。

                                                        • iOS：iOS14.3以降かつLINEバージョン11.7.0以降
                                                        • Android：LINEバージョン11.7.0以降
                                                        • 外部ブラウザ：WebRTC API (opens new window) をサポートするウェブブラウザ
                                                        OS バージョン LINEアプリのバージョン 外部ブラウザ
                                                        9.18.0以前 9.19.0〜11.6.x 11.7.0以降
                                                        iOS 11〜14.2 ❌ ❌ ❌ ✅ ※1
                                                        14.3以降 ❌ ❌ ✅ ※2 ✅ ※1
                                                        Android すべてのバージョン ❌ ❌ ✅ ※2 ✅ ※1
                                                        PC すべてのバージョン ❌ ❌ ❌ ✅ ※1

                                                        ※1 WebRTC API (opens new window)をサポートするウェブブラウザのみ利用できます。

                                                        ※2 LIFFブラウザの画面サイズがFullの場合のみ利用できます。詳しくは、『LIFFドキュメント』の「LIFFブラウザの画面サイズ」を参照してください。

                                                        二次元コードリーダーを起動するには［Scan QR］をオンにしてください

                                                        LIFFアプリをチャネルに追加するときに、［Scan QR］をオンにしてください。［Scan QR］の設定は、LIFFアプリ追加後もLINE DevelopersコンソールのLIFFタブで変更できます。

                                                        liff.scanCodeV2()の動作仕様

                                                        liff.scanCodeV2()は、内部でjsQR (opens new window)という外部ライブラリを使用しています。そのため、liff.scanCodeV2()メソッド実行時に起動する二次元コードリーダーは、jsQR (opens new window)の動作仕様に依存します。なお、使用ライブラリは予告なく更新、変更される可能性があります。

                                                        例

                                                          # 構文

                                                          liff.scanCodeV2()

                                                          # 引数

                                                          なし

                                                          # 戻り値

                                                          Promiseオブジェクトが返されます。

                                                          二次元コードリーダーで文字列が読み取れると、Promiseがresolveされ、読み取った文字列を含むオブジェクトが渡されます。

                                                          value

                                                          String

                                                          二次元コードリーダーで読み取った文字列

                                                          # liff.scanCode()

                                                          liff.scanCode()メソッドは非推奨です

                                                          従来のliff.scanCode()メソッドは非推奨になります。二次元コードリーダーを実装する場合は、liff.scanCodeV2()メソッドを使用することをお勧めします。


                                                          LINEの二次元コードリーダーを起動し、読み取った文字列を取得します。二次元コードリーダーを起動するには、あらかじめLINE Developersコンソールで、 [Scan QR] をオンにする必要があります。

                                                          iOS版LINEバージョン9.19.0以降では使用できません

                                                          liff.scanCode()は以下の環境で動作します。

                                                          • iOS：LINEバージョン9.18.0以前
                                                          • Android：すべてのLINEバージョン
                                                          OS バージョン LINEアプリのバージョン 外部ブラウザ
                                                          9.18.0以前 9.19.0〜11.6.x 11.7.0以降
                                                          iOS 11〜14.2 ✅ ❌ ❌ ❌
                                                          14.3以降 ✅ ❌ ❌ ❌
                                                          Android すべてのバージョン ✅ ✅ ✅ ❌
                                                          PC すべてのバージョン ❌ ❌ ❌ ❌

                                                          技術的な問題があり、iOS版LINEバージョン9.19.0以降では、liff.scanCodeはundefinedになります。サンプルコードのように、関数の存在を確認してから、使用してください。なお、最新のiOS版LINEや外部ブラウザでも二次元コードリーダーをお使いになりたい場合は、「liff.scanCodeV2()」を参照してください。

                                                          二次元コードリーダーを起動するには［Scan QR］をオンにしてください

                                                          例

                                                            # 構文

                                                            liff.scanCode()

                                                            # 引数

                                                            なし

                                                            # 戻り値

                                                            Promiseオブジェクトが返されます。

                                                            LINEの二次元コードリーダーで文字列が読み取れると、Promiseがresolveされ、読み取った文字列を含むオブジェクトが渡されます。

                                                            value

                                                            String

                                                            二次元コードリーダーで読み取った文字列

                                                            # liff.closeWindow()

                                                            LIFFアプリを閉じます。

                                                            LIFFアプリ初期化前でも実行できます

                                                            このメソッドは、LIFF SDKバージョンが2.4.0以上、ユーザーのLINEバージョンが10.15.0以上の場合のみ、liff.init()によるLIFFアプリの初期化が終了する前でも実行できます。

                                                            注意

                                                            liff.closeWindow()の外部ブラウザでの利用は、保証対象外です。

                                                            例

                                                              # 構文

                                                              liff.closeWindow()

                                                              # 引数

                                                              なし

                                                              # 戻り値

                                                              なし

                                                              # liff.initPlugins()

                                                              プラグインを有効化します。

                                                              たとえば、Bluetoothプラグインを有効化すると、Bluetoothプラグインが提供するクライアントAPI（liff.bluetooth.*）が使用できます。

                                                              例

                                                                # 構文

                                                                liff.initPlugins(pluginNames)

                                                                # 引数

                                                                pluginNames

                                                                Stringの配列

                                                                必須

                                                                プラグインの名前。以下のいずれかの値を指定します。

                                                                • bluetooth
                                                                  ※なお、Bluetoothプラグインは、Android版のLINEまたはiOS版のLINE 9.19.0未満の場合のみ、有効化できます。iOS版のLINE 9.19.0以降では 有効化に失敗し、FORBIDDENエラーが返されます。

                                                                # 戻り値

                                                                Promiseオブジェクトが返されます。

                                                                • プラグインの有効化が成功すると、Promiseがresolveされます。
                                                                • プラグインの有効化に失敗すると、Promiseがrejectされ、エラー情報が渡されます。

                                                                # liff.bluetooth.getAvailability()

                                                                iOS版LINEバージョン9.19.0以降では使用できません

                                                                技術的な問題があり、iOS版LINEバージョン9.19.0以降では、liff.bluetooth.getAvailability()の提供を一時停止しています。

                                                                Bluetoothプラグインが利用できるかどうかを確認します。このメソッドを実行すると、以下の内容が確認されます。

                                                                • チャネルに追加したLIFFアプリのBluetoothサポートの有無

                                                                  注意

                                                                  チャネルに追加したLIFFアプリのBLE機能を有効にしていないと、Bluetoothプラグインは有効化できません。

                                                                • スマートフォンのBluetooth設定

                                                                • ユーザーがLINE Thingsの利用規約に同意していること

                                                                • ユーザーがLINEをAndroidで使用している場合は、位置情報の取得権限

                                                                注意

                                                                あらかじめliff.initPlugins()を使用して、Bluetoothプラグインを有効化してください。

                                                                例

                                                                  # 構文

                                                                  liff.bluetooth.getAvailability()

                                                                  # 引数

                                                                  なし

                                                                  # 戻り値

                                                                  Promiseオブジェクトが返されます。

                                                                  Bluetoothプラグインが利用できるかどうかが確認されると、Promiseがresolveされ、Bluetoothプラグインが利用できるかどうかを示すBooleanオブジェクトが渡されます。

                                                                  # liff.bluetooth.requestDevice()

                                                                  iOS版LINEバージョン9.19.0以降では使用できません

                                                                  技術的な問題があり、iOS版LINEバージョン9.19.0以降では、liff.bluetooth.requestDevice()の提供を一時停止しています。

                                                                  連携済みのデバイスをスキャンし、情報を取得します。

                                                                  フィルターを使って、アドバタイズメントパケットを受け入れるデバイスを制限できます。

                                                                  注意

                                                                  あらかじめliff.initPlugins()を使用して、Bluetoothプラグインを有効化してください。

                                                                  例

                                                                    # 構文

                                                                    liff.bluetooth.requestDevice(options)

                                                                    # 引数

                                                                    options

                                                                    Object

                                                                    任意

                                                                    フィルターを表すRequestDeviceOptionsオブジェクト。省略したときは、すべてのデバイスからのアドバタイズメントパケットを受け入れます。

                                                                    # データオブジェクト
                                                                    # RequestDeviceOptionsオブジェクト

                                                                    filters

                                                                    Objectの配列

                                                                    必須

                                                                    LINEBluetoothRequestDeviceFilterオブジェクトの配列

                                                                    # LINEBluetoothRequestDeviceFilterオブジェクト

                                                                    deviceId

                                                                    String

                                                                    必須

                                                                    アドバタイズメントパケットを受け入れるデバイスのデバイスID

                                                                    # 戻り値

                                                                    Promiseオブジェクトが返されます。

                                                                    連携済みのデバイスをスキャンし、情報を取得できると、Promiseがresolveされ、デバイスの情報を示すBluetoothDeviceオブジェクトが渡されます。

                                                                    # データオブジェクト
                                                                    # BluetoothDeviceオブジェクト

                                                                    id

                                                                    String

                                                                    必須

                                                                    デバイスID

                                                                    name

                                                                    String

                                                                    任意

                                                                    デバイス名

                                                                    gatt

                                                                    Object

                                                                    任意

                                                                    BluetoothRemoteGATTServerオブジェクト

                                                                    watchingAdvertisements

                                                                    Boolean

                                                                    必須

                                                                    アドバタイズメントパケットの監視状況（※）

                                                                    メソッド 戻り値 説明
                                                                    watchAdvertisements Promise <void> アドバタイズメントパケットの受け入れを開始します。（※）
                                                                    unwatchAdvertisements void アドバタイズメントパケットの受け入れを停止します。（※）
                                                                    addEventListener void イベントリスナーを登録します。advertisementreceivedイベント（※）とgattserverdisconnectedイベントに、イベントリスナーを登録できます。
                                                                    removeEventListener void 登録済みのイベントリスナーを削除します。advertisementreceivedイベント（※）とgattserverdisconnectedイベントに登録したイベントリスナーを削除できます。

                                                                    ※試験的に実装している機能です。これらの機能は予告なく変更、または停止される可能性があります。

                                                                    # BluetoothRemoteGATTServerオブジェクト

                                                                    デバイスと通信するには、GATTサーバー（汎用アトリビュートプロファイルサーバー）を表すBluetoothRemoteGATTServerオブジェクトを使用します。

                                                                    liff.bluetooth.requestDevice()実行後、Promiseがresolveすると、BluetoothDeviceオブジェクトのgattプロパティから、BluetoothRemoteGATTServerにアクセスできます。

                                                                    device

                                                                    Object

                                                                    必須

                                                                    BluetoothDeviceオブジェクト

                                                                    connected

                                                                    Boolean

                                                                    必須

                                                                    接続している場合はtrue。接続していない場合はfalse

                                                                    メソッド 戻り値 説明
                                                                    connect Promise <BluetoothRemoteGATTService> デバイスと接続します。
                                                                    disconnect void デバイスのGATTサーバーから切断します。
                                                                    getPrimaryService(serviceUUID) Promise <BluetoothRemoteGATTService> GATTサーバーのプライマリサービスを取得します。serviceUUIDには、128ビットのUUIDを文字列で指定します。
                                                                    注：このメソッドはUUIDを検証しません。UUIDの検証は、characteristicの読み込み、書き込み、通知の開始、通知の停止を実行する際に行われます。
                                                                    # BluetoothRemoteGATTServiceオブジェクト

                                                                    BluetoothRemoteGATTServiceオブジェクトは、characteristicを取得するためのオブジェクトです。

                                                                    device

                                                                    Object

                                                                    必須

                                                                    BluetoothDeviceオブジェクト

                                                                    uuid

                                                                    String

                                                                    必須

                                                                    GATT Service UUID

                                                                    メソッド 戻り値 説明
                                                                    getCharacteristic(characteristicUUID) Promise <BluetoothRemoteGATTCharacteristic> characteristicを取得します。characteristicUUIDには、128ビットのUUIDを文字列で指定します。
                                                                    注：このメソッドはUUIDを検証しません。UUIDの検証は、characteristicの読み込み、書き込み、通知の開始、通知の停止を実行する際に行われます。
                                                                    # BluetoothRemoteGATTCharacteristicオブジェクト

                                                                    BluetoothRemoteGATTCharacteristicオブジェクトは、デバイスのcharacteristicの読み込み、書き込み、通知の開始、通知の停止を実行するためのオブジェクトです。

                                                                    service

                                                                    Object

                                                                    任意

                                                                    BluetoothRemoteGATTServiceオブジェクト

                                                                    uuid

                                                                    String

                                                                    必須

                                                                    UUID

                                                                    value

                                                                    Object

                                                                    任意

                                                                    DataViewオブジェクト (opens new window)

                                                                    メソッド 戻り値 説明
                                                                    readValue Promise <DataView (opens new window)> characteristicの値を読み取ります。
                                                                    writeValue(value) Promise <void> characteristicにBufferSource (opens new window)の値を書き込みます。
                                                                    startNotifications Promise <BluetoothRemoteGATTCharacteristic> characteristic変更の通知を開始します。
                                                                    stopNotifications Promise <BluetoothRemoteGATTCharacteristic> characteristic変更の通知を停止します。
                                                                    addEventListener void イベントリスナーを登録します。targetプロパティを含むcharacteristicvaluechangedイベントに、イベントリスナーを登録できます。
                                                                    removeEventListener void 登録済みのイベントリスナーを削除します。characteristicvaluechangedイベントに登録したイベントリスナーを削除できます。
                                                                    注意

                                                                    readValue()メソッド、writeValue()メソッド、startNotifications()メソッド、stopNotifications()メソッドは、UUIDとプロパティを検証します。存在しないUUIDやプロパティを指定した場合は、エラーが発生します。

                                                                    例

                                                                      # イベント

                                                                      # advertisementreceivedイベント

                                                                      アドバタイズメントパケットを受信すると、advertisementreceivedイベントが発生します。

                                                                      注意

                                                                      advertisementreceivedイベントは、試験的に実装している機能です。この機能は予告なく変更、または停止される可能性があります。

                                                                      device

                                                                      Object

                                                                      必須

                                                                      BluetoothDeviceオブジェクト

                                                                      name

                                                                      String

                                                                      任意

                                                                      デバイス名

                                                                      rssi

                                                                      Number

                                                                      任意

                                                                      RSSI

                                                                      manufacturerData

                                                                      Object

                                                                      任意

                                                                      Map<Number, DataView>オブジェクト。会社識別コード（Company Identifier Code）をDataViewオブジェクトにマップしたデータです。

                                                                      # gattserverdisconnectedイベント

                                                                      さまざまな理由でBluetooth接続が切断されると、gattserverdisconnectedイベントが発生します。必ずイベントリスナーを登録してください。

                                                                      例

                                                                        # characteristicvaluechangedイベント

                                                                        characteristicが変更されると、characteristicvaluechangedイベントが発生します。

                                                                        # liff.bluetooth.referringDevice

                                                                        iOS版LINEバージョン9.19.0以降では使用できません

                                                                        技術的な問題があり、iOS版LINEバージョン9.19.0以降では、liff.bluetooth.referringDeviceの提供を一時停止しています。

                                                                        LIFFアプリがデバイス経由で起動された場合、liff.bluetooth.referringDeviceに、そのデバイスの情報を示すBluetoothDeviceオブジェクトが設定されます。