LIFF v2 新增支援外部瀏覽器與二維條碼掃描器等功能

LIFF v2

各位好,我是 Sho Tachibana,我在 LINE 擔任技術傳播者,負責協助各位開發者成功使用 LINE 的 API 並創造商機。

LIFF (LINE Front-end Framework) v2 版本正式上線,新增可由 In App Browser 與外部瀏覽器使用的功能。如欲取得更多 LIFF 相關資訊,請查看這篇介紹。

※ QR code 為 Denso Wave Inc. 的註冊商標。

主要變更項目

支援 LINE App 以外的環境

v1 版本中的 liff.init() 等函式,不論是在採用 iOS 或 Android 系統的裝置上,當請求以 line://app 開頭的 URL 時,只有在 LINE 上開啟的 View 可執行動作。但 v2 版本考慮到由 In App Browser 與外部瀏覽器使用的情況,因而優化了認證處理與訊息發送的功能。

可取得用戶的電子郵件地址

提升與 LINE 登入 v2.1 的相容性,因此可取得用戶的電子郵件地址。

追加用戶端 API

配合前項變更,追加可輕鬆使用新增功能的 API。

函式支援版本
liff.init(successCallback, errorCallback)v1
liff.init(config, successCallback, errorCallback)v2
liff.openWindow()v1
liff.getAccessToken()v1
liff.getProfile()v1
liff.sendMessages(messages)v1
liff.closeWindow()v1
liff.initPlugins([“bluetooth”])v1
liff.getOS()v2
liff.getLanguage()v2
liff.getVersion()v2
liff.isInClient()v2
liff.isLoggedIn()v2
liff.login()v2
liff.logout()v2
liff.getAccessToken()v2
liff.scanCode()v2

使用方法

liff.init(config, successCallback, errorCallback)

開始使用 SDK v2 時,務必等待頁面讀取完成後再執行 API。

SDK v2 版本使用 LIFF 時須轉移 liffId,因此 config 變成必要參數。

詳情請見此處

liff.getOS()

回傳 iosandroidweb 其中之一的數值。

詳情請見此處

liff.getLanguage()

以字串回傳讓 LIFF App (意指引進 LIFF SDK 的網頁應用程式) 執行動作的環境語言設定。

詳情請見此處

liff.getVersion()

以字串方式回傳 LIFF SDK 的版本。

詳情請見此處

liff.isInClient()

回傳服務目前是否由 LINE App 存取。

詳情請見此處

liff.isLoggedIn()

用戶使用 LINE 帳號登入時,將回傳 true。在 true 的情況下,可呼叫需要 Access Token) 的 API。

詳情請見此處

liff.login()

讓用戶轉換至 LINE登 入畫面,可藉由設定任一引數 loginConfig.redirectUrl,指定登入後轉換的目的地。未指定時,將轉換至作為 LIFF 端點設定的 URL。

成功登入時,資料將儲存至 Cookie,因此,在轉換後的目的地仍可使用需要認證的用戶端 API。

此外,本 API 僅限由 LINE App 以外的其他瀏覽器存取時使用。

詳情請見此處

liff.logout()

將用戶登出。

詳情請見此處。 

liff.getAccessToken()

取得目前存取中的用戶 Access Token。

詳情請見此處。 

liff.scanCode()

開啟二維條碼掃描器,掃描結果將以字串型態移交給回呼函式。

此外,本 API 僅限於已被給予 ScanQR 權限的 LIFF,且在 LINE App 上開啟時方可使用。

詳情請見此處

總結

更新至 v2 版本後,可輕鬆將使用 LINE 的認證功能,安裝至支援多平台的 web 應用。

LINE 目前在日本每個月有 8,100 萬名用戶使用,除了 LIFF 之外,亦提供多種協助研發服務的 API,例如 Messaging APILINE Pay API 等。

我們衷心期待有更多充分活用 API 的優質服務出現。

如需瀏覽文件請點擊此處