wv.authorize によるデバイスアクセスの有効化 - SuperApp - Alibaba Cloud - SuperApp

ミニアプリがデバイス関連の JavaScript API (詳細はスコープリストをご参照ください) を呼び出す前に、ユーザーに権限付与をリクエストする必要があります。この API は、ユーザーに機能の使用や特定のデータへのアクセス権限をミニアプリに付与するよう促しますが、対応する JavaScript API を呼び出すことはありません。ユーザーがすでに権限を付与している場合、この呼び出しはプロンプトをスキップし、直ちに `success` コールバックを呼び出します。

リクエストパラメーター

パラメーター	型	必須	説明
scope	String	はい	リクエストする権限スコープ。
success	Function	いいえ	権限付与が成功した場合のコールバック。
fail	Function	いいえ	権限付与が失敗した場合のコールバック。

スコープリスト

スコープ	説明	API
location	地理的位置	WVLocation.getLocation、WVLocation.searchLocation
camera	カメラ	WVScan.scan
bluetooth	Bluetooth	WVBluetooth のすべてのメソッド
album	アルバム	WVCamera、WVVideo.chooseVideo
contacts	連絡先	WVContacts のすべてのメソッド
microphone	マイク	WVMotion.listenBlow、WVMotion.stopListenBlow
file	ファイル	WVFile のすべてのメソッド、WVImage.saveImage、WVVideo.saveVideoToPhotosAlbum
call	電話	WVCall.dial、WVCall.call
vibrate	バイブレーション	WVMotion.vibrate
screen	画面キャプチャ	WVScreenCapture.capture

レスポンスパラメーター

success コールバック関数は、次の属性を持つ object を受け取ります。

属性	型	説明
successScope	JSONObject	ユーザーが権限を付与したスコープ。
msg	String	操作が失敗した場合のエラーメッセージ。

fail コールバック関数は、msg 属性にエラーメッセージを含む object を受け取ります。

エラーメッセージ	説明	解決策
You need to configure the authorization switch to apply for authorization	権限付与スイッチを有効にする必要があります。	コンテナの初期化時に権限付与スイッチが設定されているか確認してください。
Parameter parsing exception	リクエストパラメーターを解析できませんでした。	リクエストパラメーターのフォーマットを確認してください。
Authorization scope cannot be empty	`scope` パラメーターが null です。	`scope` パラメーターを確認してください。
User not bound	`UserId` がコンテナに登録されていません。	コンテナのユーザー情報を確認し、`UserId` が提供されていることを確認してください。
User refuses authorization request	ユーザーが権限付与リクエストを拒否しました。	ユーザーに権限付与を促すために、なぜその機能が必要なのかを説明してください。
The authorization you requested does not exist. Please check the parameters	指定された `scope` は有効な値ではありません。	`scope` パラメーターの値が無効です。サポートされている値については、スコープリストを確認してください。

サンプルコード

window.WindVane.call('wv', 'getSetting', {}, function(res) {
    if (!res.authSetting['location']) {
      	window.WindVane.call('wv', 'authorize', {scope: 'location'}, function(res) {
          	if (res.successScope['location']) {
              	alert('success authorize location');
              	// 必要な JavaScript API を呼び出します。
            }
        }, function(e) {
          	alert('failure:' + JSON.stringify(e));
        })
    } else {
      	alert('success authorize location');
    }
}, function(e) {
    alert('failure:' + JSON.stringify(e));
});