netless-io / flat-android

Project Flat Android is the Android client of Agora Flat open source classroom.

Agora Flat Android

Project Flat Android is the Android client of Agora Flat open source classroom.

中文

Try it now

• Download artifact
• Start using Flat Web

Features

• Open sourced front-end and back-end
  • Flat Web
  • Flat Desktop (Windows and macOS)
  • Flat Android
  • Flat Server
• Optimized teaching experience
  • Big class
  • Small class
  • One on one
• Real-time interaction
  • Multifunctional interactive whiteboard
  • Real-time video/audio chat(RTC)
  • Real-time messaging(RTM)
  • Participant hand raising
• Login via
  • Wechat
  • GitHub
  • Google
• Classroom management
  • Join and create classrooms
  • Support periodic rooms
  • View room history
  • schedule classrooms
• Classroom recording and replaying
  • Whiteboard replaying
  • Cloud recording for video and audio
  • Messaging replaying
• Cloud Storage for multi-media courseware
• Device self-check
• Auto Updater

Development

Android Code

Flat is an app that attempts to use the latest cutting edge libraries and tools. As a summary:

• Entirely written in Kotlin.
• UI Mostly written in Jetpack Compose (see below).
• Uses Kotlin Coroutines throughout.
• Uses many of the Architecture Components, including: Room, Lifecycle, ViewModel.
• Uses Hilt for dependency injection

Development Tool

Flat require the latest Android Studio Arctic Fox release to be able to build the app. This is because the project is written in Jetpack Compose (more on that below).

Environment Variables Reference

Variable	Description	Note
NETLESS_APP_IDENTIFIER	Whiteboard Access Key	See Projects and permissions
AGORA_APP_ID	Agora App ID	For RTC and RTM. See Use an App ID for authentication
WECHAT_APP_ID	Wechat Open Platform App ID
FLAT_SERVER_DOMAIN	Flat Server deployed address	e.g. flat-api.whiteboard.agora.io

Disclaimers

You may use Flat for commercial purposes but please note that we do not accept customizational commercial requirements and deployment supports. Nor do we offer customer supports for commercial usage. Please head to agora-flexible-classroom for such requirements.

flat-android's Issues

unknow property of signing.filepath in build.gradle

Hi, thx for the maintenance of this nice project. I'm just a beginner in android development and I'm just exploring flat.
After I download this project and open it with my Android Studio Bumblebee | 2021.1.1, there is an error presented as follows:

org.gradle.api.GradleScriptException: A problem occurred evaluating project ':app'.
Caused by: groovy.lang.MissingPropertyException: Could not get unknown property 'signing.filepath' for project ':app' of type org.gradle.api.Project.

I think it comes from the build.gradle file in the signingConfig:

signingConfigs {
      release {
          storeFile file(property('signing.filepath'))
          storePassword property('signing.storePassword')
          keyAlias property('signing.keyAlias')
          keyPassword property('signing.keyPassword')
      }

      debug {
          storeFile file(property('signing.filepath'))
          storePassword property('signing.storePassword')
          keyAlias property('signing.keyAlias')
          keyPassword property('signing.keyPassword')
      }
  }

Is this an OAuth setting for Wechat loggin? There seems to be a little bit less information about set up on android than on the web.
Really hope the flat to have a wider influence in the future.
Best regards.

Join Slack

Join Link 👉 Agroa Flat Slack

if the link does not work, please leave a comment and we will update it

App crashing on load

E/linker: "/data/app/~~RmvzG0ayhtt_jI35aRLZ6g==/io.agora.flat-2phtGLAq2-f68FmwpBJOmQ==/base.apk!/lib/x86/libagora-ffmpeg.so" has text relocations (https://android.googlesource.com/platform/bionic/+/master/android-changes-for-ndk-developers.md#Text-Relocations-Enforced-for-API-level-23)
D/AndroidRuntime: Shutting down VM
E/AndroidRuntime: FATAL EXCEPTION: main
Process: io.agora.flat, PID: 6479
java.lang.UnsatisfiedLinkError: dlopen failed: "/data/app/~~RmvzG0ayhtt_jI35aRLZ6g==/io.agora.flat-2phtGLAq2-f68FmwpBJOmQ==/base.apk!/lib/x86/libagora-ffmpeg.so" has text relocations (https://android.googlesource.com/platform/bionic/+/master/android-changes-for-ndk-developers.md#Text-Relocations-Enforced-for-API-level-23)
at java.lang.Runtime.loadLibrary0(Runtime.java:1087)
at java.lang.Runtime.loadLibrary0(Runtime.java:1008)
at java.lang.System.loadLibrary(System.java:1664)
at io.agora.rtc.internal.RtcEngineImpl.loadNativeLibrary(RtcEngineImpl.java:140)
at io.agora.rtc.internal.RtcEngineImpl.initializeNativeLibs(RtcEngineImpl.java:200)
at io.agora.rtc.RtcEngine.create(RtcEngine.java:42)
at io.agora.flat.di.impl.RtcApiImpl.init(RtcApiImpl.kt:22)
at io.agora.flat.MainApplication.onCreate(MainApplication.kt:18)
at android.app.Instrumentation.callApplicationOnCreate(Instrumentation.java:1192)
at android.app.ActivityThread.handleBindApplication(ActivityThread.java:6712)
at android.app.ActivityThread.access$1300(ActivityThread.java:237)
at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1913)
at android.os.Handler.dispatchMessage(Handler.java:106)
at android.os.Looper.loop(Looper.java:223)
at android.app.ActivityThread.main(ActivityThread.java:7656)
at java.lang.reflect.Method.invoke(Native Method)
at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:592)
at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:947)
I/Process: Sending signal. PID: 6479 SIG: 9