Skip to main content

Ready to market your stellar app?

Samsung Developer Program is your gateway to app monetization success.

Learn More

Samsung Developer Program

Rich Notification Development Environment


To integrate Rich Notification into Android™ and Gear companion apps, you will need an understanding of the Rich Notification Architecture and the Development Environment.


Rich Notification Architecture

The following figure shows the Rich Notification architecture:

Rich Notification Architecture Block Diagram
Figure:     Rich Notification Architecture Block Diagram


The Rich Notification architecture consists of:


One or more Android™ apps that use Rich Notification.

Gear Manager

Interface between the Android host and remote Gear devices.


Gear Manager module that forwards rich notifications from the Android device to the Gear device.

Samsung Notification Service

Service that sends rich notifications from the Android app to the Gear device.

Samsung Accessory Service Framework

Environment for connecting Android and remote devices.


RN Development Environment

Supported Android™ host platform: Android KitKat 4.4.2 (API 19) or above

NOTE: The Android device must be able to connect to the Gear remote wearable device via the Gear Manager App.

  • Components:
    • Rich Notification JAR file (richnotification-v#.#.#.jar)
    • Rich Notification SDK client lib JAR file (sdk-v#.#.#.jar)
      To use any Samsung SDK, this lib file must be included.
    • gson-2.2.4.jar or above
  • Rich Notification package to be imported:
  • The sending of rich notifications to the Gear device must be properly configured on the Android device:
    • Ensure Gear Manager > Notifications > Limit notifications(Off).
    • For each Android app that can send rich notifications (sender app), ensure Managing Notifications > [Sender app listing] (checkmarked).


To import Rich Notification libraries to the application project:

  1. Add the Rich Notification JAR, Rich Notification SDK client lib JAR, and gson JAR files to the libs folder of your Android application in Eclipse:


  1. Add the following permissions to your Android manifest file:
    1. richnotification needs the following permissions:
      <uses-permission android:name=""/>
      <uses-permission android:name=""/>
    2. If the permissions are not added the initialization will fail with SecurityException
      • For Samsung devices: 
        • Android 4.4.2 (KitKat) and above: SecurityException is thrown and your application does not work.
        • Prior to Android 4.4.2 (KitKat): No exception is thrown and your application will work properly.
      • For other companies: No exception and your application will work properly.
    3. When SrnRemoteBuiltInAction with OperationType.CALL is used, the following permission must be added:
      <uses-permission android:name="android.permission.CALL_PHONE"/>
    4. When SrnRemoteBuiltInAction with OperationType.SMS is used, the following permission must be added:
      <uses-permission android:name="android.permission.SEND_SMS"/>



    • Was this article helpful?