Что означает ContactsContract.Contacts.IN_VISIBLE_GROUP в Android?

Из документации разработчика Android это все, что я получил:

Индикатор того, должен ли этот контакт отображаться в пользовательском интерфейсе. «1», если контакт имеет хотя бы один необработанный контакт, который принадлежит видимой группе; «0» в противном случае.

По сути, что это значит? Какова цель использования этого флага?

Я пробовал экспериментировать с контактами довольно много времени, и результаты выглядят запутанными. Когда я подключаю контакты с этим флагом, он выбирает контакты, которые, как я считаю, являются последними синхронизированными контактами с моей учетной записью Google, плюс тот, который я добавил локально в своей телефонной книге по умолчанию. Например, это выборка из 912 контактов.

Однако, когда этот флаг выключен, я получаю огромное количество контактов, некоторые из которых я почти не узнаю и не понимаю, почему они здесь, в первую очередь. Это позволяет получить около 3050 контактов!

Цените любую помощь!

Контакты Android хранятся в Accounts (таких как Google, Yahoo, Linkedin, Microsoft Exchange), в каждой учетной записи, контакты хранятся в Groups (например, друзья, семья, деловые контакты), есть также специальная группа для контактов, которые не принадлежат Для любой группы эта группа обычно называется « All others in <group-name> »).

В большинстве приложений для контактов, которые поставляются с Android, пользователь может выбрать Custom вид, в котором он может делать группы в аккаунтах видимыми или скрытыми на главном экране контактов, например, пользователь может отображать группу Friends , но не группу « Family » В его учетной записи Google Контактов.

Этот выбор будет ссылаться на приложение, запрашивающее контакты, используя поле IN_VISIBLE_GROUP , это будет верно, если контакт является частью хотя бы одной видимой группы. Специальные All others in группе почти всегда не являются видимой группой, и поэтому она обычно скрыта из приложения «Контакты».

В частности, в Google, когда вы отправляете электронное письмо кому-либо или получаете электронное письмо от кого-то, адрес электронной почты автоматически добавляется к вашим контактам, All others in группе, поэтому вы, вероятно, получаете огромное количество контактов при запросе без этого флага.