Advance preparation

Connect the wireless LAN between THETA and the smartphone that runs on the application using this Theta Client.

To instantiate THETA Client

import THETAClient
// Create ThetaRepository object by specifying an IP address
ThetaRepository.Companion.shared.doNewInstance(
  endPoint:"http://<THETA IP ADDRESS>"
) {response, error in
  if let instance = response {
    theta = instance
  }
  if let thetaError = error {
    // handle error
  }
}

• THETA IP ADDRESS

• When downloading images or videos from THETA using URLSession, the connection is plain. Therefore, the connection permission setting to Info.plist is required depending on the destination address (default 192.168.1.1). The following is an example of Info.plist by default. Xcode Signing & Capabilities ->App Transport Security Exception can also be added.

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "<http://www.apple.com/DTDs/PropertyList-1.0.dtd>">
<plist version="1.0">
  <dict>
    <key>NSAppTransportSecurity</key>
    <dict>
      <key>NSAllowsArbitraryLoads</key>
      <false/>
      <key>NSExceptionDomains</key>
      <dict>
        <key>192.168.1.1</key>
        <dict>
          <key>NSIncludesSubdomain</key>
          <false/>
          <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
          <true/>
          <key>NSTemporaryExceptionRequiresForwardSecrecy</key>
          <false/>
        </dict>
      </dict>
    </dict>
  </dict>
</plist>

Shoot still images

First, use ThetaRepository.getPhotoCaptureBuilder() to set the shooting and create the PhotoCapture object.

Task {
  do {
    let photoCapture: PhotoCapture = try await withCheckedThrowingContinuation {continuation in
      PhotoCaptureBuilder()
       .setIsoAutoHighLimit(iso: ThetaRepository.IsoAutoHighLimitEnum.iso1000)
       .setFileFormat(fileFormat: ThetaRepository.PhotoFileFormat.image5k)
       .build {capture, error in
         if let photoCapture = capture {
           continuation.resume(returning: photoCapture)
         }
         if let thetaError = error {
           continuation.resume(throwing: thetaError)
         }
       }
    }
  } catch {
    // catch thetaError
  }
}

The above example sets the maximum ISO sensitivity to 1000 and the file format to image5k.

See View preview for instructions on how to view preview.

Then we call PhotoCapture.takePicture(callback:) to shoot still pictures. Create and call a callback class that implements PhotoCaptureTakePictureCallback as follows.

do {
  class Callback: PhotoCaptureTakePictureCallback {
      let callback: (_ fileUrl: String?, _ error: Error?) -> Void
      init(_ callback: @escaping (_ fileUrl: String?, _ error: Error?) -> Void) {
          self.callback = callback
      }
      func onSuccess(fileUrl: String) {
          callback(fileUrl, nil)
      }
      func onError(exception: ThetaRepository.ThetaRepositoryException) {
          callback(nil, exception as? Error)
      }
  }
  let fileUrl: String = try await withCheckedThrowingContinuation {continuation in
      photoCapture.takePicture(
        callback: Callback {fileUrl, error in
            if let photoUrl = fileUrl {
                continuation.resume(returning: photoUrl)
            }
            if let thetaError = error {
                continuation.resume(throwing: thetaError)
            }
        }
      )
  }
  // send GET request for fileUrl and receive a JPEG file
} catch {
  // catch error while take picture
}

Properties that can be set for shooting still images

• Exposure Compensation: setExposureCompensation(value:ThetaRepository.ExposureCompensationEnum)

• Exposure Delay Setting: setExposureDelay(delay:ThetaRepository.ExposureDelayEnum)

Delay between the takePicture command and the start of exposure (= self-timer).