stingray.AndroidPermission ネームスペース リファレンス

説明

この API は、Android プラットフォーム上のシステム リソースおよびデータにアクセスするための権限を確認して、要求する場合に使用します。

使用可能な権限は、Android ドキュメントのこちらのページの下部にある表に記載されています。

これらの関数を呼び出す場合は、stingray.AndroidPermission.<PERMISSION_NAME> を渡して権限を識別します。ここで、<PERMISSION_NAME> は、上記のリンクにある表の Permissions 列内の値の 1 つと一致します。たとえば、次のようになります。

local can_read = stingray.AndroidPermission.check( stingray.AndroidPermission.READ_EXTERNAL_STORAGE )
local can_write = stingray.AndroidPermission.check( stingray.AndroidPermission.WRITE_EXTERNAL_STORAGE )

関数

check ( permission ) : boolean 指定された権限をクエリします。

パラメータ

permission :

string

クエリする権限(stingray.AndroidPermission.READ_EXTERNAL_STORAGE、stingray.AndroidPermission.CAMERA など) 詳細については、上記の stingray.AndroidPermission の説明を参照してください。

戻り値

boolean

指定された権限が付与されている場合は、true、それ以外の場合は false を返します。

その他の関連リファレンス項目

stingray.AndroidPermission.request()

in_manifest ( permission ) : boolean 指定された権限の AndroidManifest.xml をクエリします。

パラメータ

permission :

string

クエリする権限(stingray.AndroidPermission.READ_EXTERNAL_STORAGE、stingray.AndroidPermission.CAMERA など) 詳細については、上記の stingray.AndroidPermission の説明を参照してください。

戻り値

boolean

指定された権限が AndroidManifest.xml に含まれている場合は true、それ以外の場合は false を返します。

request ( permission ) 指定された権限を要求します。

パラメータ

permission :

string

要求する権限(stingray.AndroidPermission.READ_EXTERNAL_STORAGE、stingray.AndroidPermission.CAMERA など) 詳細については、上記の stingray.AndroidPermission の説明を参照してください。

戻り値

この関数は値を返しません。

この関数を使用する場合、権限を要求するアクションは次のフレーム(stingray.AndroidPermission.check を含む)まで遅らせる必要があります。メイン スレッドは現在のフレームの末尾に保持され、ユーザの入力を待機するからです。

requests_muted ( permission ) : boolean 指定された権限グループの権限要求システム ダイアログ内でユーザが「Never ask again」を選択したかどうかをクエリします。

パラメータ

permission :

string

クエリする権限(stingray.AndroidPermission.READ_EXTERNAL_STORAGE、stingray.AndroidPermission.CAMERA など) 詳細については、上記の stingray.AndroidPermission の説明を参照してください。

戻り値

boolean

指定された権限に対する要求をユーザがミュートした場合は true、それ以外の場合は false を返します。

Android では、これは Android Java API で !activity.shouldShowRequestPermissionRationale(permission) を呼び出す操作と同様です。

requests_supported ( ) : boolean OS がランタイム権限要求をサポートするかどうかを調べます。

パラメータ

この関数はパラメータを受け入れません。

戻り値

boolean

stingray.AndroidPermission.request 関数がサポートされている場合は true を返します。