Intent filter android studio это

Intent Android

Материал из AOW

Содержание

Intent (Намерение)

Намерение (Intent) — это механизм для описания одной операции — выбрать фотографию, отправить письмо, сделать звонок, запустить браузер и перейти по указанному адресу. В Android-приложениях почти все работает благодаря намерениям.

Наиболее распространенный сценарий использования намерения — запуск другой активности в своём приложении.

Но это не единственный вариант использования намерения. Также можно использовать для объявления о запуске активности или сервиса, направленных на выполнение каких-либо действий (как правило, речь о работе с определенной частью данных) или для передачи уведомлений о том, что произошло некое событие (или действие).

Намерения могут применяться для трансляции сообщений по системе. Любое приложение способно зарегистрировать широковещательный приёмник и отслеживать эти намерения с возможностью на них реагировать. Это позволяет создавать приложения, использующие событийную модель, в основе которой лежат внутренние, системные или сторонние события, передаваемые внешними программами.

Android транслирует намерения для объявления о системных событиях, например об изменениях в состоянии сетевого подключения или в уровне заряда батареи. Системные приложения в Android, такие как программы дозвона или управления SMS, регистрируют компоненты, отслеживающие заданные намерения, например входящий звонок или получено новое SMS-сообщение, и соответствующим образом реагируют на них.

Неявные намерения и связывание во время выполнения программы

Неявные намерения — это механизм, позволяющий запрашивать анонимные компоненты приложений с помощью действий. Вы можете попросить систему запустить активность, выполняющую заданное действие, не зная ничего ни о самой активности, ни о её приложении.

Создавая новое неявное намерение для передачи в метод startActivity, необходимо назначить действие, которое должно выполниться, а также при желании указать вспомогательный путь URI к тем данным, что нужно обработать. Вы также можете передать дополнительные данные в целевую Активность, используя параметр намерения extras.

При применении этого намерения для запуска активности система во время работы приложения сама найдёт класс компонента, который лучше всего подходит для заданного действия, учитывая указанный тип данных. Это значит, что вы можете создавать проекты, используя возможности других приложений и не зная при этом, как они называются и какую функциональность предоставляют.

Простой пример создания намерения с предопределенным действием ACTION_VIEW для запуска браузера и перехода на нужный адрес:

