メニュー

Expand
Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Changelog: Twilio Video iOS

The Twilio Programmable Video SDKs use Semantic Versioning. Twilio supports version N-1 for 12 months after the first GA release of version N. We recommend you upgrade to the latest version as soon as possible to avoid any breaking changes. Version 3.x is the latest Video iOS version.

Support for 2.x will cease on October 4th, 2020. This branch will only receive fixes for critical issues until that date. Check this guide when planning your migration to 3.x.

Support for iOS SDK version 1.x ended on April 26, 2019.

The Twilio Programmable Video SDKs use Semantic Versioning.

3.5.0 (July 6, 2020)

改善点

  • Reduced connection times by acquiring IceServers during the initial handshake with Twilio's signaling server rather than sending a request to a different endpoint
  • IceServers are now localized to your Participant's region rather than using Global Low Latency routing
  • The SDK no longer depends on ecs.us1.twilio.com:443

API の変更点

  • The following TVIIceOptions properties are deprecated and setting them has no effect:
    • TVIIceOptions.abortOnIceServersTimeout
    • TVIIceOptions.iceServersTimeout

バグ修正

  • Fixed a bug where IceServers might not be fetched on a dual-stack device where the IPv6 network interface is not reachable. [CSDK-3295]

既知の問題

  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
arm64 4.5 MB 10.8 MB

3.4.1 (June 16, 2020)

バグ修正

  • Fixed the issue where unpublishing and then republishing a TVILocalVideoTrack using VP8 simulcast does not complete. [CSDK-3433]

既知の問題

  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
arm64 4.6 MB 10.8 MB

3.4.0 (June 5, 2020)

機能
Bandwidth Profile

You can now configure how your available downlink bandwidth will be distributed among your subscribed RemoteVideoTracks by using a new optional ConnectOptions parameter bandwidthProfile. For more details and best practices, visit the Network Bandwidth Profile API guide. Here is a brief example:

let videoOptions = VideoBandwidthProfileOptions { builder in
    // Minimum subscribe priority of Dominant Speaker's RemoteVideoTracks
    builder.dominantSpeakerPriority = .high

    // Maximum bandwidth (Kbps) to be allocated to subscribed RemoteVideoTracks
    builder.maxSubscriptionBitrate = 6000

    // Max number of visible RemoteVideoTracks. Other RemoteVideoTracks will be switched off
    builder.maxTracks = 5

    // Subscription mode: collaboration, grid, presentation
    builder.mode = .presentation

    // Configure remote track's render dimensions per track priority
    let renderDimensions = VideoRenderDimensions()

    // Desired render dimensions of RemoteVideoTracks with priority low.
    renderDimensions.low = VideoDimensions(width: 352, height: 288)

    // Desired render dimensions of RemoteVideoTracks with priority standard.
    renderDimensions.standard = VideoDimensions(width: 640, height: 480)

    // Desired render dimensions of RemoteVideoTracks with priority high.
    renderDimensions.high = VideoDimensions(width: 1280, height: 720)

    builder.renderDimensions = renderDimensions

    // Track Switch Off mode: .detected, .predicted, .disabled
    builder.trackSwitchOffMode = .predicted
}
let bandwidthProfileOptions = BandwidthProfileOptions(videoOptions: videoOptions)

// Use bandwidth profile to build the connectOptions
let connectOptions = ConnectOptions(token: accessToken) { builder in
    builder.bandwidthProfileOptions = bandwidthProfileOptions
}

// Connect to a Room with connectOptions
room = TwilioVideoSDK.connect(options: connectOptions, delegate: self)
Track Switch Off

As part of the Bandwidth Profile API, you can now specify the mode to control remote video track switch off behavior. The new Track.SwitchOffMode enum can be specified in the VideoBandwidthProfileOptions class and can be set to one of the following:

  • Track.SwitchOffMode.predicted - In this mode, RemoteVideoTracks are pro-actively switched off when network congestion is predicted by the bandwidth estimation mechanism. This mode is used by default if not specified.
  • Track.SwitchOffMode.detected - In this mode, RemoteVideoTracks are switched off only when network congestion is detected.
  • Track.SwitchOffMode.disabled - In this mode, RemoteVideoTracks will not be switched off. Instead tracks will be adjusted to lower quality.

Track switch off events are provided via two additional callbacks to RemoteParticipantDelegate.

