Blackberry - Как использовать значок уведомления в строке состояния
-
13-09-2019 - |
Вопрос
В RIM Blackberry OS 4.6+ появилась новая функция - возможность отображать значок уведомления в строке состояния.Интегрированное приложение используйте его для предоставления быстрой и информативной информации пользователю:Удаление - пропущенные вызовы, Сообщения - непрочитанные сообщения и т.д.
удалена мертвая ссылка на ImageShack
Возможное использование значка уведомления:
- пропущенные события
- Обновления RSS
- статус объекта (напр.погода / активность приложения / уровень сигнала gps)
- Другое
Я хотел бы опубликовать практическое руководство по этой функции.
Решение
Класс ApplicationIndicator
Чтобы добавить / изменить / удалить значок уведомления, мы можем использовать Индикатор применения класс:
Представляет индикатор приложения, состоящий из значка и необязательного числового значения.
Значок размещается в области индикаторов наряду с другими, такими как счетчик новой почты, напоминания календаря, счетчик пропущенных вызовов, статус безопасности и другие.
- Приложение может зарегистрировать только один индикатор и должно регистрировать его каждый раз при запуске телефона.
- Все индикаторы очищаются при перезагрузке телефона.
- Индикаторы могут быть не видны, если в строке состояния не будет места
- Размеры индикатора зависят от текущей темы и размера экрана телефона.
- Размер значка варьируется от 10x10 до 24x24.
- Если индикатор инициализирован большим значком, то генерируется исключение.
- Индикатор может иметь необязательное числовое значение, которое обычно служит счетчиком.
- Значение может быть отрицательным, 0 или положительным.
- Если индикатор используется в качестве счетчика, то лучше скрыть его, когда его значение равно 0.
- Если значение индикатора слишком велико, он будет отображать '99+' или '999+'
Добавить значок уведомления
Для этого мы должны создать экземпляр Значок приложения:
Класс значка приложения используется совместно с индикатором приложения и сообщениями приложения.
Он инкапсулирует изображение и его живописные свойства.
EncodedImage mImage = EncodedImage.getEncodedImageResource("indicator_icon.png");
ApplicationIcon mIcon = new ApplicationIcon(mImage);
Затем мы должны зарегистрировать ApplicationIndicator с Регистрационный номер applicationindicator:
ApplicationIndicatorRegistry.зарегистрировать(значок, Только икона, видимый)
значок - значок, который будет отображаться в области индикаторов
Только икона - указывает, должен ли индикатор иметь только изображение значка и никакого значения
видимый - указывает, должен ли индикатор быть видимым изначально
ApplicationIndicatorRegistry reg = ApplicationIndicatorRegistry.getInstance();
ApplicationIndicator indicator = reg.register(mIcon, false, true);
Изменить значок и значение индикатора
Чтобы изменить значок, используйте Индикатор приложения.setIcon способ:
ApplicationIndicatorRegistry reg = ApplicationIndicatorRegistry.getInstance();
ApplicationIndicator appIndicator = reg.getApplicationIndicator();
appIndicator.setIcon(icon);
Чтобы изменить числовое значение, используйте ApplicationIndicator.Установленное значение способ:
ApplicationIndicatorRegistry reg = ApplicationIndicatorRegistry.getInstance();
ApplicationIndicator appIndicator = reg.getApplicationIndicator();
appIndicator.setValue(value);
- Если указано очень большое значение, то индикатор будет отображать '99+' или '999+'.
Чтобы скрыть или показать индикатор, используйте ApplicationIndicator.Установить видимый
Отменить регистрацию ApplicationIndicator
Скорее всего, вы не хотите, чтобы индикатор вашего приложения оставался в строке состояния, лучше ApplicationIndicatorRegistry.отменить регистрацию() это при закрытии приложения.
Пример приложения
Значки:
удалены мертвые ссылки на ImageShack
Скриншоты:
удалены мертвые ссылки на ImageShack
Код:
import net.rim.blackberry.api.messagelist.ApplicationIcon;
import net.rim.blackberry.api.messagelist.ApplicationIndicator;
import net.rim.blackberry.api.messagelist.ApplicationIndicatorRegistry;
import net.rim.device.api.system.EncodedImage;
import net.rim.device.api.ui.MenuItem;
import net.rim.device.api.ui.component.LabelField;
import net.rim.device.api.ui.component.Menu;
import net.rim.device.api.ui.container.MainScreen;
class Scr extends MainScreen {
EncodedImage mImageGreen = EncodedImage
.getEncodedImageResource("bb_icon_green.png");
ApplicationIcon mIconGreen = new ApplicationIcon(mImageGreen);
EncodedImage mImageRed = EncodedImage
.getEncodedImageResource("bb_icon_red.png");
ApplicationIcon mIconRed = new ApplicationIcon(mImageRed);
ApplicationIcon mIcon = mIconGreen;
public Scr() {
add(new LabelField("Use menu to:"));
add(new LabelField("Register indicator"));
add(new LabelField("Increment value"));
add(new LabelField("Decrement value"));
add(new LabelField("Switch icon"));
add(new LabelField("Unregister indicator"));
}
MenuItem menuRegister = new MenuItem("register", 0, 0) {
public void run() {
registerIndicator();
};
};
protected int mValue = 0;
MenuItem menuIncrement = new MenuItem("increment", 0, 0) {
public void run() {
mValue++;
updateValue(mValue);
};
};
MenuItem menuDecrement = new MenuItem("decrement", 0, 0) {
public void run() {
mValue--;
updateValue(mValue);
};
};
MenuItem menuSwitchIcon = new MenuItem("icon", 0, 0) {
public void run() {
mIcon = (mIcon == mIconGreen) ? mIconRed : mIconGreen;
updateIcon(mIcon);
};
};
MenuItem menuUnregister = new MenuItem("unregister", 0, 0) {
public void run() {
unregisterIndicator();
};
};
protected void makeMenu(Menu menu, int instance) {
super.makeMenu(menu, instance);
menu.add(menuRegister);
menu.add(menuIncrement);
menu.add(menuDecrement);
menu.add(menuSwitchIcon);
menu.add(menuUnregister);
}
private void registerIndicator() {
try {
ApplicationIndicatorRegistry reg = ApplicationIndicatorRegistry
.getInstance();
ApplicationIndicator indicator =
reg.register(mIcon, false, true);
} catch (Exception e) {
}
}
private void unregisterIndicator() {
try {
ApplicationIndicatorRegistry reg = ApplicationIndicatorRegistry
.getInstance();
reg.unregister();
} catch (Exception e) {
}
}
void updateValue(int value) {
try {
ApplicationIndicatorRegistry reg = ApplicationIndicatorRegistry
.getInstance();
ApplicationIndicator appIndicator =
reg.getApplicationIndicator();
appIndicator.setValue(value);
} catch (Exception e) {
}
}
void updateIcon(ApplicationIcon icon) {
try {
ApplicationIndicatorRegistry reg = ApplicationIndicatorRegistry
.getInstance();
ApplicationIndicator appIndicator =
reg.getApplicationIndicator();
appIndicator.setIcon(icon);
} catch (Exception e) {
}
}
}