iOS Examples

import PhenixSdk
 
class SomeClass {
  private var currentRendererPlayoutDelayOverride: PhenixDisposable?
  private var currentRenderer: PhenixRenderer?
 
  private func setPlayoutDelayOverrideFor10Seconds() {
    // Previously obtained
    let mediaStream: PhenixMediaStream = ...
 
    self.currentRenderer = mediaStream.createRenderer()
 
    // Override playout delay to 900ms for 10 seconds
    let playoutDelay: TimeInterval = 0.9
 
    self.currentRendererPlayoutDelayOverride = self.currentRenderer?.overridePlayoutDelay(playoutDelay)
 
    DispatchQueue.main.asyncAfter(deadline: .now() + 10) {
      // Dropping the disposable will undo the playout delay override
      self.currentRendererPlayoutDelayOverride = nil
    }
  }
}

import PhenixSdk
 
class SomeClass {
  private var currentRendererPlayoutDelayOverride: PhenixDisposable?
  private var currentRenderer: PhenixRenderer?
 
  private func setPlayoutDelayOverrideFor10Seconds() {
    // Previously obtained
    let subscriber: PhenixExpressSubscriber = ...
 
    self.currentRenderer = subscriber.createRenderer()
 
    // Override playout delay to 900ms for 10 seconds
    let playoutDelay: TimeInterval = 0.9
 
    self.currentRendererPlayoutDelayOverride = self.currentRenderer?.overridePlayoutDelay(playoutDelay)
 
    DispatchQueue.main.asyncAfter(deadline: .now() + 10) {
      // Dropping the disposable will undo the playout delay override
      self.currentRendererPlayoutDelayOverride = nil
    }
  }
}

class SomeClass {
 
    private var pipController: AVPictureInPictureController?
    private var renderer: PhenixRenderer?
    public func subscribeToStream() {
 
        // Subscribe to a stream.
        ...
 
        // After subscription, save the renderer.
        renderer = ...
 
        // The picture-in-picture controller must be initialized on the main dispatch queue.
        DispatchQueue.main.async { [weak self] in
            self?.setupPictureInPictureOverlay()
        }
    }
 
    public func setupPictureInPictureOverlay() {
 
        // Ensure this method is called from the main dispatch queue.
        precondition(Thread.isMainThread, "Picture-in-picture must be initialized from the main thread")
 
        // Showing a Phenix stream in picture-in-picture is supported only starting iOS 15.
        guard #available(iOS 15, *) else {
            return
        }
 
        // Register a callback to update the controller whenever the content source changes.
        renderer?.setPictureInPictureContentSourceChangedCallback { [weak self] pipContentSource in
            guard let self = self else {
                return
            }
 
            // If the current stream does not support picture-in-picture, the content source is nil.
            guard let pipContentSource = pipContentSource else {
                return
            }
 
            // When subscribing to a new stream, the controller of the previous stream can be used by just
            // replacing the existing content source.
            // This allows a seamless transition between two streams in the picture-in-picture overlay.
            if let pipController = pipController {
                pipController.contentSource = pipContentSource
            } else {
                pipController = AVPictureInPictureController(contentSource: pipContentSource)
                pipController?.delegate = ... // Optional: use a delegate to catch picture-in-picture events.
            }
        }
    }
}

    // X and Y must be the coordinates in pixels relative to the surface being rendered.
    let locationInView = // CGPoint obtained from touch event handler
 
 
    // Make relative coordinates using the current renderer.
    let relativeCoordinates = renderer.convertRenderPreviewCoordinatesToSourceCoordinates(locationInView)
 
    // Update the current user media options
    // It is recommended to make a copy of the options. This way, the focus can be reset easily by restoring the previous options.
    let userMediaOptions = // Copy of the currently active options
 
    userMediaOptions.video.capabilityConstraints[PhenixDeviceCapability.autoFocusTarget.rawValue] = [PhenixDeviceConstraint.initWith(relativeCoordinates)]
 
    // Apply the options
    let status = userMediaStream.applyOptions(userMediaOptions)
 
    // Verify the status
    // Setting a focus target can fail for example when:
    //  - The current focus mode does not support setting a focus target.
    //  - The current video capture device does not support setting a focus target (front cameras usually do not support it).
    //  - The coordinates are invalid (e.g. outside of the render surface).
    if (status == .ok) {
 
        // Show a visual indication of where the focus was set.
    }