extension ViewController : RemoteParticipantDelegate {
    func remoteParticipantSwitchedOnVideoTrack(participant: RemoteParticipant,
                                               track: RemoteVideoTrack) {}

    func remoteParticipantSwitchedOffVideoTrack(participant: RemoteParticipant,
                                                track: RemoteVideoTrack) {}
}
Track Priority

While publishing a local track, you can now optionally specify it's publish priority.

/*
 * Publish a local track with specified priorities.
 *
 * In addition, local track publications now contain a priority property which reflect the priority of
 * the published track.
 */
let localVideoTrackPublicationOptions = LocalTrackPublicationOptions(priority: .high)
localParticipant.publishVideoTrack(localVideoTrack, publicationOptions: localVideoTrackPublicationOptions);

let localAudioPublicationOptions = LocalTrackPublicationOptions(priority: .high)
localParticipant.publishAudioTrack(localAudioTrack, publicationOptions: localAudioPublicationOptions);

let localDataPublicationOptions = LocalTrackPublicationOptions(priority: .low)
localParticipant.publishDataTrack(localDataTrack, publicationOptions: localDataPublicationOptions);

/*
 * The publish priority is also represented in remote audio, video, and data track publications.
 */
let publishPriority = remoteVideoTrackPublication.publishPriority

Also, the publisher's TrackPriority for the corresponding local Track can be updated after a track has been published.

localVideoTrackPublication.priority = .high

When a TVITrackPriority is updated after the track has been published, remote participants will be alerted to the change via the [TVIRemoteParticipantDelegate remoteParticipant:didChangePublishPriority:forAudioTrack], [TVIRemoteParticipantDelegate remoteParticipant:didChangePublishPriority:forVideoTrack] and [TVIRemoteParticipantDelegate remoteParticipant:didChangePublishPriority:forDataTrack] delegate methods.

extension ViewController : RemoteParticipantDelegate {
    func remoteParticipantDidChangeAudioTrackPublishPriority(participant: RemoteParticipant,
                                                             priority: Track.Priority,
                                                             publication: RemoteAudioTrackPublication) { }

    func remoteParticipantDidChangeVideoTrackPublishPriority(participant: RemoteParticipant,
                                                             priority: Track.Priority,
                                                             publication: RemoteVideoTrackPublication) { }

    func remoteParticipantDidChangeDataTrackPublishPriority(participant: RemoteParticipant,
                                                            priority: Track.Priority,
                                                            publication: RemoteDataTrackPublication) { }
}

Additionally, you can set a subscriber side priority for a TVIRemoteVideoTrack.

/*
 * Set a remote video track priority to HIGH. Note that this feature is only available
 * for RemoteVideoTrack.
 */
remoteVideoTrack.priority = .high

/*
 * Get the current remote video track priority.
 */
let remoteVideoTrackPriority = remoteVideoTrack.priority

This signals to the media server the relative importance of the track with respect to other tracks that may be shared to the Room. The media server takes this into account while allocating a subscribing RemoteParticipant's bandwidth to the corresponding remote track. If you do not specify a priority, the RemoteVideoTrack.priority property will return nil, and the media server will use the RemoteVideoTrackPublication.publishPriority assigned by the publisher instead.

New APIs

  • Added TVITrackPriority for track priorities of Room.
  • Added a new readonly property publishPriority of type TVITrackPriority in TVIRemoteAudioTrackPublication, TVIRemoteVideoTrackPublication, and TVIRemoteDataTrackPublication. These readonly properties fetch the priorities at which the remote Audio, Video, and Data Tracks were published.
  • Added a new class TVILocalTrackPublicationOptions to specify track publication options when publishing tracks via TVILocalParticipant.
  • Added additional publish track methods that allow developers to specify TVILocalTrackPublicationOptions -
  • [TVILocalParticipant publishAudioTrack:publicationOptions:]
  • [TVILocalParticipant publishVideoTrack:publicationOptions:]
  • [TVILocalParticipant publishDataTrack:publicationOptions:]
  • Added a new property priority of type TVITrackPriority in TVILocalAudioTrackPublication, TVILocalVideoTrackPublication and TVILocalDataTrackPublication classes.
  • Added the [TVIRemoteParticipantDelegate remoteParticipant:didChangePublishPriority:forAudioTrack], [TVIRemoteParticipantDelegate remoteParticipant:didChangePublishPriority:forVideoTrack] and [TVIRemoteParticipantDelegate remoteParticipant:didChangePublishPriority:forDataTrack] delegate methods.

