Skip to content

Latest commit

 

History

History
1395 lines (958 loc) · 41.4 KB

CHANGELOG.md

File metadata and controls

1395 lines (958 loc) · 41.4 KB

Changelog

All notable changes to the daily-android SDK will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.30.0] - 2025-03-28

Added

  • Added CallClient.GlobalConfig.setIgnoredNetworkDevices() API.

Fixed

  • Fixed issue where the ice servers configured by the user were not being applied when creating the PeerConnection.

[0.29.0] - 2025-02-28

Added

  • Added support to automatically start a recording when joining a room if the start_cloud_recording token property is set to True.

Fixed

  • Fixed an issue where reconnection would fail if the meeting token was no longer valid.

Security

  • Updated third party dependencies

[0.28.0] - 2024-12-13

Fixed

  • Fixed issue where optional com.banuba.** classes caused a build error in Proguarded app builds.

[0.27.0] - 2024-12-04

Fixed

  • Improved meeting move robustness by increasing the number of retries, to account for situations where the backend takes longer to complete the move.

  • Fix crash when creating and deleting VideoTextureView/VideoTrackCapturerToSurface without also creating a CallClient.

[0.26.0] - 2024-11-11

Added

  • Supoort for camera background blur and image replacement. See VideoMediaTrackSettingsUpdate.processor and VideoProcessor. Note that the Gradle dependency co.daily:client-videoprocessor-plugin:0.1.0 must be added to the project.
  • Support for custom audio tracks, using addCustomAudioTrack(), updateCustomAudioTrack(), and removeCustomAudioTrack().

Fixed

  • Fixed setTransform() crash with VideoTextureView on old versions of Android

[0.25.0] - 2024-11-05

Added

  • VideoTextureView.Listener and VideoTextureView.setListener(), which allow changes to the video resolution to be detected.

Changed

  • Renamed org.webrtc package to co.daily.webrtc to avoid conflicts.

  • Renamed some variants of setSubscriptionState and updateSubscriptions to avoid overload resolution issues.

    • setSubscriptionStateForParticipantMedia
    • updateSubscriptionsForParticipants
    • updateSubscriptionsForParticipantsWithProfiles

[0.24.0] - 2024-09-27

Added

  • CallClientListener.onAppMessageFromRestApi() callback for receiving app messages sent through the REST API.

Changed

  • TranscriptionStatus.transcriptId is now nullable, fixing an error where null values from the server would prevent the onTranscriptionStarted() callback from being invoked.

Deprecated

Fixed

  • Fixed a logging-related crash (stack overflow) that could occur when rapidly starting and stopping the SDK.

  • Fixed an issue where missing fields in the domain/room permission config could cause a connection failure.

[0.23.0] - 2024-08-21

Added

  • Added callConfig field to CallJoinData

Changed

  • The VideoView class is now marked as open

[0.22.1] - 2024-08-01

Fixed

  • Fixed a crash when stopping screen share

[0.22.0] - 2024-07-30

Added

  • Added new metrics that will allow us to better understand the meeting quality.

Fixed

  • Fixed an issue to show the correct state when the mic is muted remotely.
  • Fixed an issue with meeting moves that could occur in an exceptional case where, for a short period of time, we didn't receive information about which worker server to connect to.

[0.21.0] - 2024-06-25

Added

  • Introduced support to send connections to Daily's HTTPS and WebSocket endpoints to a specified proxy server instead.

      callClient?.setProxyUrl("YOUR_PROXY_URL")

  • Introduced support for specifying custom TURN servers rather than only using Daily's default TURN servers.

      callClient?.setIceConfig(IceConfig(
      placement = IceConfigPlacement.Back,
      iceServers = listOf(
          IceServers(urls = listOf("stun:stun.l.google.com:19302"))
      )
  ))

Fixed

  • Classes in the root package are now repackaged under co.daily to avoid name conflicts.

[0.20.0] - 2024-05-14

Fixed

  • Resolved an issue with screen sharing where the new dimensions were not being applied when rotating the screen.
  • Resolved an issue where the videos sent had the wrong orientation when viewed on iOS mobile web.
  • Resolved an issue with screen sharing where the new dimensions were not being applied when MediaProjection onCapturedContentResize was triggered.
  • Fixed an issue where joinedAt value (participant info) could sometimes be zero.

[0.19.0] - 2024-04-16

