Processing:Библиотеки/Processing for Android/Месторасположение и разрешения - История изменений

EducationBot в 07:56, 20 мая 2023

2023-05-20T07:56:23Z

EducationBot в 07:52, 20 мая 2023

2023-05-20T07:52:30Z

← Предыдущая версия		Версия от 11:52, 20 мая 2023
Строка 4:		Строка 4:
	{{Myagkij-редактор}}		{{Myagkij-редактор}}

	~~{{Черновик}}~~

	=Месторасположение и разрешения<ref>[https://android.processing.org/tutorials/location/index.html android.processing.org - Location and permissions]</ref>=		=Месторасположение и разрешения<ref>[https://android.processing.org/tutorials/location/index.html android.processing.org - Location and permissions]</ref>=
Строка 150:		Строка 150:
	\|Высота логотипа издателя для schemaNewsArticle=45		\|Высота логотипа издателя для schemaNewsArticle=45
	}}		}}
	{{Навигационная таблица/~~Справочник языка~~ Processing}}		{{Навигационная таблица/Портал/Processing}}

Myagkij в 06:35, 15 сентября 2018

2018-09-15T06:35:23Z

Новая страница

{{Processing панель перехода}}

{{Перевод от Сubewriter}}
{{Myagkij-редактор}}

{{Черновик}}