Uri address = Uri.parse(«http://developer.alexanderklimov.ru»); Intent openlink = new Intent(Intent.ACTION_VIEW, address); startActivity(openlink);

В данном случае действие ACTION_VIEW означает просмотр чего-либо. Мы указали нужные данные (адрес), и происходит запуск новой активности (браузера). При этом исходная активность приостанавливается и переходит в фоновый режим. Когда пользователь нажимает на кнопку Back, то он возвращается к исходной активности.

В каждом случае Android находит соответствующую активность, чтобы ответить на намерение, инициализируя ее в случае необходимости.

Приложения могут также создавать свои собственные типы намерений и позволять другим приложениям вызывать.

Объект Intent содержит информацию, представляющую интерес для компонента, который получает намерение, и данные, которые передаются этому компоненту. Кроме того, объект Intent содержит информацию, представляющую интерес для системы Android, — имя компонента, который должен обработать намерение и набор параметров запуска этого компонента.

Как правило, объект Intent может содержать следующие поля:

• Имя компонента — имя, который должен обработать намерение. Используется объект ComponentName, который является комбинацией полного имени класса целевого компонента (например, «MainActivity») и набора имени пакета в файле манифеста приложения, где компонент постоянно находится (например, «com.samples.yourproject»). Составляющее имя является дополнительным. Если оно установлено, объект Intent поставляет образцу определяемого класса. Если имя не установлено, Android использует другую информацию в объекте Intent, чтобы определить местонахождение подходящего адресата. Составляющее имя устанавливается методами setComponent(), setClass() или setClassName() и читается методом getComponent();
• Действие — определяет действие, которое будет выполнено. Класс Intent содержит множество констант действия. Название метода определяет ряд параметров и возвращаемое значение. Вы можете также определить собственные действия для активизации активности. В этом случае вы должны включать имя пакета приложения в качестве префикса, например com.samples.yourproject.CUSTOM_ACTiON. Действие в объекте Intent устанавливается в методе setAction() и читается методом getAction();
• Данные — это URI данных и тип MIME для этих данных. Разные активности соединены с разными видами спецификаций данных.
• Категория — строка, содержащая дополнительную информацию о виде компонента, который должен обработать намерение. В объект Intent можно поместить любое количество описаний категорий. Класс Intent определяет несколько констант CATEGORY, например, CATEGORY_BROWSABLE
• Дополнения — пары ключ-значения для дополнительной информации, которую нужно поставить компоненту, обращающемуся с намерением. Например, действие ACTION_TIMEZONE_CHANGED имеет дополнение time-zone, которое идентифицирует новый часовой пояс, ACTION_HEADSET_PLUG имеет дополнение state, указывающее, включены ли наушники или отключены, а также дополнение name для типа наушников. Объект Intent имеет ряд методов put. () для вставки различных типов дополнительных данных и подобного набора методов get. () для чтения данных. Дополнения устанавливаются и читаются как объекты Bundle с использованием методов putExtras() и getExtras();
• Флаги — указывают системе, как запускать активность (например, какому заданию должна принадлежать активность) и как обработать это после того, как активность запустили (например, принадлежит ли она списку недавних активностей). Все флаги определены в классе Intent.

Система и приложения, которые идут в комплекте с платформой, также используют объекты Intent для активизации определенных системой компонентов (например, различных приложений и служб при загрузке системы).

Константы действия

• ACTION_ANSWER — Открывает активность, которая связана с входящими звонками. Это действие обрабатывается стандартным экраном для приема звонков;
• ACTION_CALL — инициализирует обращение по телефону;
• ACTION_DELETE — Запускает активность, с помощью которой можно удалить данные, указанные в пути URI внутри намерения;
• ACTION_EDIT — Отображает данные для редактирования пользователем;
• ACTION_INSERT — Открывает активность для вставки в Курсор (Cursor) нового элемента, указанного с помощью пути URI. Дочерняя активность, вызванная с этим действием, должна вернуть *URI, ссылающийся на вставленный элемент;
• ACTION_HEADSET_PLUG — Подключение наушников;
• ACTION_MAIN — Запускается как начальная активность задания;
• ACTION_PICK — Загружает дочернюю Активность, позволяющую выбрать элемент из источника данных, указанный с помощью пути URI. При закрытии должен возвращаться URI, ссылающийся на выбранный элемент. Активность, которая будет запущена, зависит от типа выбранных данных, например при передаче пути content://contacts/people вызовется системный список контактов;
• ACTION_SEARCH — Запускает активность для выполнения поиска. Поисковый запрос хранится в виде строки в дополнительном параметре намерения по ключу SearchManager.QUERY;
• ACTION_SEND — Загружает экран для отправки данных, указанных в намерении. Контакт-получатель должен быть выбран с помощью полученной активности. Используйте метод setType, чтобы указать тип MIME для передаваемых данных. Эти данные должны храниться в параметре намерения extras с ключами EXTRA_TEXT или EXTRA_STREAM, в зависимости от типа. В случае с электронной почтой стандартное приложение в Android также принимает дополнительные параметры по ключам EXTRA_EMAIL, EXTRA_CC, EXTRA_BCC и EXTRA_SUBJECT. Используйте действие *ACTION_SEND только в тех случаях, когда данные нужно передать удаленному адресату (а не другой программе на том же устройстве);
• ACTION_SENDTO — Открывает активность для отправки сообщений контакту, указанному в пути URI, который передаётся через намерение;
• ACTION_SYNC — Синхронизирует данные сервера с данными мобильного устройства;
• ACTION_TIMEZONE_CHANGED — Смена часового пояса;
• ACTION_VIEW — Наиболее распространенное общее действие. Для данных, передаваемых с помощью пути URI в намерении, ищется наиболее подходящий способ вывода. Выбор приложения зависит от схемы (протокола) данных. Стандартные адреса http: будут открываться в браузере, адреса tel: — в приложении для дозвона, geo: — в программе Google Maps, а данные о контакте — отображатся в приложении для управления контактной информацией;
• ACTION_WEB_SEARCH — Открывает активность, которая ведет поиск в интернете, основываясь на тексте, переданном с помощью пути URI (как правило, при этом запускается браузер);

• CATEGORY_BROWSABLE — активность может быть безопасно вызвана браузером, чтобы отобразить ссылочные данные, например, изображение или почтовое сообщение;
• CATEGORY_HOME — активность отображает Home Screen, первый экран, который пользователь видит после включения устройства и загрузки системы, или когда нажимает клавишу HOME;
• CATEGORY_LAUNCHER — активность может быть начальной деятельностью задания из списка приложений в группе Application Launcher устройства

Методы

Для работы с категориями в классе Intent определена группа методов:

• addCategory() — помещает категорию в объект Intent;
• removeCategory() — удаляет категорию, которая была добавлена ранее;
• getCategories() — получает набор всех категорий, находящихся в настоящее время в объекте Intent;

Группы намерений

Намерения могут быть разделены на две группы:

• явные намерения — определяют целевой компонент по имени (составляющее поле имени, имеет набор значения). Явные намерения обычно используются для сообщений внутри приложения, например, когда одна активность запускает другую активность из этого приложения.
• неявные намерения — не называют адресата (поле для составляющего имени — пробел). Неявные намерения часто используются, чтобы активизировать компоненты в других приложениях. Неявные намерения используют для запуска компонентов других приложений. В файле манифеста приложений декларируется фильтр намерений. В отсутствие определяемого адресата система просматривает фильтры намерений всех приложений и находит компонент (активность, службу или приемник широковещательных сообщений), фильтр намерений которого является наиболее подходящим для выполнения данного неявного намерения.

Фильтры намерений и запуск заданий

Если намерение запрашивает выполнение какого-либо действия с определенным набором данных, то системе нужно уметь выбрать приложение (или компонент) для обслуживания этого запроса. На помощь приходят фильтры намерений, которые используются для регистрации активностей, сервисов и широковещательных приёмников в качестве компонентов, способных выполнять заданные действия с конкретным видом данных. С помощью этих фильтров также регистрируются широковещательные приёмники, настроенные на трансляцию намерением заданного действия или события.

Задействуя Фильтры намерений, приложения объявляют, что они могут отвечать на действия, запрашиваемые любой другой программой, установленной на устройстве. Чтобы зарегистрировать компонент приложения в качестве потенциального обработчика намерений, нужно добавить тег в узел компонента в манифесте.

В фильтре намерений декларируется только три составляющих объекта Intent: действие, данные, категория. Дополнения и флаги не играют никакой роли в принятии решения, какой компонент получает намерение.

Например, в любом приложении есть главная активность, которая устанавливается как точка входа для задания:

Фильтр такого вида в элементе помечает активность, как запускаемую по умолчанию. Элемент заставляет значок и метку для деятельности отображаться на панели Application Launcher, давая пользователям возможность запускать задание и возвращаться к этому заданию в любое время после того, как оно было запущено.

Внутри узла Фильтра намерений можно использовать такие теги (и соответствующие атрибуты).

• action — Использует атрибут android:name, чтобы задать название действия, которое будет обслуживаться. Каждый фильтр намерений должен иметь один (и только один) тег action. Действия должны быть представлены в виде уникальных строк, которые сами себя описывают. Рекомендуется выбирать названия, основываясь на соглашении об именовании пакетов в Java.
• сategory — Использует атрибут android:name, чтобы указать, при каких обстоятельствах должно обслуживаться действие. Каждый тег intent-filter способен содержать несколько тегов category. Вы можете задать собственные категории или же брать стандартные значения, предоставляемые системой
• ALTERNATIVE — Наличие данной категории говорит о том, что действие должно быть доступно в качестве альтернативного тому, которое выполняется по умолчанию для элемента этого типа данных. Например, если действие по умолчанию для контакта — просмотр, то в качестве альтернативы его также можно редактировать
• SELECTED_ALTERNATIVE — То же самое, что и ALTERNATIVE, но вместо одиночного действия с использованием утверждения намерения, которое описано выше, применяется в тех случаях, когда нужен список различных возможностей. Одной из функций фильтра намерений может стать динамическое заполнение контекстного меню с помощью действий.
• BROWSABLE — Говорит о том, что действие доступно из браузера. Когда намерение срабатывает в браузере, оно всегда содержит данную категорию. Если вы хотите, чтобы приложение реагировало на действия, инициированные браузером (такие как перехват ссылок на конкретный сайт), то должны добавить в его манифест категорию BROWSABLE.
• DEFAULT — Установите эту категорию, чтобы сделать компонент обработчиком по умолчанию для действия, выполняемого с указанным типом данных внутри Фильтра намерений. Это необходимо и для Активностей, которые запускаются с помощью явных Намерений
• GADGET — Наличие этой категории указывает на то, что данная активность может запускаться внутри другой активности.
• HOME — Устанавливая эту категорию и не указывая при этом действия, вы создаете альтернативу для стандартного домашнего экрана.
• LAUNCHER — Используя эту категорию, вы помещаете Активность в окно для запуска приложений.
• data — Этот тег дает возможность указать тип данных, с которым может взаимодействовать ваш компонент. При необходимости можно задать несколько тегов data. Чтобы указать, какие именно данные поддерживает ваш компонент, используйте сочетание следующих атрибутов:
  • android:host — задает доступное имя удаленного сервера (например, google.com);
  • android:mimetype — позволяет указать тип данных, которые ваш компонент способен обрабатывать. Для примера и будет соответствовать любому Курсору в Android:

• • android:path — задает доступные значения для пути URI (например, /transport/boats/);
  • android:port — указывает доступные порты для заданного сервера;
  • android:scheme — требует указать конкретную схему (например, content или http).

Принцип работы фильтров намерений

При использовании метода startActivity() передаваемое неявное намерение, как правило, доходит лишь до одной активности. Если для выполнения заданного действия с указанными данными годятся сразу несколько активностей, пользователю предоставляется список выбора. Процесс, когда решается, какую активность лучше запустить, называется Утверждением намерений. Его цель — найти наиболее подходящий фильтр намерений. В целом весь алгоритм работает следующим образом. Android собирает список всех доступных Фильтров намерений из установленных пакетов.

Фильтры, которые не соответствуют действию или категории Намерения, удаляются из списка. Совпадение происходит только в том случае, если Фильтр намерений содержит указанное действие (или если действие для него вовсе не задано). Совпадения не произойдет, только если ни одно из действий Фильтра намерений не будет эквивалентно тому, которое задано в Намерении. Для категорий процесс соответствия более строгий. Фильтр намерений должен включать в себя все категории, заданные в полученном Намерении. Фильтр, для которого категории не указаны, может соответствовать только таким же Намерениям (нет категорий).

Наконец, каждая часть пути URI из Намерения сравнивается с тегом data Фильтра намерений. Если в Фильтре указаны схема (протокол), сервер/принадлежность, путь или тип MIME, все эти значения проверяются на соответствие пути URI из Намерения. При любом несовпадении Фильтр будет удален из списка. Если в Фильтре намерений не указано ни одного параметра data, его действие будет распространяться на любые данные.

• MIME — тип данных, который должен совпасть. При сравнении типов данных вы можете использовать маски, чтобы охватывать все подтипы (например, cats/*). Если в Фильтре намерения указан тип данных, он должен совпасть с тем, который значится в намерении, при отсутствии тега data подойдет любой тип.
• Схема — это протокольная часть пути URI, например http:, mailto: или tel:.
• Имя сервера (или принадлежность данных) — часть URI между схемой и самим путем (например, www.google.com). Чтобы совпало имя сервера, схема Фильтра намерений также должна подойти.

Читайте также:  Андроиды топ за свои деньги

После имени сервера идет путь к данным (например, /ig). Путь пройдет проверку только после схемы и имени сервера, содержащихся в теге.

Когда вы неявным образом запускаете Активность и вышеописанный процесс возвращает более одного совпадения, пользователю выводится список со всеми вариантами

Поиск и использование намерения, с помощью которого была запущена активность

Когда программный компонент запускается с помощью неявного намерения, он должен найти действие, которое необходимо осуществить, и данные для него.

Используйте метод getIntent() (как правило, внутри метода onCreate), чтобы извлечь намерение, с помощью которого компонент запущен.

Применяйте методы getAction() и getData(), чтобы найти действие и данные, связанные с намерением. Для извлечения дополнительной информации, хранящейся в параметре extras, используйте типизированные методы get Extra.

Делегирование ответственности

Задействуйте метод startNextMatchingActivity() для делегирования ответственности за обработку действия следующему компоненту, который лучше всего для этого подходит.

Это позволяет добавлять дополнительные условия для компонентов, которые ограничат сферу их применения рамками утверждения Намерений. В некоторых случаях ваш компонент может выполнить некоторые операции или предложить пользователю выбор, прежде чем передать Намерение другому компоненту.

ACTION_PICK

До сих пор мы в основном рассматривали намерения или действия, которые обычно активируют другую активность, не ожидая получить в ответ на это результат. Теперь рассмотрим более сложное действие, которое возвращает значение после того, как будет активировано. ACTION_PICK — это обобщенное название для таких действий.

Принцип ACTION_PICK заключается в том, чтобы запустить активность, отображающую список элементов. После этого активность должна предоставлять пользователю возможность выбора элемента из этого списка. Когда пользователь выберет элемент, активность возвратит URI выбранного элемента вызывающей стороне. Таким образом, можно многократно использовать функцию UI для выбора нескольких элементов определенного типа.

Следующий код выведет диалоговое окно со списком всех возможных программ, которые могут запустить активность с данными, так как мы не указываем конкретный тип (setType(«*/*»)):