Added

  • Additional parameters for starting a transcription, and access to more data about the transcribed text.

    • StartTranscriptionProperties.punctuate
    • StartTranscriptionProperties.endpointing
    • StartTranscriptionProperties.includeRawResponse
    • StartTranscriptionProperties.extra
    • TranscriptionMessageData.timestamp
    • TranscriptionMessageData.rawResponse

  • Added a local audio level observer that provides the audio level for the local participant respecting the specified frequency.

      // Starts the local audio level observer
  callClient?.startLocalAudioLevelObserver(200)
  // Stops the local audio level observer
  callClient?.stopLocalAudioLevelObserver()
  // New listener inside CallClientListener
  override fun onLocalAudioLevel(audioLevel: Float) {
      // audio level for the local participant
  }

Fixed

  • Resolved an issue in PublishingSettingsUpdate.Builder which meant custom tracks were ignored.

  • Fixed issue when calling updatePublishing() immediately after updateInputs().

  • We now continue sending screen share frames at a slower rate while the screen is static. This avoids the need to wait to the first frame to arrive when a new participant joins, or when capturing a bitmap from the track.

[0.18.0] - 2024-03-28

Added

  • Introduced support for adaptive bitrate layers. This will improve the visual call quality by utilizing an adaptive bitrate and resolution strategy for the topmost SFU layer. 
      callClient?.updatePublishing(
      PublishingSettingsUpdate(
          camera = CameraPublishingSettingsUpdate(
              sendSettings = VideoSendSettingsUpdate(
                  allowAdaptiveLayers = Enable()
              )
          )
      )
  )

Changed

  • Minimum supported Android SDK version is now 21 (Android 5.0, Lollipop).

Fixed

  • Fixed issue where onParticipantUpdated() didn't reflect the new state of the local participant's screen video track, in cases where leave() was called while a screen share was active.

  • Fixed demo app issue which could sometimes cause local streams to be chosen as the active speaker.

  • Removed incorrect "Track was leaked" error log -- the VideoView was correctly cleaning up the track, but the error message was getting logged anyway.

[0.17.0] - 2024-03-07

Added

  • Ability to set the camera zoom with updateInputs(), using the VideoMediaTrackSettingsUpdate.zoom field.

  • Added convenience methods for setting camera torch and zoom:

    • CallClient.setCameraZoom()
    • CallClient.setCameraTorch()

  • Added support for audio-only recording layout preset.

Changed

  • The startedBy field in TranscriptionStatus is now nullable. The value may be null when transcription was started using the REST API, rather than by a call participant.

Fixed

  • Fixed an issue that could cause join to fail if recording/transcription/live stream was started from the REST API.

  • Fixed onFirstFrameAvailable exception in release builds. This exception was encountered when logging a message about the active camera, and didn't otherwise impact the operation of the SDK.

  • Fixed an issue where stopping a screen share could throw an exception.

  • Fixed an issue in the demo app where screen share could be started before the foreground service was ready.

[0.16.0] - 2024-02-26

Added

  • Added VideoView.mirrorHorizontally and VideoTextureView.mirrorHorizontally, to flip the direction of rendering in the X axis.

  • Ability to remove and update custom tracks, using CallClient.updateCustomVideoTrack() and CallClient.removeCustomVideoTrack().

  • Ability to toggle the camera flashlight with updateInputs(), using the VideoMediaTrackSettingsUpdate.torch field.

    callClient?.updateInputs(
    InputSettingsUpdate(
        camera = CameraInputSettingsUpdate(
            settings = VideoMediaTrackSettingsUpdate(
                torch = Torch(true),
            )
        )
    )
)

Changed

  • More SDK logging now appears in the dashboard.

  • In HIPAA mode, the user ID is no longer redacted in dashboard logs if it's a valid UUID.

  • The custom video tracks feature has been promoted from "beta" status.

Deprecated

  • CallClient.beta.addCustomVideoTrack() has been deprecated, in favor of CallClient.addCustomVideoTrack().

Removed

  • Removed CustomTrackInputSettingsUpdate from the beta custom tracks API. updatePublishing should be used to toggle custom tracks instead.

Fixed

  • Enable Opus FEC to improve audio with network packet loss.

[0.15.0] - 2024-01-31

Added

  • Added participantId field to TranscriptionMessageData.

  • Added transcriptId field to TranscriptionStatus.

Fixed

  • Fixed multiple issues which could cause a deadlock during network reconnection.

  • Ensure that updateInputs() continues to be usable while the network is down.

  • Fixed an issue where the SDK could fail to release resources when turning off the camera track.

  • Fixed a crash which could occur if the network connection drops soon after joining.