バグ修正

  • Fixed a crash when the SDK was processing a local SDP that had incorrect number of SSRCs when applying VP8 simulcast.

既知の問題

  • Unpublishing and then republishing a TVILocalVideoTrack using VP8 simulcast does not complete. As a workaround, disable the Track instead. [CSDK-3433]
  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
arm64 4.6 MB 10.8 MB

3.3.0 (May 29, 2020)

改善点

  • Previously, twilio-video would fail connection attempts if the signaling server was busy with too many requests. Now, it will try again after a server specified backoff period either until it is successfully connected or the server asks it to stop trying. In this case, the -[TVIRoomDelegate room:didFailToConnectWithError:] method is called with TVIErrorSignalingServerBusyError.
func roomDidFailToConnect(room: Room, error: Error) {
    let theError = error as NSError
    if theError.domain == TwilioVideoSDK.ErrorDomain,
        theError.code == TwilioVideoSDK.Error.signalingServerBusyError {
        print("Twilio's signaling server cannot accept connection requests at this time.")
    }
}

API の変更点

  • Added error code definitions:
    • TVIErrorSignalingServerBusyError
    • TVIErrorRoomAccountLimitExceededError
    • TVIErrorParticipantAccountLimitExceededError
    • TVIErrorTrackDataTrackMessageTooLargeError
    • TVIErrorTrackDataTrackSendBufferFullError
    • TVIErrorMediaDtlsTransportFailedError
    • TVIErrorMediaIceRestartNotAllowedError

既知の問題

  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
arm64 4.5 MB 10.7 MB

3.2.5 (April 23, 2020)

Enhancement

  • TVICameraSource now stops the underlying AVCaptureSession during deallocation if the developer had not stopped it using one of the stopCapture methods. It is still suggested that the developer calls one of the stopCapture methods at a time that is appropriate for their application and not relying on the SDK to do it. #445
  • Publish stats reports every 10 seconds and active ICE candidate pair messages every 20 seconds. Previously both were reported every 4 seconds.

既知の問題

  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
arm64 4.5 MB 10.7 MB

3.2.4 (April 17, 2020)

バグ修正

  • Fixed a bug when establishing a signaling WebSocket that might cause only one address family (IPv4 or IPv6) to be tried.
  • Fixed a network handoff bug where where the media was not switching over to low cost network.

既知の問題

  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
arm64 4.5 MB 10.7 MB

3.2.3 (April 1, 2020)

バグ修正

  • Fixed a potential crash when destroying a TVILocalVideoTrack while the Track's TVICameraSource (or custom TVIVideoSource) is still delivering frames. [ISDK-2792]

既知の問題

  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
arm64 4.5 MB 10.6 MB

3.2.2 (February 21, 2020)

バグ修正

  • Fixed the issue where the NS_SWIFT_NAME mapping for CameraSourceOptionsBuilder.Block would fail. #72

既知の問題

  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
arm64 4.5 MB 10.6 MB

3.2.1 (February 10, 2020)

バグ修正

  • Fixed parsing issue when a Remote Participant's Network Quality Level is zero. [CSDK-3325]

既知の問題

  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
arm64 4.5 MB 10.6 MB

3.2.0 (February 5, 2020)

API の変更点

  • Implemented Network Quality for Remote Participants in Group Rooms:
    • To enable the Network Quality functionality, set the TVIConnectOptions.networkQualityEnabled property to YES when connecting to a Group Room. By default this enables network quality level changes to be reported for the Local Participant. To also receive network quality level changes for the Remote Participants, a configured TVINetworkQualityConfiguration object needs to be supplied to the TVIConnectOptions.networkQualityConfiguration property.
    • The networkQualityLevel property has been promoted from the TVILocalParticipant class to the TVIParticipant base class.
    • To determine the current network quality level for both Local and Remote Participants, query the networkQualityLevel property. Note, this will return TVINetworkQualityLevelUnknown if:
      • The TVIConnectOptions.networkQualityEnabled property was set to NO OR
      • Using a Peer-to-Peer room OR
      • The network quality level has not yet been computed
    • Implementing the [TVILocalParticipantDelegate localParticipant:networkQualityLevelDidChange:] method on your TVILocalParticipantDelegate will allow you to receive callbacks when the network quality level changes for the Local Participant.
    • Implementing the [TVIRemoteParticipantDelegate remoteParticipant:networkQualityLevelDidChange:] method on your TVIRemoteParticipantDelegate will allow you to receive callbacks when the network quality level changes for the Remote Participant.
