Authing Mini Program SDK (authing-wxapp-sdk) は、WeChat ミニ プログラム環境での使用に適しています。authing-js-sdk (新しいウィンドウを開きます) に基づいて、WeChat ミニ プログラム環境に適合します。 。ユーザー情報の取得と変更、ユーザー定義フィールドの追加など、AuthenticationClient authing-js-sdk (新しいウィンドウが開きます) のすべてのメソッドを使用できます。同時に、ミニプログラム環境で特別に使用され、WeChat 認証によるユーザーの携帯電話番号の取得、WeChat 認証によるログイン、WeChat 認証による携帯電話番号へのログインなどを行います。
ソース コード: y.wxlbyx.icu
●認証時のアプレット ログインの設定
●インストール
○npm パッケージをインストールする
○アプレット開発者ツールでnpm をビルドする
●初期化
●使い方 a > ○ 電話番号の取得< /a > ●ヘルプの表示 アプレット開発者ツールで npm を構築します。 a> a> 開発者ツールのメニュー バーをクリックします: [ツール] --> [npm のビルド]: 糸追加 authing-wxapp-sdk 糸を使用します: npm install authing -wxapp -sdk npm を使用する: npm パッケージをインストールする ミニ プログラム ベース ライブラリ 2.2.1 以降、開発者ツール 1.02.1808300 から上記のバージョンから、ミニ プログラムは npm を使用したサードパーティ パッケージのインストールをサポートします。詳細については、次を参照してください: [npm サポート | WeChat オープン ドキュメント] #インストール ミニ プログラム ログインの構成 ミニ プログラムで認証ミニ プログラム SDK を使用するには、WeChat オープン プラットフォーム (オープン プラットフォーム) でミニ プログラムを申請する必要があります。新しいウィンドウ) と同時に、[認証コンソール] (https://console.authing.cn/console/userpool) でミニ プログラムの設定を入力します。 認証時にミニ プログラムのログインを構成する ●エラー処理 ●ベストプラクティス ○アバターの更新 ○ 電話によるログイン ○ コードによるログイン
●API リファレンス
npm モジュールの使用オプションを確認します。
初期化
AuthenticationClient はユーザー プール ID (userPoolId) を渡す必要があります。
UserPoolId を取得する方法については、こちらをご覧ください (新しいウィンドウを開きます) ） ここ。ユーザー プールの概念に詳しくない場合は、ここをクリックして認証システムの中心的な概念について学ぶことができます (新しいウィンドウが開きます)。
const {AuthenticationClient} = require("authing-wxapp-sdk")
const authing = new AuthenticationClient({ userPoolId: "YOUR_USERPOOL_ID", }) 完全なパラメータ リストは次のとおりです: ●userPoolId: ユーザープールID。 ●accessToken: ユーザーのトークンを使用して SDK を初期化します。 タイムアウト: リクエストのタイムアウト (ミリ秒単位)、デフォルトは 10000 (10 秒)。 ●onError: エラー処理関数。これを使用して、認証クライアントによって要求されたすべての例外をグローバルにキャプチャできます。この関数は、 (code:number, message:string, data:any) => void ●host: 認証サーバーのアドレスとして定義されます。パブリック クラウド バージョンを使用している場合は、このパラメータを無視してください。プライベート展開バージョンを使用している場合、このパラメーターは必須です。 手順 ユーザーがログインすると、SDK はユーザーの情報トークンを WeChat のストレージに書き込み、後続のリクエストではトークン アクセス用にこの情報が自動的に送信されます。 const {code} = await wx.login() // ユーザー認証は必要ありません const user = await 認証。 loginByCode(code); // ログイン成功、トークンを WeChat ストレージに書き込みます // これはログイン後に実行できます await authing.updateProfile(< /a > const {rawData} = e.detail const {code} = await wx.login() getUserInfo: async function (e) { ; - ユーザーマニュアル認証の最初のリクエスト 初回のみ認証が必要です。認証後、ユーザーは wx.getUserInfo を使用してアバターのニックネームを直接取得できます。 ユーザーマニュアル ニックネームアバター取得の認証 const data = await authing.loginByCode(code) const {code} = await wx.login() 初回プロフィールのニックネームとアバターユーザーのアバターとニックネームがまだ取得されていないため、登録ユーザーは空になります。 1. サイレント認証 #Example Options.rawData からユーザー データを暗号化しようとします: WeChat ボタン コンポーネント (新しいウィンドウが開きます) は rawData iv cryptoData rawData` とともに渡されます。 , 認証サーバーは、このデータをユーザーのオープンタイプのプロファイルとして直接使用します。初めて使用するには、ユーザーによる手動の認証が必要です。選択制。 getUserInfo. どちらかを選択+. If Options.encryptedData: WeChat ボタン コンポーネント (新しいウィンドウが開きます) を暗号化データとして暗号化しようとします。 iv 暗号化データ iv 暗号化データオープンタイプ。初めて使用するには、ユーザーによる手動の認証が必要です。選択制。 getUserInfo.and を同時に渡す必要があります。認証サーバーは、 ●options.iv: WeChat ボタン コンポーネント (新しいウィンドウが開きます) および iv iv 暗号化データ iv 暗号化データ オープンタイプ`。初めて使用するには、ユーザーによる手動の認証が必要です。選択制。 getUserInfo.and を同時に渡す必要があります。認証サーバーは、 ●選択肢：選択。 ●code: wx.login()code を呼び出すことによって取得される呼び出し (新しいウィンドウが開きます)。ユーザーの承認は必要ありません。必須。 #パラメータ - ユーザーが初めてミニ プログラムにログインし、同じプリンシパルでログインするためにミニ プログラムにバインドされた WeChat アプリケーションを使用しない場合、新しいアカウントが作成されます。 - ユーザーが初めてミニ プログラムにログインするが、同じテーマのミニ プログラムにバインドされた WeChat アプリケーションを使用して既にログインしている場合、対応する WeChat アカウントが返されます。 WeChat 認証を使用してログインします。 #コード経由でログイン Nickick : 39;Mick' 新しいウィンドウを開きます)、呼び出し方法は authing-js-sdk とまったく同じです。 await authing.updateProfile( // ユーザーがログインしているため、リクエストは成功する可能性があります。 後続のユーザーは再びミニ プログラムを開きます。ユーザーのトークンはユーザーのトークンであり、認証へのアクセス要求には自動的にトークンが送信されます。 ) ニックネーム:'Bob'
const user = await authing.loginByCode(code, {rawData })
// または iv encryptedData を渡します
// const {iv, encryptedData } = e.detail
// const user = await authing.loginByCode(code, {iv, encryptedData })
console.log(user)< /a > const {rawData} = await wx を自動的に取得できるようになります。 getUserInfo() - 将来的には、wx.getUserInfo
} // または iv encryptedData を渡します // const {iv, encryptedData} = e.detail // const user = await authing.loginByCode(code, {iv, encryptedData }) ログイン電話による WeChat 携帯電話番号による認証されたログイン。各呼び出しには、ユーザーによる手動の承認が必要です。 - 初めて携帯電話番号を登録すると、WeChat アカウントに関連付けられます (存在しない場合は作成します)。 - 電話番号が以前に登録されている場合は、その電話番号に対応するアカウントを返し、電話番号を現在の WeChat アカウントにバインドします。 #パラメータ ●code: wx.login()code を呼び出すことによって取得される呼び出し (新しいウィンドウが開きます)。ユーザーの承認は必要ありません。必須。 iv: WeChat ボタン コンポーネント (新しいウィンドウを開く) は、クリック イベントの時点でオープン タイプを返します。必須。 getPhoneNumberiv ●encryptedData: getPhoneNumber としてオープンタイプを持つ WeChat ボタン コンポーネント (新しいウィンドウが開きます) encryptedData はクリック イベントによって返されます。必須。 例 電話番号を取得< /span> a> console.log(photo) const {photo} = await authing.updateAvatar() 例 ユーザーのアバターを更新します。このメソッドは自動的に wx.chooseImage を呼び出して画像を取得し、Authing の CDN にアップロードします。呼び出すのに必要なコードは 1 行だけです。 #アバターの更新 } ; U" "purePhoneNumber" ;: "176xxxx6754", '電話番号': "176xxxx6754"、 "国コード": "86"、 { 返されるデータの例: } console.log(data) const データ= await authing.getPhone(code, iv, encryptedData) const {iv, encryptedData} = e.detail const {code} = await wx.login() getPhone: 非同期関数(e) { <button open-type="getPhoneNumber" bindinggetphonenumber="getPhone"> 電話番号を取得 </button> 例 ●encryptedData: getPhoneNumber としてオープンタイプを持つ WeChat ボタン コンポーネント (新しいウィンドウが開きます) encryptedData はクリック イベントによって返されます。必須。 ●iv: WeChat ボタン コンポーネント (新しいウィンドウが開きます) は、クリック イベントの時点でオープン タイプに戻ります。必須。 getPhoneNumberiv コード: call wx.login() コードはユーザーの承認なしに呼び出されます (新しいウィンドウが開きます)。必須。 パラメータ 現在のユーザーの携帯電話番号を取得します (この携帯電話番号はアカウントの登録やバインドには使用されません) } console.log(data) const データ= await authing.loginByPhone(code, iv, encryptedData) const {iv, encryptedData} = e.detail const {code} = await wx.login() getPhone: async function(e) {
ユーザー loginByCode は、初めてミニ プログラムを使用するときに、ミニ プログラム アカウントに対応する認証アカウントを取得することをお勧めします。アカウントが以前に携帯電話番号にバインドされていた場合は、ユーザーに携帯電話番号を再度認証するように要求する必要はありません。アカウントが携帯電話番号にバインドされていない場合は、loginByPhone メソッドを呼び出して、ユーザーに携帯電話番号の認証を要求します。
ユーザーがログインすると、authing-wxapp-sdk はトークンをストレージ アプレットに書き込みます。authing.checkLoginStatus() を呼び出してユーザーのトークンが有効かどうかを確認し、トークンが有効になったら再起動できます。トークンが無効です。ログインしてください。
エラー処理
try catch エラー処理を使用できます。
try { const user = await authing.loginByEmail('[email protected]','passw0rd') } catch （エラー） { console.log(error.code); // 2004 console.log(error.message); // ユーザーが存在しません< a i=9> } 完全なエラー コードについては、このドキュメントを参照してください (新しいウィンドウが開きます)。 onError を指定して、WeChat コンポーネントや他の wx.showModal を使用してエラー プロンプトを表示するなど、すべての認証リクエストの例外を均一にキャプチャすることもできます。 const authing = new AuthenticationClient({ userPoolId, onError: (コード, メッセージ) => { wx.showModal({ コンテンツ: メッセージ、 showCancel: false }) } })