Choose api version

Release Notes

06/01/2019 – v1.7.1

Built with Swift 5.0.1 (Xcode 10.2.1).
  • Streaming stopped before stream becomes LIVE causes the stream to be force closed. This helps us to release server's resources and free up spaces on your plan as soon as possible.
  • Fixes the Firekast framework so it compiles and runs on simulators.

05/24/2019 – v1.7.0

Built with Swift 5.0 (Xcode 10.2).
  • Player can be muted. * By default, player starts to play immediately, otherwise call play(self.stream, playImmediately: false) to override this behavior.
  • Fix player crash: 'Cannot remove an observer for the key path because it is not registered as an observer.'

04/09/2019 – v1.6.1

Built with Swift 5.0 (Xcode 10.2).
  • Support Swift 5.0

03/20/2019 – v1.6.0

iOS

Built with Swift 4.2.1 (Xcode 10.1).
  • Security: new API auth keys available in your app settings. Use privateKey to initialize the SDK instead of deprecated clientKey and applicationID. This key must remain confidential.
  • Errors: description readibility has been improved to help support.
  • Restream: we decided to let you choose the platform to which you want to live stream. You are no longer dependent on our implementation, provide us with the RTMP link and that's it. So FKOutput has been abandonned.
  • Delegate's methods in Swift code now support Error instead of NSError.
  • Test Bandwidth: start streaming on FKStream.bandwidthTest stream and observe FKStreamerDelegate.didUpdateStreamHealth(...).
  • FKStreamer:
    • requestStream becomes createStream.
    • stream in delegate's methods is no more optional since it is actually always known.
    • quality: ability to change the quality for the next created streams.
    • We have replaced the network quality measure with the notion of stream health. Method networkQualityDidUpdate becomes didUpdateStreamHealth. We consider that 70% is the minimum rate for a healthy live stream. Moreover, this value has become more reliable.
    • Objective-C streamer orientation constants are now prefixed with FKStreamerOrientation.
  • FKStream:
    • Query for your app's streams using findAll(...).
    • forceClose() allows to force close a stream in case your User created a stream and you know for sure that User will finally not go live.
    • Objective-C FKStream's streamId becomes id.

Android

Min SDK version is now 19 (was 16).
  • Security: new API auth keys available in your app settings. Use privateKey to initialize the SDK instead of deprecated clientKey and applicationID. This key must remain confidential.
  • Errors: readibility has been improved to help support.
  • Restream: we decided to let you choose the platform to which you want to live stream. You are no longer dependent on our implementation, provide us with the RTMP link and that's it. So FKOutput has been abandonned.
  • Test Bandwidth: start streaming on FKStream.bandwidthTest stream and observe FKStreamer.StreamingCallback.onStreamHealthDidUpdate(...).
  • FKStreamer:
    • requestStream becomes createStream.
    • RequestStreamCallback becomes CreateStreamCallback.
    • onStreamingUpdateAvailable becomes onStreamHealthDidUpdate indicating when camera is freezing on screen because of data congestion and providing a rate for 0 to 1 that indicates how the stream is performing. We consider that 70% is the minimum rate for a healthy live stream.
    • setQuality(FKQuality target) allows to change the quality for the next created streams.
  • FKStream:
    • Query for your app's streams using findAll(...).
    • forceClose() allows to force close a stream in case your User created a stream and you know for sure that User will finally not go live.
  • Bug fix:
    • isStreaming() is now false in onStreamDidStop.
    • getCameraAsync() indeed was not returning the camera in very rare corner case.
    • switchCamera() is now synchoneous so your app can update its UI right after the call.
    • Camera flash availability and turn on/off was not reliable.

01/25/2019 – v1.5.0

iOS

Built with Swift 4.2.1 (Xcode 10.1).
  • Abality to disable video capture while streaming with isVideoCaptureEnabled.
  • Renaming isMicrophoneEnabled into isAudioCaptureEnabled.

Android

  • Abality to disable video capture while streaming with setVideoCaptureEnabled.
  • Renaming setMicrophoneEnabled into setAudioCaptureEnabled.
  • Fix FKPlayer.Callback#onPlayerWillPlay(FKStream, FKError) that used to be called with error null when reaching the end of a live stream.

01/16/2019 – v1.4.0

iOS