[0.14.0] - 2023-12-22

Added

  • Added ability to choose the preferred codec. 
      callClient?.updatePublishing(
      PublishingSettingsUpdate(
          camera = CameraPublishingSettingsUpdate(
              sendSettings = VideoSendSettingsUpdate(
                  preferredCodec = CodecNameUpdate.h264
              )
          )
      )
  )
  • Added VideoTrackCapturerToSurface and VideoTrackCapturerToBitmap, which allow video tracks from participants to be captured.
  • Added VideoTextureView, allowing videos to be rendered to an Android TextureView, rather than a SurfaceView. This has reduced performance compared to VideoView, but allows more flexible layering in the Android UI hierarchy.
  • Added a remote participant audio level observer that provides the audio level for all remote participants respecting the specified frequency. 
      // Starts the remote audio level observer
  callClient?.startRemoteParticipantsAudioLevelObserver(200)
  // Stops the remote audio level observer
  callClient?.stopRemoteParticipantsAudioLevelObserver()
  // New listener inside CallClientListener
  override fun onRemoteParticipantsAudioLevel(
      participantsAudioLevel: Map<ParticipantId, Float>
  ) {
      // audio level for each remote participant
  }

Fixed

  • Fixed issue with numeric user IDs in meeting tokens

[0.13.0] - 2023-12-06

Added

  • Added support to change screen share publish settings. 
      // Example
  callClient?.updatePublishing(
      PublishingSettingsUpdate(
          screenVideo = ScreenVideoPublishingSettingsUpdate(
              isPublishing = Enable(),
              sendSettings = VideoSendSettingsUpdate(
                  maxQuality = VideoMaxQualityUpdate.low,
                  encodings = VideoEncodingsSettingsUpdate(
                      mapOf(
                          VideoMaxQualityUpdate.low to
                              VideoEncodingSettingsUpdate(
                                  maxBitrate = BitRate(1_200_000),
                                  scaleResolutionDownBy = Scale(1F),
                                  maxFramerate = FrameRate(15)
                              ),
                      )
                  )
              )
          )
      )
  )

Changed

  • StartTranscriptionProperties defaults have been removed in favor of Deepgram defaults.
  • StartTranscriptionProperties.redact property is now a List<String> instead of a Boolean. This allows setting any of Deepgram's redact values.

[0.12.0] - 2023-11-21

Added

  • Added support for starting/stopping transcription, and receiving transcription events.
    • CallClient.startTranscription()
    • CallClient.stopTranscription()
    • CallClientListener.onTranscriptionStarted
    • CallClientListener.onTranscriptionStopped
    • CallClientListener.onTranscriptionMessage
    • CallClientListener.onTranscriptionError

Fixed

  • Fixed a crash when modifying a large number of subscriptions at once.
  • Fixed a screen share issue that could make the app freeze.
  • Fixed a screen share issue for compatibility with Android 14.

[0.11.1] - 2023-10-27

Fixed

  • Joining a call where a recording with participant-selection properties specified is ongoing will no longer fail.

[0.11.0] - 2023-10-05

Added

  • New beta API for accessing video stats, VideoView.beta.addVideoTrackStatsListener()
  • Added support for screen sharing:
    • CallClient.startScreenShare : Starts a screen share from the local participant.
    • CallClient.stopScreenShare : Stops the local participant current screen share, if there is one.
    • CallClient.setScreenShareProjectionIntent : Intent with the permission for screen sharing. Needed in case we wish to invoke directly the method updateInputs to start or stop a screen share.

Fixed

  • Temporary network interruptions will now be handled properly and reconnected.
  • Audio device selection issues:
    • When the preferred audio device is no longer available, it will now fall back to our default behavior for audio device selection.
    • Fixed issue where in some scenarios it was selecting to use Earpiece even without the user requesting it.

[0.10.1] - 2023-09-12

Fixed

  • Fixed an issue with the SDK's self-reported version.

[0.10.0] - 2023-09-08

Added

  • Support for receiving streams encoded using H.264.

  • Added the ability to subscribe to remote custom tracks:

    • MediaSubscriptionSettingsUpdate.customVideo
    • MediaSubscriptionSettingsUpdate.customAudio
    • Media.customVideo
    • Media.customAudio

  • Added a beta API for sending a custom video track, CallClient.beta.addCustomVideoTrack(), and a testing API to add a sample custom track, CallClient.beta.addSampleCustomVideoTrack().

    It's possible to configure published custom tracks using the new fields:

    • InputSettingsUpdate.customVideo
    • InputSettingsUpdate.customAudio
    • PublishingSettingsUpdate.customVideo
    • PublishingSettingsUpdate.customAudio

    This API is still in development and may evolve in future releases.

  • Added a new field inputsEnabled in the argument to the method updateRemoteParticipants(), allowing participant admins to remote-mute others, and meeting owners to remote-mute or -unmute others.

