content: package io.agora.api.example.examples.basic;
  
  import static io.agora.api.example.common.model.Examples.BASIC;
  
  import android.os.Bundle;
  import android.os.Handler;
  import android.text.TextUtils;
  import android.util.Log;
  import android.view.LayoutInflater;
  import android.view.View;
  import android.view.ViewGroup;
  import android.widget.AdapterView;
  import android.widget.Button;
  import android.widget.EditText;
  import android.widget.SeekBar;
  import android.widget.Spinner;
  import android.widget.Switch;
  
  import androidx.annotation.NonNull;
  import androidx.annotation.Nullable;
  
  import java.util.LinkedHashMap;
  import java.util.Map;
  
  import io.agora.api.example.MainApplication;
  import io.agora.api.example.R;
  import io.agora.api.example.annotation.Example;
  import io.agora.api.example.common.BaseFragment;
  import io.agora.api.example.common.widget.AudioSeatManager;
  import io.agora.api.example.utils.CommonUtil;
  import io.agora.rtc2.ChannelMediaOptions;
  import io.agora.rtc2.Constants;
  import io.agora.rtc2.IRtcEngineEventHandler;
  import io.agora.rtc2.RtcEngine;
  import io.agora.rtc2.RtcEngineConfig;
  import io.agora.rtc2.proxy.LocalAccessPointConfiguration;
  
  /**This demo demonstrates how to make a one-to-one voice call
   * @author cjw*/
  @Example(
          index = 0,
          group = BASIC,
          name = R.string.item_joinaudio_by_token,
          actionId = R.id.action_mainFragment_to_joinChannelAudioByToken,
          tipsId = R.string.joinchannelaudioByToken
  )
  public class JoinChannelAudioByToken extends BaseFragment implements View.OnClickListener
  {
      private static final String TAG = JoinChannelAudioByToken.class.getSimpleName();
      private EditText et_app_id, et_channel, et_token;
      private Button join;
      private RtcEngine engine;
      private int myUid;
      private boolean joined = false;
      private AudioSeatManager audioSeatManager;
  
      @Override
      public void onCreate(@Nullable Bundle savedInstanceState)
      {
          super.onCreate(savedInstanceState);
          handler = new Handler();
      }
  
      @Nullable
      @Override
      public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState)
      {
          View view = inflater.inflate(R.layout.fragment_joinchannel_audio_by_token, container, false);
          return view;
      }
  
      @Override
      public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState)
      {
          super.onViewCreated(view, savedInstanceState);
          join = view.findViewById(R.id.btn_join);
          et_app_id = view.findViewById(R.id.et_app_id);
          et_channel = view.findViewById(R.id.et_channel);
          et_token = view.findViewById(R.id.et_token);
          view.findViewById(R.id.btn_join).setOnClickListener(this);
          audioSeatManager = new AudioSeatManager(
                  view.findViewById(R.id.audio_place_01),
                  view.findViewById(R.id.audio_place_02),
                  view.findViewById(R.id.audio_place_03),
                  view.findViewById(R.id.audio_place_04),
                  view.findViewById(R.id.audio_place_05),
                  view.findViewById(R.id.audio_place_06)
          );
      }
  
      private boolean createRtcEngine(String appId) {
          try
          {
              RtcEngineConfig config = new RtcEngineConfig();
              /**
               * The context of Android Activity
               */
              config.mContext = requireContext().getApplicationContext();
              /**
               * The App ID issued to you by Agora. See <a href="https://docs.agora.io/en/Agora%20Platform/token#get-an-app-id"> How to get the App ID</a>
               */
              config.mAppId = appId;
              /** Sets the channel profile of the Agora RtcEngine.
               CHANNEL_PROFILE_COMMUNICATION(0): (Default) The Communication profile.
               Use this profile in one-on-one calls or group calls, where all users can talk freely.
               CHANNEL_PROFILE_LIVE_BROADCASTING(1): The Live-Broadcast profile. Users in a live-broadcast
               channel have a role as either broadcaster or audience. A broadcaster can both send and receive streams;
               an audience can only receive streams.*/
              config.mChannelProfile = Constants.CHANNEL_PROFILE_LIVE_BROADCASTING;
              /**
               * IRtcEngineEventHandler is an abstract class providing default implementation.
               * The SDK uses this class to report to the app on SDK runtime events.
               */
              config.mEventHandler = iRtcEngineEventHandler;
              config.mAreaCode = ((MainApplication)getActivity().getApplication()).getGlobalSettings().getAreaCode();
              engine = RtcEngine.create(config);
              /**
               * This parameter is for reporting the usages of APIExample to agora background.
               * Generally, it is not necessary for you to set this parameter.
               */
              engine.setParameters("{"
                      + "\"rtc.report_app_scenario\":"
                      + "{"
                      + "\"appScenario\":" + 100 + ","
                      + "\"serviceType\":" + 11 + ","
                      + "\"appVersion\":\"" + RtcEngine.getSdkVersion() + "\""
                      + "}"
                      + "}");
              /* setting the local access point if the private cloud ip was set, otherwise the config will be invalid.*/
              LocalAccessPointConfiguration localAccessPointConfiguration = ((MainApplication) getActivity().getApplication()).getGlobalSettings().getPrivateCloudConfig();
              if (localAccessPointConfiguration != null) {
                  // This api can only be used in the private media server scenario, otherwise some problems may occur.
                  engine.setLocalAccessPoint(localAccessPointConfiguration);
              }
  
              return true;
          }
          catch (Exception e)
          {
              showAlert(e.getMessage());
          }
  
          return false;
      }
  
      private void destroyRtcEngine(){
          /**leaveChannel and Destroy the RtcEngine instance*/
          if(engine != null)
          {
              engine.leaveChannel();
              RtcEngine.destroy();
              engine = null;
          }
      }
  
      @Override
      public void onDestroy()
      {
          super.onDestroy();
          destroyRtcEngine();
      }
  
      @Override
      public void onClick(View v)
      {
          if (v.getId() == R.id.btn_join)
          {
              if (!joined)
              {
                  CommonUtil.hideInputBoard(getActivity(), et_channel);
                  // call when join button hit
                  String appId = et_app_id.getText().toString();
                  String channelId = et_channel.getText().toString();
                  String token = et_token.getText().toString();
  
                  if(TextUtils.isEmpty(appId)){
                      showLongToast(getString(R.string.app_id_empty));
                      return;
                  }
  
                  if (createRtcEngine(appId)) {
                      joinChannel(channelId, token);
                  }
              }
              else
              {
                  joined = false;
                  join.setText(getString(R.string.join));
                  audioSeatManager.downAllSeats();
                  destroyRtcEngine();
              }
          }
      }
  
      /**
       * @param channelId Specify the channel name that you want to join.
       *                  Users that input the same channel name join the same channel.*/
      private void joinChannel(String channelId, String token)
      {
          /**In the demo, the default is to enter as the anchor.*/
          engine.setClientRole(Constants.CLIENT_ROLE_BROADCASTER);
  
          engine.setDefaultAudioRoutetoSpeakerphone(true);
  
          ChannelMediaOptions option = new ChannelMediaOptions();
          option.autoSubscribeAudio = true;
          option.autoSubscribeVideo = true;
  
          /** Allows a user to join a channel.
           if you do not specify the uid, we will generate the uid for you*/
          int res = engine.joinChannel(token, channelId, 0, option);
          if (res != 0)
          {
              engine.leaveChannel();
              // Usually happens with invalid parameters
              // Error code description can be found at:
              // en: https://docs.agora.io/en/Voice/API%20Reference/java/classio_1_1agora_1_1rtc_1_1_i_rtc_engine_event_handler_1_1_error_code.html
              // cn: https://docs.agora.io/cn/Voice/API%20Reference/java/classio_1_1agora_1_1rtc_1_1_i_rtc_engine_event_handler_1_1_error_code.html
              showAlert(RtcEngine.getErrorDescription(Math.abs(res)));
              Log.e(TAG, RtcEngine.getErrorDescription(Math.abs(res)));
              return;
          }
          // Prevent repeated entry
          join.setEnabled(false);
      }
  
      /**IRtcEngineEventHandler is an abstract class providing default implementation.
       * The SDK uses this class to report to the app on SDK runtime events.*/
      private final IRtcEngineEventHandler iRtcEngineEventHandler = new IRtcEngineEventHandler()
      {
          /**
           * Error code description can be found at:
           * en: https://api-ref.agora.io/en/voice-sdk/android/4.x/API/class_irtcengineeventhandler.html#callback_irtcengineeventhandler_onerror
           * cn: https://docs.agora.io/cn/voice-call-4.x/API%20Reference/java_ng/API/class_irtcengineeventhandler.html#callback_irtcengineeventhandler_onerror
           */
          @Override
          public void onError(int err) {
              super.onError(err);
              showLongToast("onError code=" + err + ", msg=" + RtcEngine.getErrorDescription(err));
              runOnUIThread(() -> join.setEnabled(true));
              if(err== Constants.ERR_INVALID_TOKEN){
                  engine.leaveChannel();
                  showAlert(getString(R.string.token_invalid));
              }else if(err== Constants.ERR_TOKEN_EXPIRED){
                  engine.leaveChannel();
                  showAlert(getString(R.string.token_expired));
              }
          }
  
          /**Occurs when a user leaves the channel.
           * @param stats With this callback, the application retrieves the channel information,
           *              such as the call duration and statistics.*/
          @Override
          public void onLeaveChannel(RtcStats stats)
          {
              super.onLeaveChannel(stats);
              Log.i(TAG, String.format("local user %d leaveChannel!", myUid));
              //showLongToast(String.format("local user %d leaveChannel!", myUid));
          }
  
          /**Occurs when the local user joins a specified channel.
           * The channel name assignment is based on channelName specified in the joinChannel method.
           * If the uid is not specified when joinChannel is called, the server automatically assigns a uid.
           * @param channel Channel name
           * @param uid User ID
           * @param elapsed Time elapsed (ms) from the user calling joinChannel until this callback is triggered*/
          @Override
          public void onJoinChannelSuccess(String channel, int uid, int elapsed)
          {
              Log.i(TAG, String.format("onJoinChannelSuccess channel %s uid %d", channel, uid));
              showLongToast(String.format("onJoinChannelSuccess channel %s uid %d", channel, uid));
              myUid = uid;
              joined = true;
              handler.post(new Runnable()
              {
                  @Override
                  public void run()
                  {
                      join.setEnabled(true);
                      join.setText(getString(R.string.leave));
                      audioSeatManager.upLocalSeat(uid);
                  }
              });
          }
  
          /**Since v2.9.0.
           * This callback indicates the state change of the remote audio stream.
           * PS: This callback does not work properly when the number of users (in the Communication profile) or
           *     broadcasters (in the Live-broadcast profile) in the channel exceeds 17.
           * @param uid ID of the user whose audio state changes.
           * @param state State of the remote audio
           *   REMOTE_AUDIO_STATE_STOPPED(0): The remote audio is in the default state, probably due
           *              to REMOTE_AUDIO_REASON_LOCAL_MUTED(3), REMOTE_AUDIO_REASON_REMOTE_MUTED(5),
           *              or REMOTE_AUDIO_REASON_REMOTE_OFFLINE(7).
           *   REMOTE_AUDIO_STATE_STARTING(1): The first remote audio packet is received.
           *   REMOTE_AUDIO_STATE_DECODING(2): The remote audio stream is decoded and plays normally,
           *              probably due to REMOTE_AUDIO_REASON_NETWORK_RECOVERY(2),
           *              REMOTE_AUDIO_REASON_LOCAL_UNMUTED(4) or REMOTE_AUDIO_REASON_REMOTE_UNMUTED(6).
           *   REMOTE_AUDIO_STATE_FROZEN(3): The remote audio is frozen, probably due to
           *              REMOTE_AUDIO_REASON_NETWORK_CONGESTION(1).
           *   REMOTE_AUDIO_STATE_FAILED(4): The remote audio fails to start, probably due to
           *              REMOTE_AUDIO_REASON_INTERNAL(0).
           * @param reason The reason of the remote audio state change.
           *   REMOTE_AUDIO_REASON_INTERNAL(0): Internal reasons.
           *   REMOTE_AUDIO_REASON_NETWORK_CONGESTION(1): Network congestion.
           *   REMOTE_AUDIO_REASON_NETWORK_RECOVERY(2): Network recovery.
           *   REMOTE_AUDIO_REASON_LOCAL_MUTED(3): The local user stops receiving the remote audio
           *               stream or disables the audio module.
           *   REMOTE_AUDIO_REASON_LOCAL_UNMUTED(4): The local user resumes receiving the remote audio
           *              stream or enables the audio module.
           *   REMOTE_AUDIO_REASON_REMOTE_MUTED(5): The remote user stops sending the audio stream or
           *               disables the audio module.
           *   REMOTE_AUDIO_REASON_REMOTE_UNMUTED(6): The remote user resumes sending the audio stream
           *              or enables the audio module.
           *   REMOTE_AUDIO_REASON_REMOTE_OFFLINE(7): The remote user leaves the channel.
           *   @param elapsed Time elapsed (ms) from the local user calling the joinChannel method
           *                  until the SDK triggers this callback.*/
          @Override
          public void onRemoteAudioStateChanged(int uid, int state, int reason, int elapsed) {
              super.onRemoteAudioStateChanged(uid, state, reason, elapsed);
              Log.i(TAG, "onRemoteAudioStateChanged->" + uid + ", state->" + state + ", reason->" + reason);
          }
  
          /**Occurs when a remote user (Communication)/host (Live Broadcast) joins the channel.
           * @param uid ID of the user whose audio state changes.
           * @param elapsed Time delay (ms) from the local user calling joinChannel/setClientRole
           *                until this callback is triggered.*/
          @Override
          public void onUserJoined(int uid, int elapsed)
          {
              super.onUserJoined(uid, elapsed);
              Log.i(TAG, "onUserJoined->" + uid);
              showLongToast(String.format("user %d joined!", uid));
              runOnUIThread(() -> {
                  audioSeatManager.upRemoteSeat(uid);
              });
          }
  
          /**Occurs when a remote user (Communication)/host (Live Broadcast) leaves the channel.
           * @param uid ID of the user whose audio state changes.
           * @param reason Reason why the user goes offline:
           *   USER_OFFLINE_QUIT(0): The user left the current channel.
           *   USER_OFFLINE_DROPPED(1): The SDK timed out and the user dropped offline because no data
           *              packet was received within a certain period of time. If a user quits the
           *               call and the message is not passed to the SDK (due to an unreliable channel),
           *               the SDK assumes the user dropped offline.
           *   USER_OFFLINE_BECOME_AUDIENCE(2): (Live broadcast only.) The client role switched from
           *               the host to the audience.*/
          @Override
          public void onUserOffline(int uid, int reason)
          {
              Log.i(TAG, String.format("user %d offline! reason:%d", uid, reason));
              showLongToast(String.format("user %d offline! reason:%d", uid, reason));
              runOnUIThread(() -> {
                  audioSeatManager.downSeat(uid);
              });
          }
  
          @Override
          public void onLocalAudioStats(LocalAudioStats stats) {
              super.onLocalAudioStats(stats);
              runOnUIThread(() -> {
                  Map<String, String> _stats = new LinkedHashMap<>();
                  _stats.put("sentSampleRate", stats.sentSampleRate + "");
                  _stats.put("sentBitrate", stats.sentBitrate + " kbps");
                  _stats.put("internalCodec", stats.internalCodec + "");
                  _stats.put("audioDeviceDelay", stats.audioDeviceDelay + " ms");
                  audioSeatManager.getLocalSeat().updateStats(_stats);
              });
          }
  
          @Override
          public void onRemoteAudioStats(RemoteAudioStats stats) {
              super.onRemoteAudioStats(stats);
              runOnUIThread(() -> {
                  Map<String, String> _stats = new LinkedHashMap<>();
                  _stats.put("numChannels", stats.numChannels + "");
                  _stats.put("receivedBitrate", stats.receivedBitrate + " kbps");
                  _stats.put("audioLossRate", stats.audioLossRate + "");
                  _stats.put("jitterBufferDelay", stats.jitterBufferDelay + " ms");
                  audioSeatManager.getRemoteSeat(stats.uid).updateStats(_stats);
              });
          }
      };
  }
  