@IBAction func connectToRoom(sender: AnyObject) {
    let connectOptions = ConnectOptions(token: accessToken) { (builder) in
        builder.isNetworkQualityEnabled = true
        builder.networkQualityConfiguration = NetworkQualityConfiguration(localVerbosity: .minimal,
                                                                          remoteVerbosity: .minimal)
        builder.roomName = "my-room"
    }

    room = TwilioVideoSDK.connect(options: connectOptions, delegate: self)
}

...

// MARK: LocalParticipantDelegate
func localParticipantNetworkQualityLevelDidChange(participant: LocalParticipant, networkQualityLevel: NetworkQualityLevel) {
    print("Local Participant Network Quality Level Changed: \(networkQualityLevel)")
}

// MARK: RemoteParticipantDelegate
func remoteParticipantNetworkQualityLevelDidChange(participant: RemoteParticipant, networkQualityLevel: NetworkQualityLevel) {
    print("Remote Participant (\(participant.identity)) Network Quality Level Changed: \(networkQualityLevel)")
}

改善点

  • Reduced bandwidth usage for Insights reporting by up to 75%.
  • Data track per-message size limit has been increased to 64 KB. [CSDK-3197]

バグ修正

  • Fixed intermittent crash when sending data on a data track while in the process of closing the track due to remote participant disconnect. [CSDK-3245]
  • TVIIceCandidatePairStats.availableOutgoingBitrate is populated with the available send bandwidth when publishing Tracks.
  • TVIIceCandidatePairStats.availableIncomingBitrate is populated with the available receive bandwidth when subscribing to Tracks in a Group Room.
  • Fixed a crash which could occur when destroying a TVIRoom while the TCP handshake for the signaling connection is in progress.

既知の問題

  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
arm64 4.5 MB 10.6 MB

3.1.0 (December 17, 2019)

改善点

  • Reduced memory allocations when cropping is applied with -[TVIVideoSource requestOutputFormat:] by caching the cropping attributes.
  • Added TVICameraSourceOptions.rotationTags, which defaults to TVICameraSourceOptionsRotationTagsKeep. You might want to set this option to TVICameraSourceOptionsRotationTagsRemove in order to:
    • Save power and battery life when you know that the video will be published in a Group Room
    • Receive images that are properly oriented for Computer Vision analysis
    • Use AVAssetWriter for recordings without worrying about transformation matrices
  • Performance Improvements:
    • With TVICameraSourceOptionsRotationTagsRemove, we see significant improvement with the H.264 video codec on modern iPhones.
    • With TVICameraSourceOptionsRotationTagsRemove, we see small improvement with the VP8 video codec (non-simulcast) on modern iPhones.
Codec TVICameraSourceOptionsRotationTagsKeep (Average CPU) (*) TVICameraSourceOptionsRotationTagsRemove (Average CPU) (*)
H.264 7.3% 6.75% (**)
VP8 12.8% 12.7% (**)
* Tested on iPhone 11
* Group Room
* Capture resolution, fps, encoding params: 640x480x30 @ 1200 kbps
* Video call duration: 5 mins / run
* Measured using Instruments
** Load scheduled mostly on high efficiency cores, with performance cores disabled.

既知の問題

  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
arm64 4.5 MB 10.7 MB

3.0.1 (November 5, 2019)

バグ修正

  • Fixed a possible deadlock that could occur when destroying a TVIRoom without first calling -[TVIRoom disconnect].
  • Fixed a crash which could occur when destroying a TVIRoom with dominant speaker enabled.

既知の問題

  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
arm64 4.5 MB 10.7 MB

3.0.0 (October 4, 2019)

3.0 is now generally available. Thank you for all the feedback from our beta adopters.

This release includes:

  • Global low latency (GLL) signaling with IPv4 and IPv6 support.
  • Improved Swift APIs for a more idiomatic Swift development experience.
  • Support for UIScene and multi-window apps on iOS 13 and iPadOS 13.

バグ修正

  • Fixed a regression in 3.0.0-beta5 and 3.0.0-beta6 where the Participant's TLS handshake might be delayed by up to 250 milliseconds. [CSDK-3117]

既知の問題

  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
arm64 4.5 MB 10.7 MB