Built with Swift 4.2.1 (Xcode 10.1). New: Replace internal use of MPMoviePlayerController (deprecated) with AVPlayerViewController. Implementation changes slightly:
    • FKPlayerDelegate is now set to FKPlayer and no more passed through FKPlayer.play(_:at:).
    • Show or hide native playback controls using FKPlayer.showPlaybackControls().
    • While playing, control programmatically the playback with FKPlayer.pause(),
  • FKPlayer.resume() or FKPlayer.seek(to:).
    • Get the current playback position with FKPlayer.currentTime.
    • ScalingMode becomes FKPlayer.VideoGravity.

Android

FKPlayer refactoring. What's changed:
    • Use play(FKStream stream, long at) to start playing the given stream at a specific time.
    • While playing, use pause() and resume().
    • Call getCurrentPosition() to get the current playback position in time.
    • Call getState() to retrieve the current player state and setCallback(FKPlayer.Callback callback) to track events.
    • Call setPlaybackConstrolsMargins and setPlaybackControlsBackground to customize the playback controls UI.
    • Finally, call release() when the player is no longer required.

11/29/2018 – v1.3.3

iOS

Build with Swift 4.2 (Xcode 10). New:
  • AppStore distribution bug fix.
  • Framework includes bitcode.

11/20/2018 – v1.3.1

iOS

Build with Swift 4.2 (Xcode 10). New: Add FKStreamerDelegate.streamer(_:didBecomeLive:) that notifies as soon as the stream is LIVE on Firekast Servers, meaning the stream is broadcast and VOD is getting recorded.

10/11/2018 – v1.3.0

iOS

Build with Swift 4.2 (Xcode 10). New:
  • Support Swift 4.2
  • FKPlayer supports controlStyle and scaleMode options

01/03/2019 – v1.2.5

Android

  • Returns the player's playback position, in milliseconds.
  • Bug fixes

11/30/2019 – v1.2.4

Android

Add FKPlayerView.Callback#onPlayerStateChanged(boolean playWhenReady, int playbackState) callback to notify of player's state changes.

11/20/2018 – v1.2.3

Android

Add FKStreamer.StreamingCallback#onStreamDidBecomeLive(@NonNull FKStream stream) callback to notify as soon as flagged LIVE on Firekast Servers, meaning the stream is actually live.

11/09/2018 – v1.2.2

iOS

Build with Swift 4.1.2 (Xcode 9.4.1). New: Call capture() on camera to get a snapshot of the camera preview

Android

Add support for emulators (Android Virtual Devices) 🎉. Apps embedding the SDK can run on AVD but note that streaming is only possible for AVD with API 23 and above.

09/27/2018 – v1.2.1

iOS

Build with Swift 4.1.2 (Xcode 9.4.1). Fixes: Optimizes streaming for portrait or orientation

Android

ExoPlayer's PlayerView accessor available in FKPlayerView

09/20/2018 – v1.2.0

iOS

Build with Swift 4.1.2 (Xcode 9.4.1). What's new:
  • Objective-C retro-compatible
  • FKError replaced by NSError for Objective-C retro-compatibility
  • NSError extension method: fk() to convert NSError into FKError

Android

Specify ExoPlayer dependency is not required anymore in dependencies

06/21/2018 – v1.1.2

Android

HTTP request bug fix.

04/20/2019 – v1.1.1

iOS

Built with Swift 4.1 (Xcode 9.3). What's new: Minor fixes

Android

What's new:
  • Fix aspect ratio issue.
  • Fix camera position issue in FKCameraFragment.Builder.
  • Retrieve FKStreamer in FKCamera ready callback.

01/08/2018 – v1.1.0

iOS

Built with Swift 4.0.3 (Xcode 9.2). What's new:
  • 100% documented.
  • Refactoring, Streamer and Player, functions and parameters should be more straight forward.
  • Live stream on **Facebook** and/or **Youtube** and Firekast simultaneous. See LiveStreamingPlatform.
  • Use **camera features** by enabling torch, microphone, choosing your device's camera. See Camera.

Android

What's new:
  • 100% documented.
  • Refactoring, FKStreamer and FKPlayerView, functions and parameters should be more straight forward.
  • Introducing FKStream object with its stream id, state and more.
  • Live stream on **Facebook** and/or **Youtube** and Firekast simultaneous. See FKOutput.
  • Use **camera features** by enabling torch, microphone, choosing your device's camera. See FKCamera.
 

05/24/2017 – V1.0.0

iOS

Built with Swift 3.1 First release of FirekastStreamer and FirekastPlayer to stream and play video with its streamId.

Android

First release.

01/25/2019 – v1.5.0

Built with Swift 4.2.1 (Xcode 10.1).
  • Abality to disable video capture while streaming with isVideoCaptureEnabled.
  • Renaming isMicrophoneEnabled into isAudioCaptureEnabled.