Advance preparation

• Add following descriptions to the dependencies of your module’s build.gradle.

  implementation "com.ricoh360.thetaclient:theta-client:1.7.1"
  

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

Create an instance of THETA client

When creating an instance, you can set the camera date and time, the language, the shutter volume, the time to sleep, and the time to power off.

• Language setting (ignored by THETA S, THETA SC)
  • “en-US”
  • “en-GB”
  • “ja”
  • “fr”
  • “de”
  • “zh-TW”
  • “zh-CN”
  • “it”
  • “ko”
• Date Adjust
  • YYYY:MM:DD HH:MM:SS+HH:MM format
• Time to enter sleep mode (min)
  • Not Auto Off, 3 min, 5 min, 7 min, 10 min
• Time from sleep to automatic power-off (minutes)
  • Not automatically off, 5 minutes, 10 minutes, 15 minutes, 30 minutes
• Shutter sound
  • 0 ～ 100

import com.ricoh360.pf.theta.ThetaRepository
val thetaUrl = "192.168.1.1:80"
val thetaConfig = ThetaRepository.Config()
// thetaConfig.dateTime = "2023:01:01 12:34:56+09:00" // set current time
// thetaConfig.language = ThetaRepository.LanguageEnum.EN_US
// thetaConfig.shutterVolume = 40 // 0 to 100
// thetaConfig.sleepDelay = ThetaRepository.SleepDelayEnum.SLEEP_DELAY_5M
// thetaConfig.offDelay = ThetaRepository.OffDelayEnum.DISABLE
thetaRepository = ThetaRepository.newInstance(thetaUrl, thetaConfig)

Shoot still images

First, shooting settings are performed using PhotoCapture.Builder to create PhotoCapture objects.

class TakenCallback : PhotoCapture.TakePictureCallback {
	override fun onSuccess(fileUrl: String) {
		// get JPEG file
	}
	override fun onError(exception: ThetaRepository.ThetaRepositoryException) {
		// error processing
	}
}

thetaRepository.getPhotoCaptureBuilder()
	.setExposureProgram(ThetaRepository.ExposureProgramEnum.NORMAL_PROGRAM)
	.setWhiteBalance(ThetaRepository.WhiteBalanceEnum.AUTO)
	.setExposureCompensation(ThetaRepository.ExposureCompensationEnum.ZERO)
	.setIsoAutoHighLimit(ThetaRepository.IsoAutoHighLimitEnum.ISO_800)
	.setFilter(ThetaRepository.FilterEnum.HDR)
	.setExposureDelay(ThetaRepository.ExposureDelayEnum.DELAY_OFF) // self-timer
	.setFileFormat(ThetaRepository.IMAGE_11K)
	.build()
	.takePicture(TakenCallback())

See Display a preview for instructions on how to view preview.

Properties that can be set for shooting still images

• Exposure compensation
  • 2.0, -1.7, -1.3, -1.0, -0.7, -0.3, 0.0, 0.3, 0.7, 1.0, 1.3, 1.7, 2.0
• Self-timer
  • 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
• Resolution