Blueprint Developer API

Editor Utility Blueprint ve Editor Utility Widget geliştirenler, Locus’un sunduğu async düğümleri kullanmalıdır. Unreal reflection sistemi üzerinden erişilebilen daha düşük düzeydeki istek nesneleri Python ile ortak kullanılan altyapıdır; normal Blueprint iş akışının parçası değildir.

Düğümleri Blueprint paletinde Locus > Notes, Locus > Documents ve Locus > Pins altında bulabilirsiniz.

Kullanılabilir düğümler

Kategori	Düğümler
Locus > Notes	List Locus Notes, Get Locus Note, Search Locus Notes, Create Locus Note, Update Locus Note, Archive Locus Note
Locus > Documents	List Locus Documents, Get Locus Document, Search Locus Documents, Create Locus Document, Update Locus Document
Locus > Pins	List Locus Pins, Get Locus Pin, Create Locus Pin, Update Locus Pin Metadata, Add Locus Pin Comment

Eşzamansız sonuçlar

Her düğüm sonlandırıcı Succeeded ve Failed yürütme çıkışlarını sunar. Düğümde, eşzamansız sonuçla karıştırılabilecek anlık bir tamamlanma yolu bilerek yoktur.

Her iki sonuç da şunları sunar:

türü belirlenmiş Result;
sağlayıcıdan bağımsız Operation Status;
türü belirlenmiş Error.

Hata durumunda Message metnini ayrıştırmak yerine Error > Code değerine göre dallanın. Sunulan Async Action proxy’si, çalışmaya başlamamış işler için iş birliğine dayalı Cancel sağlar. İptal, kaydedilmekte olan bir değişikliği kesmez.

Belge oluşturma

Create Locus Document ekleyin ve şunları sağlayın:

Path: seçili görünen köke göre Design/Combat.md gibi bir yol;
Markdown: # Combat gibi ilk kaynak;
Presentation Root: Locus Documents veya Content Browser.

Belge kimliği için Succeeded sonucundaki Identity > Relative Path değerini kullanın. Bunun yerine sunum yolunu veya /Game/... bağlamını kullanmayın.

Revizyon güvenli Not güncellemesi

Get Locus Note kullanın ve Identity ile Revision çıkışlarını saklayın.
Bir Locus Developer Note Changes struct’ı oluşturun.
Yalnızca değiştirmek istediğiniz alanların Set ... niyet bayraklarını ayarlayın.
Identity, okunan revizyonu Expected Revision ve Changes olarak verip Update Locus Note çağırın.
Succeeded yolunu izleyin veya Failed > Error > Code değerini inceleyin. Stale Revision durumunda Notu yeniden getirip güncellemeyi tekrar değerlendirin.

Değişiklik struct’ı değiştirmeme, ayarlama ve temizleme durumlarını ayırır:

Değerler	Anlam
`Set Title = false`	Title değişmeden kalır; Title değeri yok sayılır
`Set Title = true`, `Title = "New Title"`	Boş olmayan başlık ayarlar
`Set Title = true`, `Title = ""`	Etki alanı doğrulamasına tabi olarak açıkça boş başlık ister

Aynı kalıp Not gövdesi, etiketleri ve durumu için de geçerlidir. Başarıdan sonra sonraki değişiklik için yeni sonuç revizyonunu kullanın.

Pin meta verisi değişiklikleri aynı niyet kurallarıyla Set Title, Set Description, Set Pin Type ve Set Tags kullanır. Update Locus Pin Metadata, Pinin dünyasını, konumunu, çapasını, görünümünü ve kapsamını korur.

Pinler

Create Locus Pin açık kapsam, kayıtlı World Asset yolu, dünya uzayı konumu ve başlık kabul eder. Gelişmiş girdiler dünya etiketi, açıklama, Pin türü ve etiketleri içerir. Dünya yolu, /Game/Maps/Main.Main gibi desteklenen, kayıtlı ve projeye ait bir dünyayı tanımlamalıdır.

Blueprint; Pinleri listeleyip getirebilir, güvenli temel Pin biçimini oluşturabilir, meta verileri güncelleyebilir ve yorum ekleyebilir. Developer API, Pini yeniden konumlandırmayı veya çapanın keyfî olarak değiştirilmesini sunmaz.

Revizyonlar, türü belirlenmiş hatalar, işlem durumu, kapsam ve tam yetenek matrisi için Developer API genel bakışına bakın.