Java SDK integration errors

Common errors in integrating the Java SDK no agora-cloud-recording-java in java.library.path


The system cannot find the file.

  1. Print java.library.path, and check if the LD_LIBRARY_PATH environment variable includes the .so file.
  2. We recommend adding java.library.path to LD_LIBRARY_PATH. You can add LD_LIBRARY_PATH to /etc/profile or put the file in the /usr/lib system directory. Could not initialize class io.agora.cloud_recording.CloudRecorder


agora-cloud-recording-sdk.jar is not in the classpath variable. When you integrate the Java SDK, you need to load the agora-cloud-recording-sdk.jar and files. The .jar file should be included in the classpath variable and the .so file should be included in the LD_LIBRARY_PATH variable.

  1. Print classpath, and check if it includes agora-cloud-recording-sdk.jar.
    System.out.println("<Path to the class>:" + System.getProperty("java.class.path"));
  2. If not, add the path to the .jar file in classpath.

Fails to upload to the cloud storage

Check if your cloud storage settings are correct:

  • bucket: name of your cloud storage bucket, created by yourself in your cloud storage account.
  • accessKey: access key of your cloud storage account.
  • secretKey: secret key of your cloud storage account.

How to get the URL of the M3U8 file

The URL of the M3U8 file consists of the domain of your cloud storage and the filename. You can copy the URL in your cloud storage.

The following callbacks contain the filename of the M3U8 file:

101 error

The "ErrorUint32":101 error in the log file is usually caused by a token error, such as in the following situations:

  • A wrong token.
  • An expired token.
  • The Native/Web SDK uses a token while the cloud recording does not use a token.
  • The cloud recording uses a token while the Native/Web SDK does not use a token.

Abnormal exit

The recording exits abnormally when the app crashes. As long as the call or live broadcast is ongoing, the Agora Cloud Recording service keeps recording and uploading. You can use the original App ID, channel name, and UID to join the channel again and take control of the original recording instance.