Changed

  • Combined the two native libraries in the SDK into a single library. This reduces the size of the SDK from 43MB to 25MB.

  • Hardware-accelerated video encoders and decoders are now used when available.

[0.9.0] - 2023-07-27

Added

  • Added SubscriptionState.staged, allowing subscription setup steps to be performed in advance of when the subscription is needed. The Staged class has also been added for use with updateSubscriptions().

  • Added a new property called canAdmin to the permissions field that's part of the updatePermissions() method. canAdmin can be used to dynamically change permissions for participants from within a call. Admins have the ability to manage participants in a call or manage transcriptions.

Changed

  • Renamed RequestFailedException to OperationFailedException for clarity.

  • Renamed RecordingMode and StreamingEndpointType enum constants to be lowercase, to match other enums.

    • Before:

      enum class RecordingMode {
  Cloud,
  RawTracks,
  Local,
  Off
}

enum class StreamingEndpointType {
  Hls,
  Rtmp
}

    • After:

      enum class RecordingMode {
  cloud,
  rawTracks,
  local,
  off
}

enum class StreamingEndpointType {
  hls,
  rtmp
}

  • Simplified the setInputEnabled and setIsPublishing convenience methods to control only the camera and microphone. setInputEnabled has been renamed to setInputsEnabled.

    • Before:

      fun setInputEnabled(
    mediaType: OutboundMediaType,
    isEnabled: Boolean,
    listener: RequestListener? = null
)

fun setIsPublishing(
    mediaType: OutboundMediaType,
    isPublishing: Boolean,
    listener: RequestListener? = null
)

    • After:

      fun setInputsEnabled(
    camera: Boolean? = null,
    microphone: Boolean? = null,
    listener: RequestListener? = null
)

fun setIsPublishing(
    camera: Boolean? = null,
    microphone: Boolean? = null,
    listener: RequestListener? = null
)

  • Simplified the setSubscriptionState convenience methods to accept track state updates more directly.

    • Before:

      fun setSubscriptionState(
    participantId: ParticipantId,
    mediaTypeToState: Map<InboundMediaType, SubscriptionState>,
    listener: RequestListener? = null
)

fun setSubscriptionState(
    participantIdToMediaTypeToState: Map<ParticipantId, Map<InboundMediaType, SubscriptionState>>,
    listener: RequestListener? = null
)

    • After:

      fun setSubscriptionState(
    participantId: ParticipantId,
    camera: SubscriptionState? = null,
    microphone: SubscriptionState? = null,
    screenVideo: SubscriptionState? = null,
    screenAudio: SubscriptionState? = null,
    listener: RequestListener? = null
)

fun setSubscriptionState(
    participantIdToTracks: Map<ParticipantId, TrackSubscriptionStateUpdate>,
    listener: RequestListener? = null
)

Removed

  • Removed the versions of setInputsEnabled and setIsPublishing which take a Map as input.

[0.8.0] - 2023-05-10

Changed

  • The streamingSettings parameter in updateRecording is no longer optional.

    • Before:

      fun updateLiveStream(
    streamingSettings: StreamingUpdateSettings? = null,
    streamId: StreamId? = null,
    listener: RequestListener? = null
)

    • After:

      fun updateLiveStream(
    streamingSettings: StreamingUpdateSettings,
    streamId: StreamId? = null,
    listener: RequestListener? = null
)

  • The timestamp fields in CallConfiguration are now of type Long rather than Int.

    • Before:

      val roomExpiration: Int? = null,
val tokenExpiration: Int? = null,
val roomNotBefore: Int? = null,
val tokenNotBefore: Int? = null,

    • After:

      val roomExpiration: Long? = null,
