事前準備

• モジュールのbuild.gradleのdependenciesに次を追加します。

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

• THETA Clientを使用したアプリケーションが動作するスマートフォンと THETAを無線 LAN 接続しておきます。

THETA clientのインスタンス作成

インスタンス作成時にカメラの日時設定、言語設定、シャッター音量設定、スリープまでの時間設定、電源オフまでの時間設定を行うこともできます。

• 言語設定(THETA S, THETA SC では指定しても無視される)
  • “en-US”
  • “en-GB”
  • “ja”
  • “fr”
  • “de”
  • “zh-TW”
  • “zh-CN”
  • “it”
  • “ko”
• 日時設定
  • YYYY:MM:DD HH:MM:SS+HH:MM の形式
• スリープモードに入るまでの時間(分)
  • 自動オフしない, 3 分, 5 分, 7 分, 10 分
• スリープから自動電源オフまでの時間(分)
  • 自動オフしない, 5 分, 10 分, 15 分, 30 分
• シャッター音
  • 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)

静止画を撮影する

まずPhotoCapture.Builderを使って撮影設定を行い、PhotoCaptureオブジェクトを生成します。

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())

プレビューを表示する方法はプレビューを表示するをご覧ください。

静止画撮影時に設定できる項目

• 露出補正
  • 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
• セルフタイマー
  • 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
• 解像度