3.0.0-beta6 (September 30, 2019)

This release completes the API changes needed for Twilio Video to be fully compatible with the iOS 13.0 and iPadOS 13.0 SDKs. This release also removes support for iOS 10. Twilio Video 2.x will continue to support iOS 9.0 and later.

API の変更点

  • The minimum supported iOS version has been raised to 11.0.
  • TVICameraSource can monitor UIWindowScene for orientation and state changes in iOS 13.0+.
  • Removed manual orientation control APIs from TVICameraSource and introduced the TVICameraSourceOrientationTracker protocol along with the TVIUserInterfaceTracker class.
  • The following example demonstrates how to track a UIWindowScene:
// Track the orientation of the key window's scene.
let options = CameraSourceOptions { (builder) in
    if let keyScene = UIApplication.shared.keyWindow?.windowScene {
        builder.orientationTracker = UserInterfaceTracker(scene: keyScene)
    }
}
let camera  = CameraSource(options: options, delegate: self)
// Forward UIWindowScene events
func windowScene(_ windowScene: UIWindowScene,
                 didUpdate previousCoordinateSpace: UICoordinateSpace,
                 interfaceOrientation previousInterfaceOrientation: UIInterfaceOrientation,
                 traitCollection previousTraitCollection: UITraitCollection) {
    UserInterfaceTracker.sceneInterfaceOrientationDidChange(windowScene)
}

既知の問題

  • The Participant's TLS handshake might be delayed by up to 250 milliseconds. [CSDK-3117]
  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
arm64 4.5 MB 10.7 MB

3.0.0-beta5 (September 25, 2019)

API の変更点

  • Added TVILocalParticipant.signalingRegion. You can use this property to determine where your Participant connected to a Room, especially when using the default value of "gll" for TVIConnectOptions.region.
  • Added TVIRoom.mediaRegion. You can use this property to determine where media is being processed in a Group Room.
  • Updated the TVIConnectOptionsBuilder.region property to no longer throw an exception when an empty string is provided and instead default to gll.
  • When a Participant connects to a Room, the WebSocket handshake is required to complete in 15 seconds or less, otherwise TVIErrorSignalingConnectionError is raised.
  • TVIEncodingParameters now expresses maximum bitrates in Kilobits per second (Kbps) instead of bits per second (bps).