val tokenExpiration: Long? = null,
val roomNotBefore: Long? = null,
val tokenNotBefore: Long? = null,

  • The onLiveStreamStarted callback now has a single LiveStreamStatus parameter, which contains the information that was previously provided as multiple parameters.

    • Before:

      fun onLiveStreamStarted(
    streamId: StreamId,
    startedBy: ParticipantId,
    layout: StreamingLayout?
)

    • After:

      fun onLiveStreamStarted(status: LiveStreamStatus)

  • The VideoMaxQuality enum has been split into two separate enums, VideoSendSettingsMaxQuality and VideoReceiveSettingsMaxQuality.

  • The facingMode field of VideoMediaTrackSettings now has an enum type (FacingMode) rather than a String type.

    • Before:

      val facingMode: String

    • After:

      val facingMode: FacingMode

  • Added two additional constants left and right to the FacingMode enum.

    • Before:

      enum class FacingMode {
  user,
  environment;
}

    • After:

      enum class FacingMode {
  user,
  environment,
  left,
  right;
}

[0.7.1]

Added

  • CallClient.callConfigFor() -- request the call configuration for a given Daily room URL.

  • A new callConfiguration field has been added to CallClient. This field is updated a call has been successfully joined or left.

  • Support for specifying a meeting token when joining a call.

  • Added Builder classes for several Update types (such as InputSettingsUpdate.Builder), to make instantiating those types easier in Java.

  • Added simple media control convenience methods to CallClient:

    • setInputEnabled() and setInputsEnabled()
    • setIsPublishing()
    • setSubscriptionState()
    • setSubscriptionProfile()

Changed

  • Changed the order of arguments to CallClient.startLiveStream():

    • Before:

      fun startLiveStream(
    endpoints: LiveStreamEndpoints,
    streamingSettings: StreamingSettings? = null,
    forceNew: StreamingStartMode = StreamingStartMode.onlyIfNotAlreadyStreaming,
    streamId: StreamId? = null,
    listener: RequestListenerWithData<StreamId>? = null
)

    • After:

      fun startLiveStream(
    endpoints: LiveStreamEndpoints,
    streamingSettings: StreamingSettings? = null,
    streamId: StreamId? = null,
    forceNew: StreamingStartMode = StreamingStartMode.onlyIfNotAlreadyStreaming,
    listener: RequestListenerWithData<StreamId>? = null
)

  • Changed the order of arguments to CallClient.startRecording().

    • Before:

      fun startRecording(
    streamingSettings: StreamingSettings? = null,
    forceNew: StreamingStartMode = StreamingStartMode.onlyIfNotAlreadyStreaming,
    streamId: StreamId? = null,
    listener: RequestListenerWithData<StreamId>? = null
)

    • After:

      fun startRecording(
    streamingSettings: StreamingSettings? = null,
    streamId: StreamId? = null,
    forceNew: StreamingStartMode = StreamingStartMode.onlyIfNotAlreadyStreaming,
    listener: RequestListenerWithData<StreamId>? = null
)

  • Changed the order of arguments to CallClient.updateRecording().

    • Before:

      fun updateRecording(
    streamId: StreamId? = null,
    streamingSettings: StreamingUpdateSettings? = null,
    listener: RequestListener? = null
)

    • After:

      fun updateRecording(
    streamingSettings: StreamingUpdateSettings? = null,
    streamId: StreamId? = null,
    listener: RequestListener? = null
)

Removed

  • The VideoView.release() method has been removed, as cleanup is now automatic.

  • The MeetingSession.topology field has been removed.

[0.7.0]

This library version was corrupted by a faulty build script and will crash unexpectedly, so it should not be used. Please use version 0.7.1 instead.

[0.6.0]

Added

  • A new wrapper class CallClientCoroutineWrapper has been added, to allow the CallClient APIs to be used from Kotlin Coroutines. The CallClient APIs now notify listeners when asynchronous operations are completed, as detailed below.

