Introduction

What is Smart Bulletin?

This document is based on Smart Bulletin version 2.0. Previous versions of Smart Bulletin may differ in function and design.

 

Smart Bulletin is a home bulletin provided only in LG Home version 4.50 or higher. Smart Bulletin brings together all applications and information scattered across a smartphone and shows refined contents in a concise manner for their effective use. Smart Bulletin allows users easier access to necessary information on the home screen while it enables you to communicate easily with users by presenting the unique contents of your application.

 

Smart Bulletin appears on the left-most home screen.

 

Smart Bulletin only appears on an LG smartphone's default home (LG Home). It does not appear when you use other launchers.

 

Key Features

Users can attach various types of content to Smart Bulletin, from basic information such as a weather forecast to applications such as a TV remote control app. Like Android app widgets (from here on referred to as 'app widgets'), the content pieces attached to Smart Bulletin interact with users and offer diverse features. In addition, because the content pieces are attached to a vertically scrolled screen one by one, unlike ordinary app widgets on the home screen, they occupy a limited space on the home screen even if their number increases.

 

The user can select the content to be attached to Smart Bulletin. If the user taps the Settings icon at the top right of the screen, a list of content appears as shown in Figure 2. Only content pieces that are checked in the list appear in Smart Bulletin.

A more detailed description of how to add attachable content is provided in Attaching Providers.

 

 

Benefits

Smart Bulletin provides the following values to users and developers:

  • Users can easily access their desired information without even starting an app.
  • Developers can attract attention from users by presenting key information on the home screen.

 

Smart Bulletin has the following benefits:

  • Accessibility: Because content is displayed directly on the home screen, information can be delivered immediately.
  • Integration: Because various pieces of information scattered all over are integrated into one place, you can grasp things effectively.
  • Scalability: Because content is attached vertically, a significant amount of information can be contained in a limited space. Also, you can use cards to add information freely for each content piece.

 

What is Smart Bulletin Provider?

Smart Bulletin supports third-party providers only in LG Home version 4.50 or higher. To check the version of your LG Home on the default home screen, go to Settings > Apps > All.

 

To attach a content piece to Smart Bulletin, you need to create an application specifically for Smart Bulletin. Applications created for Smart Bulletin provide content through a Smart Bulletin provider. A Smart Bulletin provider is a kind of app widget with Smart Bulletin features added to it.

 

A Smart Bulletin provider offers the following features:

  • Running a full-screen application
  • Setting content colors
  • Issuing notifications (once/ongoing notifications)
  • Monitoring Smart Bulletin status
  • Monitoring providers’ attachment status

 

All the features above are optional, and you can choose whether to use them or not when implementing a provider.

Running a Full-Screen Application

Providers enable you to run a full-screen application by tapping the title of the content.

For information on how to run a full-screen application in a provider, see Setting Full-Screen Activities.

Setting Colors

Providers enable you to set the background and title colors of a content piece displayed in Smart Bulletin.

If you do not specify any colors for a content piece, one theme is randomly picked from the two themes that Smart Bulletin provides.

 

The following figure shows a piece of content for which colors are specified and a piece of content for which colors are not specified. In ①, one of them uses white background and dark text; the other uses orange background and white text. In ②, colors were not specified, and therefore one of two themes was randomly picked.

 

 

For information on how to specify colors for a piece of content, see Setting Default Colors and Changing Colors Dynamically.

Issuing Notifications

Providers can issue notifications to draw attention from users when information is updated or a job is processing. When a notification is issued, a notification icon appears to the right of the title of the provider that issued the notification.

 

There are two types of notification, one-shot (once) notifications and ongoing notifications. A one-shot (once) notification notifies the user of new information or a new event and disappears when the user taps the provider. An ongoing notification notifies the user of an ongoing process, and the notification icon remains displayed until the provider removes the notification.

 

For information on how to implement notifications, see Issuing Notifications.

 

A provider can only display one notification at a time regardless of the notification type. Only newly issued notifications are displayed, even if previously issued notifications have not been removed explicitly.

 

The following figure is an example of a one-off notification and an ongoing notification.

 

(a)One-shot (once) notifications (b) Ongoing notifications

 

In the case of one-shot (once) notifications, default icons specified in Smart Bulletin are used. In the case of ongoing notifications, however, you need to specify icon images for them in a provider. For guidance on how to create images for ongoing notifications, see Iconography.

 

The total number of notifications issued by the currently displayed providers appears to the right of the Smart Bulletin title.

Monitoring Smart Bulletin Status

Smart Bulletin broadcasts its status. Providers can check the status of Smart Bulletin — say, whether Smart Bulletin is active and whether Smart Bulletin screen is being displayed — and then perform the appropriate action. For example, a provider that periodically updates the contents of the screen can skip an update if Smart Bulletin screen is not displayed.

 

For information on how to check the status of Smart Bulletin, see Monitoring Smart Bulletin Status.

Monitoring Provider Status

Smart Bulletin notifies providers’ attachment status.

 

For information on how to check the attachment status of each provider, see Monitoring Provider Status.

How does Provider Work?

A provider is an app widget combined with Smart Bulletin features. Like app widgets, providers do not display and control content pieces on the screen by themselves. Providers create content and delegate its management and control to Smart Bulletin. Smart Bulletin controls the content when providers give a request.

 

To help you understand how a provider operates, we briefly describe how components of Smart Bulletin interact with each other and what data are exchanged in the following figure.

 

 

Providers define the layout of a content piece in the same way as app widgets. Content pieces are attached to Smart Bulletin and then displayed. When a pre-defined event occurs in an attached content piece, Smart Bulletin receives the event and sends an intent specified by a provider. The provider receives the intent and performs the appropriate action, and when the screen layout needs to be changed, it asks Smart Bulletin to change the screen layout. This structure is the same as the interaction mechanism between an app widget provider and an app widget host.

 

Unlike app widgets, Smart Bulletin providers can configure additional information such as the background color. Default settings are sent to Smart Bulletin as resources defined in an XML file.

 

Additionally, requests for changing colors, issuing notifications and status checks are sent using a pre-defined intent. Providers transmit an Intent to Smart Bulletin when they issue or remove a notification and when they change colors. Smart Bulletin in turn receives the intent and then displays (or removes) a notification and modifies the screen of the specified content. Smart Bulletin broadcasts its status in the intent. Providers receive the intent and perform necessary action.

Navigation