Add Meeting Support to your Android App

When you enable Live Experience meeting support in your app, you provide a URL to a user that they can click to join a meeting instance that you configure.

Meeting URLs are composed of a base URL and a meeting code. The base URL is application-specific and is entered in the Admin Console, for example, orcl://www.example.com/meeting.

When an associate creates a meeting and sends the URL to the user, the final URL might look like orcl://www.example.com/meeting/DGGD2KAU.

In order to process meeting URLs, you need to configure the base URL to automatically load your Live Experience-enabled app, and pass the meeting code to it using either https://developer.android.com/training/app-links/deep-linking or https://developer.android.com/training/app-links/index.html.

  1. Create a new activity in your Android Studio project and define a new URI scheme:
    <activity
     android:name=".MeetingActivity"
     android:label="title_activity_meeting"
     android:theme="@style/AppTheme.NoActionBar"
     android:parentActivityName=".HomeActivity">
     <intent-filter android:label="@string/filter_view_https">
     <action android:name="android.intent.action.VIEW" />
     <category android:name="android.intent.category.DEFAULT" />
     <category android:name="android.intent.category.BROWSABLE" />
     <!-- Accepts URIs that begin with "orcl://www.example.com/meeting" -->
     <data android:scheme="orcl"
     android:host="www.example.com"
     android:pathPrefix="/meeting" />
     </intent-filter>
    </activity>
  2. Initialize the widget. See Initialize and Display the Live Experience Widget for your Android App.
  3. Extract the meeting code from the URL:
    @Override
    public void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
     setContentView(R.layout.main);
     Intent intent = getIntent();
     Uri data = intent.getData();
     List<String> pathSegments = data.getPathSegments();
     CommunicationFragment.contextAttributes.set(MEETING_CODE, pathSegments.get(pathSegments.size() - 1));
    }
  4. Set the appLocation and meetingCode context attributes:
    CommunicationFragment.contextAttributes.set("appLocation", "Meeting");
    CommunicationFragment.contextAttributes.set("meetingCode", "DGGD2KAU");

    See Configure Context Information for your Android App for more information on context attributes.

Results:

The meeting starts automatically after the widget gets initialized.

What to do next

Next, Add Notification Support to your Android App.