=Месторасположение и разрешения<ref>[https://android.processing.org/tutorials/location/index.html android.processing.org - Location and permissions]</ref>=

Это руководство объясняет, как получить доступ к GPS-данным о месторасположении и правильно настроить разрешения скетча на устройствах с операционной системой Android версии 6+.

== API Android для определения месторасположения ==

Устройство Android может определить [https://developer.android.com/guide/topics/location/strategies свое месторасположение] с точностью до нескольких градусов при помощи информации от сетей, к которым оно подключено (WiFi, сотовой связи), или при помощи сигналов от GPS-спутников (от англ. «global positioning system», т.е. «глобальная система позиционирования»). Данные о месторасположении, полученные с помощью GPS, получаются более точными, но этот метод требует, чтобы устройство находилось вне помещения, расходует больше заряда батареи и обновляется реже, чем при определении месторасположения с помощью сетей.

== Создание менеджера месторасположения ==

Базовая структура скетча, получающего доступ к данным о месторасположении, очень похожа на ту, которую мы уже видели в скетчах-примерах для работы с [wikihandbk.com/wiki/Processing:Библиотеки/Processing_for_Android/Руководства/Использование_датчиков другими датчиками]. Вначале мы берем менеджера месторасположения из контекста приложения, «живых» обоев или циферблата при помощи функции surface.getContext() (если версия режима программирования Android – 4.0 и выше) или просто считываем указатель на активность при помощи функции getActivity() (если у вас версия 3). После этого мы подключаем «слушателя» к менеджеру:

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
import android.content.Context;
import android.location.Location;
import android.location.LocationListener;
import android.location.LocationManager;
import android.os.Bundle;
import android.Manifest;

LocationManager locationManager;
MyLocationListener locationListener;

boolean hasLocation = false;

void setup () {
fullScreen();
orientation(PORTRAIT);
textFont(createFont("SansSerif", 26 * displayDensity));
textAlign(CENTER, CENTER);
requestPermission("android.permission.ACCESS_FINE_LOCATION", "initLocation");
}

void draw() {
}

void initLocation(boolean granted) {
if (granted) {
Context context = getContext();
locationListener = new MyLocationListener();
locationManager = (LocationManager) context.getSystemService(Context.LOCATION_SERVICE);
locationManager.requestLocationUpdates(LocationManager.NETWORK_PROVIDER, 0, 0, locationListener);
hasLocation = true;
} else {
hasLocation = false;
}
}

class MyLocationListener implements LocationListener {
public void onLocationChanged(Location location) {
println(location.getLatitude(), location.getLongitude());
}

public void onProviderDisabled (String provider) { }

public void onProviderEnabled (String provider) { }

public void onStatusChanged (String provider, int status, Bundle extras) {
}
}
</syntaxhighlight>

Мы здесь явно запрашиваем разрешение при помощи функции requestPermission(), а также помещаем код с инициализацией менеджера и слушателя внутрь функции initLocation(), а не внутрь setup(), как в предыдущих примерах. Причина в том, что в последних версиях Android (6.0 и новее) разрешения поделены на две группы: [https://developer.android.com/guide/topics/security/permissions.html#normal-dangerous обычные и опасные]. Разрешения, классифицированные как [https://developer.android.com/guide/topics/permissions/overview#permission-groups «опасные»], касаются доступа к личным данным пользователя – вроде данных о месторасположении или списка контактов – и требуют, чтобы пользователь принимал решения по каждому из этих разрешений отдельно во время запуска приложения, а не его установки.

Приложение покажет диалоговое окно, спрашивающее о том, что сделать – дать или отклонить разрешение. Лишь после этого будет вызвана функция initLocation(), которая – в зависимости от булева значения в аргументе granted – либо запустит, либо не запустит процесс определения местонахождения. Этой функцией, которая должна содержать инициализирующий код, соответствующий запрашиваемому разрешению, не обязательно должна быть initLocation(). Она может называться по-другому, но должна отвечать двум важным критериям – во-первых, она должна принимать булев аргумент, а во-вторых, ее название должно быть указано аргументом в функции requestPermission().

Кроме того, вам надо будет задать разрешения, необходимые для работы этого скетча. Для этого кликните в PDE на Android > Sketch Permissions, а затем поставьте галочки у пунктов ACCESS_COARSE_LOCATION (для обнаружения местонахождения с помощью сетей) и ACCESS_FINE_LOCATION (для обнаружения местонахождения с помощью GPS):

[[File:Processing for Android_permission_selector_1.png|center]]

Переменная location, которую мы получаем в «слушателе» данных о локации, содержит всю информацию, необходимую для указания месторасположения при помощи широты и долготы:

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
class MyLocationListener implements LocationListener {
public void onLocationChanged(Location location) {
currentLatitude = (float)location.getLatitude();
currentLongitude = (float)location.getLongitude();
currentAccuracy = (float)location.getAccuracy();
currentProvider = location.getProvider();
}

public void onProviderDisabled (String provider) {
currentProvider = "";
}

public void onProviderEnabled (String provider) {
currentProvider = provider;
}

public void onStatusChanged (String provider, int status, Bundle extras) {
}
}
</syntaxhighlight>

== Проверка наличия данных о месторасположении ==

Даже если задать в PDE необходимые разрешения для скетча, пользователь по-прежнему может отклонить запрос на использование этих функций при запуске приложения на устройстве. То есть нам в скетче необходим код, который бы обрабатывал ситуацию, при которой данные о месторасположении не доступны. Поэтому мы также пишем в коде функцию checkPermission(), чтобы удостовериться, что необходимое разрешение действительно получено и мы можем получить доступ к соответствующему функционалу:

<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
void draw() {
background(0);
if (hasPermission("android.permission.ACCESS_FINE_LOCATION")) {
text("Latitude: " + currentLatitude + "\n" +
"Longitude: " + currentLongitude + "\n" +
"Accuracy: " + currentAccuracy + "\n" +
"Provider: " + currentProvider, 0, 0, width, height);
// "Широта: "
// "Долгота: "
// "Точность: "
// "Провайдер: "
} else {
text("No permissions to access location", 0, 0, width, height);
// "Нет разрешения на доступ к данным о месторасположении"
}
}
</syntaxhighlight>

Полный код этого скетча-примера можно найти [https://github.com/codeanticode/processing-android-tutorials/tree/master/location_permissions/ex1_gps тут]. Запустив этот скетч на устройстве с Android версии 6 и новее, вы должны увидеть на экране следующее диалоговое окно, запрашивающее разрешение на получение данных о местонахождении:

[[File:Processing for Android_permission_dialog_2.png|center]]

Разрешив приложению доступ к данным о месторасположении своего устройства, вы получите значения широты и долготы, считанные при помощи «класса-слушателя».

=См.также=

=Внешние ссылки=

<references />
{{SEO
|Заголовок статьи=Processing: / Онлайн справочник - wikihandbk.com
|Ключевые слова=processing,
|Описание статьи=
|Изображение статьи для Open Graph=
|Адрес страницы для schemaNewsArticle=<nowiki>http://wikihandbk.com/wiki/</nowiki>
|Изображение статьи для schemaNewsArticle=<nowiki></nowiki>
|Высота изображения статьи для schemaNewsArticle=
|Ширина изображения статьи для schemaNewsArticle=
|Дата публикации для schemaNewsArticle=2018-09-15
|Автор=Мякишев Е.А.
|Издатель=myagkij
|Логотип издателя для schemaNewsArticle=<nowiki>http://wikihandbk.com/ruwiki/images/6/61/Tech_geek_logo_1x.jpg</nowiki>
|Ширина логотипа издателя для schemaNewsArticle=60
|Высота логотипа издателя для schemaNewsArticle=45
}}
{{Навигационная таблица/Справочник языка Processing}}

← Предыдущая версия		Версия от 11:56, 20 мая 2023
Строка 18:		Строка 18:
	Базовая структура скетча, получающего доступ к данным о месторасположении, очень похожа на ту, которую мы уже видели в скетчах-примерах для работы с [wikihandbk.com/wiki/Processing:Библиотеки/Processing_for_Android/Руководства/Использование_датчиков другими датчиками]. Вначале мы берем менеджера месторасположения из контекста приложения, «живых» обоев или циферблата при помощи функции surface.getContext() (если версия режима программирования Android – 4.0 и выше) или просто считываем указатель на активность при помощи функции getActivity() (если у вас версия 3). После этого мы подключаем «слушателя» к менеджеру:		Базовая структура скетча, получающего доступ к данным о месторасположении, очень похожа на ту, которую мы уже видели в скетчах-примерах для работы с [wikihandbk.com/wiki/Processing:Библиотеки/Processing_for_Android/Руководства/Использование_датчиков другими датчиками]. Вначале мы берем менеджера месторасположения из контекста приложения, «живых» обоев или циферблата при помощи функции surface.getContext() (если версия режима программирования Android – 4.0 и выше) или просто считываем указатель на активность при помощи функции getActivity() (если у вас версия 3). После этого мы подключаем «слушателя» к менеджеру:

	<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS\|GESHI_FANCY_LINE_NUMBERS~~" enclose="div~~">		<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS\|GESHI_FANCY_LINE_NUMBERS">
	import android.content.Context;		import android.content.Context;
	import android.location.Location;		import android.location.Location;
Строка 78:		Строка 78:
	Переменная location, которую мы получаем в «слушателе» данных о локации, содержит всю информацию, необходимую для указания месторасположения при помощи широты и долготы:		Переменная location, которую мы получаем в «слушателе» данных о локации, содержит всю информацию, необходимую для указания месторасположения при помощи широты и долготы:

	<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS\|GESHI_FANCY_LINE_NUMBERS~~" enclose="div~~">		<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS\|GESHI_FANCY_LINE_NUMBERS">
	class MyLocationListener implements LocationListener {		class MyLocationListener implements LocationListener {
	public void onLocationChanged(Location location) {		public void onLocationChanged(Location location) {
Строка 104:		Строка 104:
	Даже если задать в PDE необходимые разрешения для скетча, пользователь по-прежнему может отклонить запрос на использование этих функций при запуске приложения на устройстве. То есть нам в скетче необходим код, который бы обрабатывал ситуацию, при которой данные о месторасположении не доступны. Поэтому мы также пишем в коде функцию checkPermission(), чтобы удостовериться, что необходимое разрешение действительно получено и мы можем получить доступ к соответствующему функционалу:		Даже если задать в PDE необходимые разрешения для скетча, пользователь по-прежнему может отклонить запрос на использование этих функций при запуске приложения на устройстве. То есть нам в скетче необходим код, который бы обрабатывал ситуацию, при которой данные о месторасположении не доступны. Поэтому мы также пишем в коде функцию checkPermission(), чтобы удостовериться, что необходимое разрешение действительно получено и мы можем получить доступ к соответствующему функционалу:

	<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS\|GESHI_FANCY_LINE_NUMBERS~~" enclose="div~~">		<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS\|GESHI_FANCY_LINE_NUMBERS">
	void draw() {		void draw() {
	background(0);		background(0);