起動時の権限付与方法
起動方法 | 複合権限付与 | コメント |
wv.authorize | この関数はグローバルにサポートされています。 |
|
wv.getAuthCode | この関数はグローバルにサポートされています。 |
|
wv.authorize ユーザー デバイス情報権限付与プロセス
前提条件
sdk の初期化中に、アプリ開発者はコンテキストに応じて、needAuthFromApp プロパティを EMASMiniAppInitConfig または MiniAppInitConfig クラス内で「true」に設定する必要があります。
アクセス準備
ミニアプリがデバイス情報関連の API（WVLocation.getLocation、WVVideo.chooseVideo など）を呼び出すと、APP は権限付与のプロンプトを表示し、ユーザーが現在のミニアプリへのアクセスを許可するかどうかを決定できるようにする必要があります。ミニアプリ開発者は、wv.getSetting を呼び出して、現在のミニアプリの権限付与ステータスを確認できます。
権限付与が必要な API を使用する場合、ユーザーは 2 つの異なるレベルで権限付与プロセスを完了する必要があります。1. APP 内でミニアプリを承認する。2. システム レベルで対応する機能を有効にし、APP に対して権限を付与する。2 つのレベルの権限付与ステータスは互いに独立しています。
ミニアプリの権限付与に関連するロジック
ユーザーがミニアプリを承認していない場合、権限が必要な API を呼び出すには、最初に wv.authorize メソッドを呼び出す必要があります。これにより、ユーザーに権限付与のプロンプトがポップアップ表示されます。
ユーザーが同意した場合、API の主な機能が実行され、この API を今後呼び出す際に権限付与のプロンプトは表示されなくなります。ユーザーが拒否した場合、失敗コールバックが直接トリガーされ、ユーザーに権限付与が拒否されたことが通知されます。API を再度呼び出すと、権限付与のプロンプトがユーザーに再び表示されます。
ユーザーが拒否した場合、失敗コールバックが直接トリガーされ、ユーザーに権限付与が拒否されたことが通知されます。API を再度呼び出すと、権限付与のプロンプトがユーザーに再び表示されます。
権限付与が必要で、ユーザーがミニアプリに対して権限付与していない API の場合は、最初に wv.getting メソッドを使用して確認し、次に wv.authorize メソッドを呼び出し、最後に権限付与が必要な API を呼び出すことをお勧めします。
システムレベルの権限に関連するロジック
API で必要な特定の権限がシステムで有効になっていない場合、または APP に対して権限付与されていない場合、ユーザーが現在のミニアプリへの権限付与に同意しても、API 呼び出しは失敗します。通常、ミニアプリによる API の最初の呼び出しでは、APP がシステムから権限を申請することもトリガーされ、ユーザーには対応する権限付与のプロンプトまたはガイダンス インターフェイスが表示されます。ユーザーが拒否した後、API を繰り返し呼び出すと、失敗コールバックが直接トリガーされる場合があります。 WVUIDialog.showAuthGuide を呼び出すことで、権限付与ガイダンスを積極的に呼び出すことができます。
wv.getAuthCode ユーザー個人 情報権限付与プロセス
wv.getAuthCode は、ユーザーに現在のミニアプリへの情報の権限付与を促し、権限付与ガイダンスのポップアップウィンドウが表示されます。 wv.getAuthCode を呼び出す前に、ユーザーがミニアプリ サービスを理解していることを確認し、ユーザー エクスペリエンスを保護するために初期画面でトリガーしないようにしてください。
wv.getAuthCode を介して取得された authCode は、ユーザーの同意の証明として機能し、ミニプログラムのサーバーがプラットフォームから詳細なユーザー情報を取得するために使用する必要があります。これには、user_id、プロフィール写真、ユーザー名、連絡先番号、場所、性別、生年月日が含まれます。
スコープベースの権限制御
スコープは、開発者がユーザーから取得する必要がある権限の範囲を示します。
権限のスコープはコンソールで指定する必要があります。
機密情報に関連するスコープでは、ユーザーが権限付与を開始する必要があります。この場合、ポップアップウィンドウは表示されません。
スコープ | API | 説明 | トリガー方法 |
USER_ID | - | 開発者はアプリ ユーザーの ID を取得する権限があります。権限付与プロセス中にポップアップウィンドウは表示されません。 | 権限付与 API: wv.getAuthCode |
USER_NICKNAME | -開発者はアプリ ユーザーのニックネームを取得する権限があります。 | 権限付与 API: wv.getAuthCode | |
USER_NAME | -開発者はアプリ ユーザーの名前を取得する権限があります。 | 権限付与 API: wv.getAuthCode | |
USER_LOGIN_ID | -開発者はアプリ ユーザーのログイン ID を取得する権限があります。 | 権限付与 API: wv.getAuthCode | |
HASH_LOGIN_ID | -開発者はアプリ ユーザーのログイン ID のハッシュ値を取得する権限があります。 | 権限付与 API: wv.getAuthCode | |
USER_AVATAR | -開発者はアプリ ユーザーのアバターを取得する権限があります。 | 権限付与 API: wv.getAuthCode | |
USER_GENDER | -開発者はアプリ ユーザーの性別を取得する権限があります。 | 権限付与 API: wv.getAuthCode | |
USER_BIRTHDAY | -開発者はアプリ ユーザーの生年月日を取得する権限があります。 | 権限付与 API: wv.getAuthCode | |
USER_NATIONALITY | -開発者はアプリ ユーザーの国籍を取得する権限があります。 | 権限付与 API: wv.getAuthCode | |
USER_CONTACTINFO | -開発者はアプリ ユーザーの連絡先情報を取得する権限があります。 | 権限付与 API: wv.getAuthCode | |
- | 開発者はアプリ ユーザーの ID を取得する権限があります。権限付与プロセス中にポップアップウィンドウは表示されません。 | 権限付与 API: wv.getAuthCode | |
- | 開発者はアプリに関するアカウント情報を取得する権限があります。 | 権限付与 API: wv.getAuthCode | |
location | 位置情報の権限付与 | 権限付与 API: wv.authorize | |
camera | カメラの権限付与 | 権限付与 API: wv.authorize | |
bluetooth | WVBluetooth のすべてのメソッド | Bluetooth の権限付与権限付与 API: wv.authorize | |
album | アルバムの権限付与 | 権限付与 API: wv.authorize | |
contacts | WVContacts のすべてのメソッド | 連絡先の権限付与権限付与 API: wv.authorize | |
microphone | マイクの権限付与 | 権限付与 API: wv.authorize | |
file | WVFile のすべてのメソッド | ファイルの権限付与権限付与 API: wv.authorize | |
call | 通話の権限付与 | 権限付与 API: wv.authorize | |
vibrate | バイブレーションの権限付与 | 権限付与 API: wv.authorize | |
screen | 画面の権限付与 | 権限付与 API: wv.authorize |