Yaygın Kullanım Senaryoları

9 dakika okuma

Genel Bakış #

Bu sayfada, Chaos Cloud İstemci Uygulaması ile sıkça kullanılan bazı senaryolar için komut satırı örnekleri sunulmaktadır.

Yetki #

İlk oturum açma işleminden sonra istemci, gelecekteki oturumlar için kullanılacak şifrelenmiş bir oturum açma belirteci önbelleğe alır. Şu anda bu belirteçler otomatik olarak sona ermez. Dosya, her işletim sisteminde aşağıdaki konumlara kaydedilir:

İşletim sistemi	Kimlik doğrulama dosyasının konumu

İşletim sistemi	Kimlik doğrulama dosyasının konumu
Windows	%APPDATA%\ccloud\auth
macOS	${HOME}/Library/Application Support/Chaos/ccloud/auth
Linux	${HOME}/.local/share/ccloud/auth

Token’ı başka bir makinede yeniden kullanmak için dosyayı o işletim sistemi için uygun konuma kopyalayın veya VCLOUD_CLIENT_AUTH_TOKEN_PATH’ı istediğiniz konuma ayarlayın.

Örneğin, Windows’ta, kimlik doğrulama dosyasının C:\ccloud dizinine kopyalandığını varsayarsak :

> set VCLOUD_CLIENT_AUTH_TOKEN_PATH=”C:\\ccloud\\auth”
:: No manual authentication needed now:
> ccloud job submit –sceneFile=”some_scene.vrscene”

Linux ve macOS için, dosyanın /home/<kullanıcı>/ccloud dizinine kopyalandığını varsayarsak :

$ export VCLOUD_CLIENT_AUTH_TOKEN_PATH=”$HOME/ccloud/auth”
# No manual authentication needed now:
$ ccloud job submit –sceneFile=”scene.vrscene”
# Or, for a single invocation:
$ VCLOUD_CLIENT_AUTH_TOKEN_PATH=”$HOME/ccloud/auth” ccloud job submit –sceneFile=”scene.vrscene”

İş başvuruları gönderme #

ccloud çıktısının ayrıştırılmasını kolaylaştıran –json bayrağının eklenmesiyle ilgili örnek :

$ ccloud –json job submit –sceneFile scene.vrscene –project test_project

