SociaLite demonstrates how to use various Android platform APIs to implement features that are commonly seen in social network apps, leveraging a variety of Jetpack APIs to achieve complex functionality that works reliably on more devices and requires less code. These are some of the Jetpack APIs used:
- Core Notifications and other platform features
- Compose Declarative UI generation
- Media3 Displaying and editing photos and videos
- CameraX Capturing photos and videos
- Room Persisting messages in a SQLite database
- Window Detecting foldable device states
The app also integrates the Gemini API that powers chatbot capabilities:
- Google AI Client SDK Generative AI with Gemini 1.5 Flash
🚧 Work-in-Progress: This sample is still in the early stage of development, and we're excited to add more features over time.
The main interaction in SociaLite centers around the animal avatars and their associated chat threads. When you send a message to one of these avatars, they will respond in 5 seconds. If you close the app within that time and you've granted notification permissions, you'll see a notification for that reply.
Here are the screens that make up SociaLite:
- Timeline Screen: A vertical scrolling page of all of the photos and videos sent in chats.
- Chat List Screen: A list of all the chat threads with a variety of animal personalities.
- Chat Screen: An individual message thread where you can send text and media messages (from the in-app camera or with a Photo Picker).
- Camera Screen: Clicking the camera icon in the Chat Screen opens the in-app camera for taking photos and videos.
- Video Edit Screen: After taking a video with the in-app camera, users can do some minor edits on this screen.
- Settings Screen: A basic settings screen for tasks like resetting the chat history.
- Clone the repository
- Open the whole project in Android Studio.
- Sync & Run
appconfiguration
Note: The Google AI client SDK for Android used in this code sample is recommended for prototyping only. For non-prototyping use cases, we strongly recommend that you use Vertex AI for Firebase.
- Create a Gemini API key in Google AI studio,
- Add your Gemini API key as
API_KEYto your [local.properties] file, - Sync & Run
appconfiguration, - In the app, go to Settings and tap the "AI Chatbot" button.
You can report an issue with a sample using this repository. When doing so, make sure to specify which sample you are referring to.
Please contribute! We will gladly review any pull requests. Make sure to read the Contributing page first though.
Note: make sure to run
./gradlew spotlessApplybefore uploading a PR.
Copyright 2023 The Android Open Source Project
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