// Показываем все программы для запуска Intent intent = new Intent(Intent.ACTION_PICK); intent.setType(«*/*»); startActivityForResult(intent, 1);

Если мы укажем конкретный тип данных, которые нас интересует, то список программ существенно сузится. Например, если указать intent.setType(«image/*»);, то можем увидеть только системную программу Галерея для просмотра картинок (у пользователя могут быть установлены программы, которые также предназначены для просмотра картинок, поэтому список может отличаться).

При работе с действиями, возвращающими данные, нельзя использовать метод startActivity(), поскольку startActivity() не возвращает результат, так как этот метод открывает новую активность в виде модального диалогового окна в отдельном потоке, а основнои поток оставляет свободным для служебных событий. Другими словами, startActivity() — это асинхронный вызов, с которым не применяются обратные вызовы и, следовательно, невозможно узнать, что произошло с активированным действием. Но если вы хотите вернуть данные, то можете использовать метод startActivityForResult(), приспособленный для работы с обратными вызовами.

Очень подробно про намерения написано в книге Разработка приложений для Android

На странице http://www.openintents.org/ собрана информация о доступных намерениях в разных программах.

Примеры использования намерений

• Запуск карт Google

• Загрузить изображения в ImageView из галереи

• Запускаем приложение Галерея и выбираем картинку

• Включить Bluetooth

• Управление настройками Wi-Fi-соединениями

• Сообщить системе о включение/выключении автономного режима (Airplane Mode)

• Запуск приложения Батарея

• Открыть окно «Моё местоположение» из системного приложения Настройки

• Открыть окно «Экран» из системного приложения Настройки

• Отправить SMS через намерение ACTION_VIEW

• Отправить SMS через намерение ACTION_SENDTO

• Выбрать мелодию (action.RINGTONE_PICKER)

Позвонить

Запустить стандартную звонилку без набора номера (ACTION_DIAL)

Открыть звонилку и набрать заданный номер. Требуются разрешения android.permission.CALL_PHONE, CALL_PRIVILEGED (для экстренных вызовов)

Получить контакт из телефонной книги

Открывает стандартное приложение контактов. Метод startActivityForResult позволяет получить URI выбранного контакта. Вы увидите сразу все контакты пользователя, включая почтовые. Если необходимо выбрать только контакт из телефонной книги, можно воспользоваться следующим кодом:

Intent pickIntent = new Intent(Intent.ACTION_GET_CONTENT); pickIntent.setType(ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE); startActivityForResult(pickIntent, PICK_RESULT);

Открыть ссылку в браузере

Данный код запустит браузер с указаной ссылкой. Eсли ссылка ведет на YouTube, то откроется стандатное приложение для YouTube. Также можно открыть стандартный клиент Android Market с ссылкой на какое-либо приложение. Для этого необходимо в параметр URI передать ссылку вида market://search?q=search query, где search query необходимо заменить соответствующим поисковым запросом.

Разрешения: не требуется.

YouTube

Можно запустить конкретно приложение YouTube

Поисковый запрос

Можно отправить поисковый запрос в Гугл:

Отправить письмо

Добавьте на форму текстовые поля для ввода адресата, темы письма и сообщения. Далее сам код:

На устройстве должна быть настроена программа, отвечающая за отправку писем. Если таких программ будет несколько, то пользователь сможет выбрать одну из них при помощи диалогового окна.

Камера

Программное включение приложения Камера

Программно включить приложение Камера, сделать снимок и получить результат

Запустить приложение Камера в режиме видеозаписи и получить результат Распознавание речи

Этот код запускает приложение распознавания речи. Если произнести что-либо, система обработает голос и вернет результат в метод onActivityResult:

Голосовая команда

Запустить Twitter

Twitter можно запустить через намерение. Если на устройстве установлено родное приложение, то запустится оно, иначе запустится веб-версия:

Вместо переменной twitter_user_name необходимо подставить нужный аккаунт. Отсюда.

Источник