すべてのプロダクト
Search
ドキュメントセンター

SuperApp:wv.getSetting

最終更新日:Apr 21, 2026

現在のミニアプリに対するユーザーの権限付与ステータスを取得します。この API は wv.authorize インターフェイスと併用します。

リクエストパラメーター

パラメーター

必須

説明

success

Function

いいえ

呼び出しが成功した場合のコールバック関数です。

fail

Function

いいえ

呼び出しが失敗した場合のコールバック関数です。

レスポンスパラメーター

成功時のコールバック関数は、ユーザーの権限付与設定を含むオブジェクトを受け取ります。

パラメーター

説明

authSetting

Object

ユーザーの権限付与の結果です。このオブジェクトの各キーは権限の範囲を表し、対応するブール値は権限が付与されているかどうかを示します。

authSetting オブジェクトには、次のプロパティがあります。

パラメーター

説明

location

Boolean

位置情報の権限付与ステータスです。値が false の場合は、権限が付与されていないことを示します。関連インターフェイス:WVLocation.getLocation および WVLocation.searchLocation

camera

Boolean

カメラの権限付与ステータスです。値が false の場合は、権限が付与されていないことを示します。関連インターフェイス:WVScan.scan

bluetooth

Boolean

Bluetooth の権限付与ステータスです。値が false の場合は、権限が付与されていないことを示します。関連インターフェイス:WVBluetooth のすべてのメソッド。

album

Boolean

アルバムの権限付与ステータスです。値が false の場合は、権限が付与されていないことを示します。関連インターフェイス:WVVideo.chooseVideo および WVCamera.takePhoto

contacts

Boolean

連絡先の権限付与ステータスです。値が false の場合は、権限が付与されていないことを示します。関連インターフェイス:WVContacts のすべてのメソッド。

microphone

Boolean

マイクの権限付与ステータスです。値が false の場合は、権限が付与されていないことを示します。関連インターフェイス:WVMotion.listenBlow および WVMotion.stopListenBlow

file

Boolean

ファイルアクセスの権限付与ステータスです。値が false の場合は、権限が付与されていないことを示します。関連インターフェイス:WVFile のすべてのメソッド、WVVideo.saveVideoToPhotosAlbum、および WVImage.saveImage

call

Boolean

通話の権限付与ステータスです。値が false の場合は、権限が付与されていないことを示します。関連インターフェイス:WVCall.dial および WVCall.call

vibrate

Boolean

バイブレーションの権限付与ステータスです。値が false の場合は、権限が付与されていないことを示します。関連インターフェイス:WVMotion.vibrate

screen

Boolean

画面キャプチャの権限付与ステータスです。値が false の場合は、権限が付与されていないことを示します。関連インターフェイス:WVScreenCapture.capture

失敗した場合、fail コールバックは次のエラー情報を含むオブジェクトを受け取ります。

エラーメッセージ

説明

ソリューション

You need to configure the authorization switch to apply for authorization

権限付与スイッチが有効になっていません。

コンテナの初期化時に権限付与スイッチが設定されていることを確認してください。

User not bound

ユーザー ID がコンテナに登録されていません。

コンテナにユーザー情報を登録する際に、ユーザー ID を渡してください。

サンプルコード

window.WindVane.call('wv', 'getSetting', {}, function(res) {
    const { camera = false, location = false } = res.authSetting;
}, function(e) {
    alert('failure:' + JSON.stringify(e));
});