{“status”:”success”,”type”:”analyze step”}
{“status”:”success”,”type”:”validate step”}
{“type”:”progress”,”progress”:0}
{“type”:”progress”,”progress”:15}
{“type”:”progress”,”progress”:34}
{“type”:”progress”,”progress”:100}
{“jobID”:”DEll0jabB7AOoTc0″,”jobURL”:”http://localhost:9090/jobs/DEll0jabB7AOoTc0″,”message”:”Scene uploaded successfully. Job ID: DEll0jabB7AOoTc0\
Check the rendering progress on http://localhost:9090/jobs/DEll0jabB7AOoTc0″,”type”:”output”}

–json bayrağının iş gönderiminden önce kullanılması gerektiğini unutmayın .

Gönder-Bekle-İndir #

`job submit` komutunun `–downloadOutput` bayrağı, bir dizi sahneyi gönderir, bunların işlenmesinin tamamlanmasını bekler ve ardından çıktıları indirir. Hem `sceneFile` hem de `batchFile` ile çalışır.

Render işleminin bitmesini beklerken bir ilerleme çubuğu gösterilir. Render işlemi tamamlandığında, çıktı –downloadOutput bayrağıyla belirtilen dizine indirilir .

$ ccloud –json job submit –sceneFile /drive/scenes/toyota-chr/toyota-chr.vrscene –downloadOutput /drive/download/download-scenes/

{“status”:”success”,”type”:”analyze step”}
{“status”:”success”,”type”:”validate step”}
{“jobID”:”IwuTUGmU6ydVBVyD”,”jobName”:”toyota-chr”,”jobURL”:”https://cloud.chaos.com/jobs/IwuTUGmU6ydVBVyD”,”message”:”Job created.”,”type”:”output”}
{“message”:”Uploading started.”,”type”:”info”,”uploadSize”:”0.00B”}
{“type”:”progress”,”progress”:100}
{“jobID”:”IwuTUGmU6ydVBVyD”,”jobURL”:”https://cloud.chaos.com/jobs/IwuTUGmU6ydVBVyD”,”message”:”Scene uploaded successfully. Job ID: IwuTUGmU6ydVBVyD\
Check the rendering progress on https://cloud.chaos.com/jobs/IwuTUGmU6ydVBVyD”,”type”:”output”}
{“type”:”progress”,”progress”:0}
{“type”:”progress”,”progress”:5}
{“type”:”progress”,”progress”:6}
{“type”:”progress”,”progress”:20}
{“type”:”progress”,”progress”:42}
{“type”:”progress”,”progress”:79}
{“type”:”progress”,”progress”:99}
{“type”:”progress”,”progress”:100}
{“message”:”job IwuTUGmU6ydVBVyD is completed”,”jobId”:”IwuTUGmU6ydVBVyD”,”state”:”completed”,”type”:”output”}
{“message”:”Rendering finished, downloading outputs…”,”type”:”output”}
{“message”:”Downloading output for job ‘IwuTUGmU6ydVBVyD’ (586.72KB)”,”sizeString”:”586.72KB”,”type”:”output”}
{“type”:”progress”,”progress”:0}
{“type”:”progress”,”progress”:59}
{“type”:”progress”,”progress”:60}
{“type”:”progress”,”progress”:100}
{“type”:”progress”,”progress”:100}
{“message”:”downloaded output of job IwuTUGmU6ydVBVyD successfully”,”type”:”output”}

Yalnızca Tamamlanmamış Kareleri Klonla #

`job resubmit` komutunun ` –onlyUncompleted` bayrağı , bir işten yalnızca tamamlanmamış (başarısız, iptal edilmiş veya duraklatılmış) kareleri kopyalar.

$ ccloud –json job resubmit –id=”IbJD218cTrXcO1Ps” –onlyUncompleted

{“message”:”Job Ixd3TAudUv5eWBgb is started successfully from IbJD218cTrXcO1Ps”,”newJobID”:”Ixd3TAudUv5eWBgb”,”type”:”output”}

Durum Kontrolü #

Tamamlanan İş #

$ ccloud –json job status –id DEll0jabB7AOoTc0

{“jobID”:”DEll0jabB7AOoTc0″,”message”:”job DEll0jabB7AOoTc0 is completed”,”state”:”completed”,”type”:”output”}

Aktif İş #

$ ccloud –json job status –id DElti15NpajRV9K0

{“jobID”:”DElti15NpajRV9K0″,”message”:”job DElti15NpajRV9K0 is active (0%)”,”progress”:”0%”,”state”:”active”,”type”:”output”}

Başarısız İş #

$ ccloud –json job status –id DElti15NpajRV9K0

{“jobID”:”DElti15NpajRV9K0″,”message”:”job DElti15NpajRV9K0 is failed”,”state”:”failed”,”type”:”output”}

Tamamlanmamış Kareler #

$ ccloud job status –id=”IxZdIu9mWqlQRsQn”

{“message”:”job IxZdIu9mWqlQRsQn is paused, not all frames were completed.”,”jobId”:”IxZdIu9mWqlQRsQn”,”frames”:[{“state”:”paused”,”frameRange”:”1-100″}],”state”:”paused”,”type”:”output”}

Tamamlanmış İşlerin İndirilmesi #

$ ccloud –json job download –id DEll0jabB7AOoTc0 –output “$HOME/Downloads”

{“type”:”progress”,”progress”:0}
{“type”:”progress”,”progress”:11}
{“type”:”progress”,”progress”:100}
{“message”:”downloaded output of job DEll0jabB7AOoTc0 successfully”,”type”:”output”}

Web kancaları #

Chaos Cloud şu anda WebHook’lar aracılığıyla bildirimleri desteklememektedir. Bu süre zarfında, entegratörler, ccloud iş durumunu periyodik olarak kullanan ve kendi web kancalarını çağıran kendi bileşenlerini yazarak kendi web kancalarını uygulayabilirler.

Sürüm Kontrolü ve Güncelleme #

Güncellemeler kontrol ediliyor (güncelleme mevcut) #

$ ccloud –json version check

{“isDeprecated”:”no”,”message”:”New version 1.5.0 available.”,”newVersion”:”1.5.0″,”type”:”output”}

Güncellemeler kontrol ediliyor (istemci zaten güncel) #

$ ccloud –json version check

{“isDeprecated”:”no”,”message”:”The Chaos Cloud Client is up to date.”,”type”:”output”}

Güncellemeler kontrol ediliyor (istemci sürümü kullanımdan kaldırıldı ve güncellenmesi gerekiyor) #

$ ccloud –json version check

{“error”:”ccloud: Cannot continue execution.\
Update by executing the following command:\
\
\
tccloud update\
\
If the problem persists, please contact support@chaos.com”,”isDeprecat
ed”:”yes”,”type”:”error”}

Güncelleniyor (yeni sürüm mevcut) #

$ ccloud –json update

{“type”:”progress”,”progress”:0}
{“type”:”progress”,”progress”:10}
{“type”:”progress”,”progress”:50}
{“type”:”progress”,”progress”:80}
{“type”:”progress”,”progress”:100}
{“message”:”application updated successfully to version 1.5.0″,”newVersion”:”1.5.0″,”type”:”output”,”updated”:”yes”}

Güncelleniyor (zaten güncel) #

$ ccloud –json update

{“message”:”The Chaos Cloud Client is up to date.”,”type”:”output”,”updated”:”no”}

ccloud web sunucusunu belirtilen portta başlatın. #

–port global bayrağını (job ve version gibi alt komutlardan önce) kullanın .

$ ccloud –json –port 8080 job submit –sceneFile scene.vrscene –project test_project

Sadece Yükle #

Yalnızca Yükleme özelliğini kullanarak, normal iş akışının aksine, başlangıçta duraklatılmış ve daha sonra manuel olarak başlatılabilen bir iş gönderebilirsiniz; normal iş akışında ise iş yüklendikten hemen sonra başlatılır.

$ ccloud –json job submit –sceneFile scene.vrscene –onlyUpload

{“status”:”success”,”type”:”analyze step”}
{“status”:”success”,”type”:”validate step”}
{“type”:”progress”,”progress”:100}
{“jobID”:”GpW90CIoB5BU3Fvz”,”jobURL”:”https://cloud.chaos.com/jobs/GpW77CIoB5BU3Fvz”,”message”:”Scene uploaded successfully. Job ID: GpW77CIoB5BU3Fvz\
Check the rendering progress on https://cloud.chaos.com/jobs/GpW77CIoB5BU3Fvz”,”type”:”output”}

Toplu Gönderim #

Birden fazla sahneyi aynı anda render işlemine göndermek için toplu işlem dosyası kullanın.

$ ccloud –json job submit –batchFile path/to/file.json

Toplu işlem dosyası JSON sözdizimini kullanır ve kök anahtarlarda ayarlanan tüm seçeneklerin tüm sahnelere uygulandığı bir nesneyi temsil eder. Gerçek sahneler, ‘scenes’ anahtarı altında bir nesne dizisi olarak tanımlanır. Örnek:

{
“project”: “test”,
“layers”: true,
“scenes”: [
{
“path”: “adaptive_lights/scene.vrscene”,
“name”: “adaptive”,
“creditLimit”: 2,
“onlyUpload”: true
},
{
“path”: “loft_bedroom/scene.vrscene”,
“name”: “loft”,
“width”: 640,
“height”: 480,
“onlyCPU”: true
},
{
“path”: “texture_maps/scene.vrscene”
}
]
}

Toplu gönderimden elde edilen JSON çıktısı:

{“status”:”success”,”type”:”analyze step”}
{“status”:”success”,”type”:”validate step”}
{“type”:”progress”,”progress”:100}
{“type”:”progress”,”progress”:100}
{“type”:”progress”,”progress”:0}
{“type”:”progress”,”progress”:4}
{“type”:”progress”,”progress”:100}
{“jobID”:”Gpkok2L6mkA2bqn5″,”jobURL”:”https://cloud.chaos.com/jobs/Gpkuk2L6mkA2bqn5″,”message”:”Scene uploaded successfully. Job ID: Gpkuk2L6mkA2bqn5\
Check the rendering progress on https://cloud.chaos.com/jobs/Gpkuk2L6mkA2bqn5″,”type”:”output”}
{“jobID”:”Gpkon_Ht7WI1Ur_4″,”jobURL”:”https://cloud.chaos.com/jobs/Gpkon_Ht7WI1Ur_4″,”message”:”Scene uploaded successfully. Job ID: Gpkon_Ht7WI1Ur_4\
Check the rendering progress on https://cloud.chaos.com/jobs/Gpkon_Ht7WI1Ur_4″,”type”:”output”}
{“jobID”:”Gpkoq5y0LFrgsAZ9″,”jobURL”:”https://cloud.chaos.com/jobs/Gpkoq5y0LFrgsAZ9″,”message”:”Scene uploaded successfully. Job ID: Gpkoq5y0LFrgsAZ9\
Check the rendering progress on https://cloud.chaos.com/jobs/Gpkoq5y0LFrgsAZ9″,”type”:”output”}

Kök anahtar seçenekleri #

Anahtar	Tanım

Anahtar	Tanım
proje (dize, gerekli)	Çekilen tüm sahnelerin gönderildiği projenin adı.
katmanlar (mantıksal)	Toplu işlemdeki farklı sahnelerin aynı sahnenin farklı katmanları olup olmadığını belirtir. Varsayılan değer “false”tur.
görüşler (bool)	Toplu işlemdeki sahnelerin aynı sahnenin farklı görünümleri olup olmadığını belirtir. Varsayılan değer “false”tur.
meta (dize dizisi)	Gönderilen sahneler sonucunda oluşan işlerin meta verilerine eklenen anahtar-değer çiftlerinin listesi. Dizeler key=value biçiminde olmalıdır.
sahneler (dizi, gerekli)	Buluta yüklenecek bir sahneyi tanımlayan nesnelerin listesi. Sahne nesnesinin tanımı için aşağıya bakın.

Örnekte gösterildiği gibi, her sahne kendi başına bir nesne olarak temsil edilir ve bunlar içindeki olası anahtarlardır:

Anahtar	Tanım

Anahtar	Tanım
yol (dize, gerekli)	.vrscene uzantılı dosyanın yolunu belirtir.
renkDüzeltmeDosyası (dize)	Renk düzeltme dosyasına giden yolu belirtir.
çerçeveAralığı (dize)	Animasyon için bir kare aralığı tanımlar. Yalnızca sahne gerçekten bir animasyon ise anlam ifade eder.
çerçeveAdım (tamsayı)	Animasyon için bir kare adımı tanımlar (varsayılan 1). Yalnızca sahne gerçekten bir animasyon ise anlamlıdır.
yükseklik (int)	Oluşturulan görüntünün yüksekliğini tanımlar.
genişlik (tamsayı)	Oluşturulan görüntünün genişliğini tanımlar.
ad (dize)	Oluşturma işlemi için bir ad belirtir.
yalnızca CPU (mantıksal)	Yalnızca CPU kullanarak render işlemi gerçekleştirin. GPU sahneleri için geçerlidir.
yalnızcaYükle (mantıksal)	Sahneyi yükleyin ve işlemi duraklatılmış durumda bırakın.

Çoklu Kamera Gönderimi #

Sahnede birden fazla kamera varsa, –allCameras bayrağını kullanarak tüm kameraların görüntülerini işleme için gönderebilirsiniz :

$ ccloud job –json submit –sceneFile still.vrscene –allCameras

Sonuç şu şekildedir:

{“status”:”success”,”type”:”analyze step”}
{“status”:”success”,”type”:”validate step”}
{“type”:”progress”,”progress”:0}
{“type”:”progress”,”progress”:100}
{“jobID”:”Gpk1UxX0tMdX7d-S”,”jobURL”:”https://cloud.chaos.com/jobs/Gpk1UxX0tMdX7d-S”,”message”:”Scene uploaded successfully. Job ID: Gpk1UxX0tMdX7d-S\
Check the rendering progress on https://cloud.chaos.com/jobs/Gpk1UxX0tMdX7d-S”,”type”:”output”}

Sahnede birden fazla kamera varsa ancak yalnızca belirli bir kameranın görüntüsünü göndermek istiyorsanız, –camera CameraName bayrağını kullanabilirsiniz . CameraName’in sahnedeki belirli kameranın adını temsil ettiğini unutmayın . Bu ad, aşağıdaki örnektekinden farklı olabilir:

ccloud job –json submit –sceneFile cams.vrscene –camera VRayCam001