APIs

  • CallClient.sendAppMessage() -- this allows sending custom JSON messages either to all participants, or a participant of your choice.

  • CallClient.startRecording() -- starts a recording.

  • CallClient.stopRecording() -- stops a recording.

  • CallClient.updateRecording() -- changes the configuration of an existing recording.

  • A new permissions field has been added to the participant Info class. It describes the the participant's in-call permissions, and is non-null only upon joining. It's made up of:

    • hasPresence: a boolean describing whether the participant has presence (i.e. whether they show up in others' participants())
    • canSend: a set describing which kinds of media a participant is allowed to send (camera, microphone, screenVideo, screenAudio, customVideo, and customAudio).

    When the local participant's canSend permission is updated by a meeting owner, they may end up losing permission to send a kind of media they were previously sending. When permission to send that media is restored, they will automatically resume sending it (assuming inputs() and publishing() are both still enabled for that media.)

  • A new offReasons field has been added to ParticipantAudioInfo and ParticipantVideoInfo, describing why a participant's media might be in the state MediaState.off. There may be more than one of the following reasons:

    • user: The user explicitly wants the media to be off.
    • bandwidth: The media has been automatically stopped due to bandwidth concerns.
    • sendPermission: The media is off due to the sender lacking proper canSend permission.

  • A new CallClient.updateRemoteParticipants() method that allows you to modify things about remote participants that you can control as a meeting owner (it fails if you're not the meeting owner). Today the only thing you can control about remote participants is their permissions (i.e. hasPresence and canSend). Any permission not specified will not be updated.

  • CallClient.startLiveStream() -- starts a live stream to the specified endpoints.

  • CallClient.addLiveStreamingEndpoints() -- adds new endpoints to an existing live stream.

  • CallClient.removeLiveStreamingEndpoints() -- removes endpoints from an existing live stream.

  • CallClient.stopLiveStream() -- stops an existing live stream.

  • CallClient.updateLiveStream() -- alters the layout of an existing live stream.

Events

  • CallClientListener.onAppMessage() -- this callback will be invoked whenever an app message is received from another participant.

  • CallClientListener.onRecordingStarted() -- emitted when a recording starts.

  • CallClientListener.onRecordingStopped() -- emitted when a recording stops.

  • CallClientListener.onRecordingError() -- emitted when a recording error occurs.

  • A new reason field has been added to CallClientListener.onParticipantLeft(). It can assume two values:

    • hidden: The participant has lost presence (i.e. their hasPresence permissions has been revoked).
    • leftCall: The participant has left the room.

  • New event onNetworkStatsUpdated on CallClientListener which is emitted when a new batch of network statistics are calculated. This also comes with the getter getNetworkStats on CallClient.

  fun onNetworkStatsUpdated(newNetworkStatistics: NetworkStats)
  • New event onParticipantCounts on CallClientListener which is emitted when the participant counts change. This also comes with the getter participantCounts on CallClient.
  fun onParticipantCounts(newParticipantCounts: ParticipantCounts)

  • CallClientListener.onLiveStreamStarted() -- emitted when a live stream starts.

  • CallClientListener.onLiveStreamStopped() -- emitted when a live stream stops.

  • CallClientListener.onLiveStreamError() -- emitted when a live stream encounters an error.

  • CallClientListener.onLiveStreamWarning() -- emitted when a live stream encounters a warning.

Changed

  • CallState.new has been renamed to CallState.initialized

  • The CallClient has been modified so that all blocking operations can be performed asynchronously.

    • The following methods have an extra (optional) listener parameter, that can be used to handle the request completing or encountering an error:
      • setUserName()
      • setAudioDevice()
      • updateInputs()
      • updateSubscriptions()
      • updateSubscriptionProfiles()
      • updatePublishing()
      • leave()
    • The join() method now has a mandatory listener parameter (see below).
    • Methods in CallClient which were previously suspend are no longer suspend, but rather enqueue the operation to be completed in the background, and immediately return. The listener associated with each API call will be notified when the operation completes.
      • If you are using Kotlin Coroutines, a new wrapper class CallClientCoroutineWrapper has been added which exposes suspend functions rather than listeners. Depending on your preference, you may use this class instead of CallClient.

Deprecated

  • n/a

Removed

  • The VideoView.release() method has been removed, as cleanup is now automatic.

Fixed

  • n/a

Performance

  • n/a

Security

  • n/a

Other

  • n/a

[0.5.0]

Added

  • Support for specifying a meeting token when joining a call.

Changed

  • The VideoView now automatically releases its resources when it is detached from the window.

  • The signature of the CallClient.join() method has changed to allow for a meeting token to be specified. As mentioned above, a listener parameter has also been added.

    • Before:

      suspend fun join(
    url: String,
    clientSettings: ClientSettingsUpdate? = null
)

    • After:

      suspend fun join(
    url: String,
    meetingToken: MeetingToken? = null,
    clientSettings: ClientSettingsUpdate? = null,
    listener: RequestListenerWithData<CallJoinData>
)

Deprecated

  • n/a

Removed

  • The VideoView.release() method has been removed, as cleanup is now automatic.

Fixed

  • n/a

Performance

  • n/a

Security

  • n/a

Other

  • n/a

[0.4.0]

Added

  • New function on CallClient to allow set the participant username.

      fun setUserName(userName: String)

  • Added support for working with audio input/output devices in order to set them up and query them, so now you can build a device picker:

    • The function availableDevices now also returns a list of available audio devices. The data returned can be used to change the audio device that are currently in use.
    • New function on CallClient to allow get the current audio device 
        fun audioDevice()
    • New function on CallClient to allow sets the audio input/output device. It takes a deviceId as an argument that matches an id returned by availableDevices. 
        fun setAudioDevice(deviceId)
    • New event CallClientListener which is emitted when the available devices change. 
        fun onAvailableDevicesUpdated(availableDevices: AvailableDevices)

  • Now is possible to include VideoView in an XML layout, with properties daily_bring_to_front and daily_scale_mode.

Changed

  • Increased minimum Android SDK requirement to 24 (Android 7.0).

  • The function VideoView.bringVideoToFront() has been replaced with a property, VideoView.bringVideoToFront.

  • If a VideoView is brought to the front using bringVideoToFront, it now only sits on top of other VideoView instances, and will not occlude other Views drawn over it.

  • The Lifecycle parameter for the CallClient constructor is now optional. If omitted, the CallClient should be manually cleaned up using CallClient.release().

  • It is now possible to specify a custom Handler when creating the CallClient. CallClient APIs should be called either from the main thread, or from the thread associated with your Handler (if you've specified one).

Deprecated

  • n/a

Removed

  • n/a

Fixed

  • n/a

Performance

  • n/a

Security

  • n/a

Other

  • n/a

[0.3.1] - 2022-07-27

Fixed

  • Fixed an issue where the onSubscriptionProfilesUpdated method was always required to be overridden when adding a listener.

[0.3.0] - 2022-07-22

Added

  • Support to video scale mode on VideoView:

    • Before, video view always worked scaling the video to fill all the screen. Now video view has the property videoScaleMode, which you can set one of these values:
      • VideoScaleMode.FILL: video frame is scaled to fill the size of the view by maintaining the aspect ratio. Some portion of the video frame may be clipped. This is the default value.
      • VideoScaleMode.FIT: video frame is scaled to fit the size of the view by maintaining the aspect ratio, this probably will make borders to be displayed.

  • Support to receive screen share.

    • Now, participant.media has two new fields:
      • screenAudio: contains the participant's screen audio track and track state.
      • screenVideo: contains the participant's screen video track and track state.

  • Add support to identify the active speaker.

    • New function on CallClient to check who is the active speaker

        fun activeSpeaker(): Participant?

    • New event CallClientListener which is emitted when the active speaker changes.

        fun onActiveSpeakerChanged(activeSpeaker: Participant?)

  • Add support to update subscriptions

    • New function on CallClient to update subscriptions. Configure how (or if) to subscribe to remote media tracks.

        suspend fun updateSubscriptions(
    forParticipants: Map<ParticipantId, Update<SubscriptionSettingsUpdate>>? = null,
    forParticipantsWithProfiles: Map<SubscriptionProfile, Update<SubscriptionSettingsUpdate>>? = null
  ): Map<ParticipantId, SubscriptionSettings>

    • New event CallClientListener which is emitted when subscriptions change.

        fun onSubscriptionsUpdated(subscriptions: Map<ParticipantId, SubscriptionSettings>)

    • New function on CallClient to check the current subscriptions

        fun subscriptions(): Map<ParticipantId, SubscriptionSettings>

    • New function on CallClient to update subscription profiles. Configure how (or if) to subscribe to remote media tracks.

        suspend fun updateSubscriptionProfiles(
    subscriptionProfiles: Map<SubscriptionProfile, Update<SubscriptionProfileSettingsUpdate>>
  ): Map<SubscriptionProfile, SubscriptionProfileSettings>

    • New event CallClientListener which is emitted when subscriptions profile change.

        fun onSubscriptionProfilesUpdated(subscriptionProfiles: Map<SubscriptionProfile, SubscriptionProfileSettings>)

    • New function on CallClient to check the current subscription profiles.

        fun subscriptionProfiles(): Map<SubscriptionProfile, SubscriptionProfileSettings>

Changed

  • Renamed the enum class from VideoSendSettingsMaxQuality to VideoMaxQuality, this way the same class can be used for both send and receive settings.

  • Renamed the enum class from VideoSendSettingsMaxQualityUpdate to VideoMaxQualityUpdate, this way the same class can be used for both send and receive settings.

    • Before:

        val publishingSettingsIntent = PublishingSettingsUpdate(
        camera = CameraPublishingSettingsUpdate(
            sendSettings = VideoSendSettingsUpdate(
                encodings = VideoEncodingsSettingsUpdate(
                    settings = mapOf(
                        VideoSendSettingsMaxQualityUpdate.low to
                                VideoEncodingSettingsUpdate(
                                    maxBitrate = BitRate(80000),
                                    maxFramerate = FrameRate(10),
                                    scaleResolutionDownBy = Scale(4F)
                                ),
                        VideoSendSettingsMaxQualityUpdate.medium to
                                VideoEncodingSettingsUpdate(
                                    maxBitrate = BitRate(680000),
                                    maxFramerate = FrameRate(30),
                                    scaleResolutionDownBy = Scale(1F)
                                )
                    )
                )
            )
        )
    )

    • After:

        val publishingSettingsIntent = PublishingSettingsUpdate(
        camera = CameraPublishingSettingsUpdate(
            sendSettings = VideoSendSettingsUpdate(
                encodings = VideoEncodingsSettingsUpdate(
                    settings = mapOf(
                        VideoMaxQualityUpdate.low to
                                VideoEncodingSettingsUpdate(
                                    maxBitrate = BitRate(80000),
                                    maxFramerate = FrameRate(10),
                                    scaleResolutionDownBy = Scale(4F)
                                ),
                        VideoMaxQualityUpdate.medium to
                                VideoEncodingSettingsUpdate(
                                    maxBitrate = BitRate(680000),
                                    maxFramerate = FrameRate(30),
                                    scaleResolutionDownBy = Scale(1F)
                                )
                    )
                )
            )
        )
    )

[0.2.0] - 2022-06-14

Changed

  • Update publishing no longer takes input settings

    • Before:

        suspend fun updatePublishing(
      publishSettings: Update<PublishingSettingsUpdate>,
      inputSettings: Update<InputSettingsUpdate>? = null
  ): PublishingSettings

    • After:

          suspend fun updatePublishing(
        publishSettings: Update<PublishingSettingsUpdate>,
    ): PublishingSettings

  • Making CallClient a lifecycle aware component.

    • Before:

        // Creating the CallClient inside your Activity.
  val callClient = CallClient(applicationContext)
  // Invoking to destroy the CallClient when your activity was destroyed
  callClient.onDestroy()

    • After:

        // Creating the CallClient inside your Activity.
  val callClient = CallClient(applicationContext, this.lifecycle)
  // CallClient is automatically destroyed and release the resources.

  • Refactor how the classes are organized in each package

    • Before:

        └── co
    └── daily
        ├── CallClient.kt
        ├── CallClientListener.kt
        ├── DailyEvent.kt
        ├── UnknownCallClientError.kt
        ├── AvailableDevices.kt
        ├── CallJoinData.kt
        ├── MediaConstraints.kt
        ├── MediaDeviceInfo.kt
        ├── MediaStreamTrack.kt
        ├── MeetingSession.kt
        ├── Participant.kt
        ├── Participants.kt
        ├── ClientSettings.kt
        ├── ClientSettingsUpdate.kt
        ├── DailyAudioManager.kt
        ├── Serializers.kt
        ├── VideoView.kt

    • After:

        └── co
    └── daily
        ├── CallClient.kt
        ├── CallClientListener.kt
        ├── context
        │ └── CallClientSharedContext.kt
        ├── event
        │ └── DailyEvent.kt
        ├── exception
        │ ├── UnknownCallClientError.kt
        │ └── UnsupportedSerializeException.kt
        ├── model
        │ ├── AvailableDevices.kt
        │ ├── CallJoinData.kt
        │ ├── MediaConstraints.kt
        │ ├── MediaDeviceInfo.kt
        │ ├── MediaStreamTrack.kt
        │ ├── MeetingSession.kt
        │ ├── Participant.kt
        │ └── Participants.kt
        ├── settings
        │ ├── ClientSettings.kt
        │ └── ClientSettingsUpdate.kt
        ├── util
        │ ├── DailyAudioManager.kt
        │ └── Serializers.kt
        └── view
            └── VideoView.kt

Fixed

  • Fixed the issue that sometimes the app was crashing when leaving the meeting.
  • Closed the video capturer when invoking getUserMedia with camera isEnabled:false

Other

  • daily-android can now be built using a pre-compiled libwebrtc for all platforms, allowing compiling daily-android even on Mac.
  • Refactor the way we were handling the dependencies and packaging daily-android. Now the only libraries that are packaged together with daily-android are the jars from libwebrtc. All other dependencies are specified on pom.xml to be handled by Maven,

[0.1.1] - 2022-04-14

Initial release.