// Before
let params = EncodingParameters(audioBitrate: UInt(64000),
                                videoBitrate: UInt(800000)
// After
let params = EncodingParameters(audioBitrate: UInt(64),
                                videoBitrate: UInt(800)

改善点

  • The iOS SDK is built with Xcode 11.0
  • TVIVideoView registers for UIScene lifecycle notifications when it is contained within a UIWindowScene on iOS 13.0+. Rendering is permitted in the following states:
    • UISceneActivationStateForegroundActive at 60 Hz
    • UISceneActivationStateForegroundInactive at 30 Hz
  • TVIVideoView suspends its internal CADisplayLink timer when it is removed from a UIWindow.
  • Increased the reliability of TVILocalDataTrack by monitoring its send buffer. Sending too many messages, or sending single messages larger than 16 KB no longer causes the underlying channel(s) to close. These requests are ignored instead. [CSDK-3037]

バグ修正

  • Fixed a bug where TVICameraSource might produce distorted frames after being interrupted with AVCaptureSessionInterruptionReasonVideoDeviceInUseByAnotherClient on iOS 13.0. #53
  • Making the SDK more aggressive at establishing a connection by trying to connect multiple sockets to different endpoints in parallel. [CSDK-2942]
  • TVILocalDataTrack should no longer end up in an inconsistent state after attempting to send a message larger than 16 KB. [CSDK-3081]

既知の問題

  • The Participant's TLS handshake might be delayed by up to 250 milliseconds. [CSDK-3117]
  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
Universal 9.5 MB 20.5 MB
arm64 4.6 MB 10.8 MB
armv7 4.9 MB 9.7 MB

3.0.0-beta4 (September 6, 2019)

API の変更点

  • Introduced TVIErrorSignalingDnsResolutionError, which is now raised instead of TVIErrorSignalingConnectionError in the following scenarios:
    • The device has misconfigured DNS Server(s) on its active network interface.
    • The region provided in TVIConnectOptions was invalid.
    • The device lost its Internet connection before the query could complete.

改善点

  • Reduced connection times by removing a round trip when:
    • Reconnecting after a signaling connection failure
    • Connecting with TVIConnectOptions.iceOptions, and overridden Servers
    • Connecting with default ICE servers (us1 only)
    • [CSDK-2902]

バグ修正

  • Fixed a bug where Participants remain connected to a Room even after terminal media failures. [CSDK-3023]
  • Fixed a crash when Network Quality or Dominant Speaker is enabled, connectivity to the Room is lost, and the Room is deleted from within TVIRoomDelegate.roomDidDisconnect(). [CSDK-2950]
  • Fixed a bug where resources might be leaked when destroying a Room. [CSDK-2822]
  • Fixed a bug where network monitoring would continue on closed connections in a Peer-to-Peer Room. [CSDK-2947]
  • Fixed a crash on the iOS 13 simulator when rendering received H.264 video, or any other video in the TVIPixelFormatYUV420BiPlanarFullRange or TVIPixelFormatYUV420BiPlanarVideoRange formats. [ISDK-2631]

既知の問題

  • In rare cases, the SDK might timeout during a TCP handshake and should be more aggressive at establishing a connection. [CSDK-2942]
  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
Universal 9.4 MB 21.0 MB
arm64 4.4 MB 11.2 MB
armv7 4.8 MB 9.5 MB

3.0.0-beta3 (August 5, 2019)

改善点

  • The Participant's signaling connection now conforms to Twilio's TLS & Cipher Suite Security Policy. Support for TLS versions older than 1.2 has been removed. [CSDK-3020]
  • Adjusted the buffer sizes used for signaling messages to reduce network fragmentation. [CSDK-2920]
  • Setting TVILogModuleSignaling enables logging of low level connection events at TVILogLevelTrace. [ISDK-2446]

バグ修正

  • WebSocket errors are handled immediately, rather than waiting for a timeout to occur. [CSDK-3025]
  • Handle rare exceptions when constructing a WebSocket. [CSDK-2755]

既知の問題

  • Future 3.0.0-beta releases will reduce the number of round-trips required to connect to a Room. [CSDK-2902]
  • In rare cases, the SDK might timeout during a TCP handshake and should be more aggressive at establishing a connection. [CSDK-2942]
  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
Universal 9.4 MB 21.0 MB
arm64 4.4 MB 11.2 MB
armv7 4.8 MB 9.5 MB

3.0.0-beta2 (July 16, 2019)

API の変更点

  • Renamed + [TwilioVideoSDK version] to + [TwilioVideoSDK sdkVersion] to alleviate the clash with NSObject's version method.
  • Removed the type argument label for the Swift definition of [TVICameraSource captureDeviceForPosition:type]. In Swift, the function is now declared as class func captureDevice(position: AVCaptureDevice.Position, deviceType: AVCaptureDevice.DeviceType) -> AVCaptureDevice?.
  • Updated the Swift audio sample rate constant names to remove the redundant Audio. For instance AudioFormat.AudioSampleRate8000 is now AudioFormat.SampleRate8000.
  • Updated the Swift audio format channels constant names to remove the redundant Audio. For instance AudioFormat.AudioChannelsMono is now AudioFormat.ChannelsMono.
  • Refactored the TVILocalParticipantDelegate and TVIRemoteParticipantDelegate methods to follow the did naming convention for consistency with the other delegate methods. See the Migrating from 2.x to 3.x guide for more information.

バグ修正

  • The SDK will consistently recover the Participant's connection after multiple failed network handovers, or multiple failures on a single network. [CSDK-2957, CSDK-3007]
  • Failures in the Participant's connection are always detected within 15 seconds. [CSDK-2927]
  • Improved DNS retry logic and error handling. [CSDK-2801]
  • Disabled server side deflate compression due to occasional errors when reading messages. [CSDK-3004]
  • Security improvements. [CSDK-2986, CSDK-3005]

既知の問題

  • Future 3.0.0-beta releases will reduce the number of round-trips required to connect to a Room. [CSDK-2902]
  • Setting TVILogModuleSignaling does not produce any logging. [ISDK-2446]
  • In rare cases, the SDK might timeout during a TCP handshake and should be more aggressive at establishing a connection. [CSDK-2942]
  • If a WebSocket error occurs, it might not be handled for up to 15 seconds. [CSDK-3025]
  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
Universal 9.4 MB 20.9 MB
arm64 4.4 MB 11.1 MB
armv7 4.7 MB 9.5 MB

3.0.0-beta1 (June 6, 2019)

The 3.0 release removes support for iOS 9.0, and raises the minimum supported iOS version to 10.0. Twilio Video 2.x releases will continue to support iOS 9.0 and later.

改善点

  • The SDK uses a new WebSocket based signaling transport, and communicates with globally available signaling Servers over IPv4 and IPv6 networks.
  • Added the TVIConnectOptions.region property. By default, the Client will connect to the nearest signaling Server determined by latency based routing. Setting a value other than "gll" bypasses routing and guarantees that signaling traffic will be terminated in the region that you prefer.
let connectOptions = ConnectOptions(token: accessToken) { (builder) in
    builder.region = "us1"
    builder.roomName = "my-room"
}
self.room = TwilioVideoSDK.connect(with: connectOptions, delegate: self)
  • Participants are considered to be reconnecting within 15 seconds, and are disconnected from a Room after 45 seconds of lost connectivity. #99

API の変更点

  • Twilio Video has been updated for better Swift interoperability. See the Migrating from 2.x to 3.x guide for more information.
    • The TwilioVideo Obj-C class has been renamed to TwilioVideoSDK to reduce possible namespace issues in Swift due to the Module containing a Type with the same name.
    • The TVI prefix has been removed from all Twilio Video types
    • Many of the delegate function declarations have been revamped for better clarity of their intent
    • Some of the class method declarations have been revamped for better clarity of their intent
  • The TVIAudioSessionActivated() and TVIAudioSessionDeactivated() methods have been removed as the Video SDK no longer needs to terminate the signaling connection when an app is backgrounded.
  • Removed the deprecated TVIVideoCapturer APIs:
    • TVIVideoCapturer
    • TVICameraCapturer
    • TVIScreenCapturer
    • TVIVideoConstraints
    • TVILocalVideoTrack.capturer
    • TVILocalVideoTrack.constraints
    • TVILocalVideoTrack.trackWithCapturer:
    • TVILocalVideoTrack.trackWithCapturer:enabled:constraints:name:
  • Removed TVIAudioOptions that are no longer supported by WebRTC:
    • TVIAudioOptions.levelControl
    • TVIAudioOptions.levelControlInitialPeakLevelDBFS
    • TVIAudioOptionsBuilder.levelControl
    • TVIAudioOptionsBuilder.levelControlInitialPeakLevelDBFS
  • Removed the TVIVideoRenderer.optionalPixelFormats property due to lack of use. A TVIVideoRenderer is expected to support any valid TVIPixelFormat or drop incoming frames if it can't process them.

バグ修正

  • Participants can send and receive messages that are larger than 16 KB.
  • Renamed kDefaultAVAudioSessionConfigurationBlock to kTVIDefaultAVAudioSessionConfigurationBlock so that TwilioVoice.framework and TwilioVideo.framework may be used in the same application.
  • Fixed a crash that could occur when using a TVIVideoSource, and the source's buffer pool becomes empty.

既知の問題

  • Future 3.0.0-beta releases will reduce the number of round-trips required to connect to a Room. [CSDK-2902]
  • If heartbeats are not received, the signaling connection may take up to 45 seconds to be disconnected instead of 15 seconds. [CSDK-2927]
  • The SDK may crash if Network Quality or Dominant Speaker is enabled, and connectivity to the Room is lost, and the Room is deleted from within [TVORoomDelegate didDisconnectWithError:]. [CSDK-2950]
  • Setting TVILogModuleSignaling does not produce any logging. [ISDK-2446]
  • In rare cases, the SDK might timeout during a TCP handshake and should be more aggressive at establishing a connection. [CSDK-2942]
  • The WebSocket might close with a partial_deflate_block (code 5) error. [CSDK-2949]
  • Unpublishing and republishing a TVILocalAudioTrack or TVILocalVideoTrack might not be seen by Participants. #34
  • Pre iPhone X iOS devices do not support more than three H.264 encoders. Refer to #17 for suggested work arounds.
  • Publishing H.264 video at greater than 1280x720 @ 30fps is not supported. If a failure occurs then no error is raised to the developer. [ISDK-1590]

Size Impact

アーキテクチャ Compressed Size Uncompressed Size
Universal 8.9 MB 19.3 MB
arm64 4.2 MB 10.3 MB
armv7 4.5 MB 8.7 MB
Rate this page:

ヘルプが必要ですか?

誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。