LocalizationDocument.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "editing/EditingProtocol.h"
 
#include <functional>
#include <map>
#include <string>
#include <vector>
 
namespace eve::audio {
class Source;
}
namespace eve::dialogue {
class DialogueVoice;
}
 
namespace eve::localization_editing {
using DiagnosticSeverity=editing::DiagnosticSeverity; using EditorDiagnostic=editing::Diagnostic;
using editing::Result; using EditorStatus=editing::Status;
using EditorValue=editing::Value; using Revision=editing::Revision; using RuleId=editing::RuleId;
 
struct LocalizationVariant {
    std::string text;
    std::string voiceAsset;
    std::string voiceStatus;
    double voiceDuration = 0.0;
};
 
struct LocalizationRow {
    std::string key;
    std::string context;
    std::string sourceText;
    std::map<std::string, LocalizationVariant> variants;
};
 
struct LocalizationLocaleCoverage {
    std::string locale;
    int total = 0;
    int translated = 0;
    int voiced = 0;
    int approved = 0;
};
 
struct LocalizationAnalysis {
    EditorStatus status = EditorStatus::Applied;
    std::vector<LocalizationLocaleCoverage> locales;
    std::vector<EditorDiagnostic> diagnostics;
};
 
class EVENGINE_API_ORCHESTRATION LocalizationDocument {
public:
    Result<void> addRow(std::string key, std::string sourceText, std::string context = {});
    Result<void> removeRow(const std::string& key);
    Result<void> setVariant(const std::string& key, std::string locale,
                                  LocalizationVariant variant);
    std::vector<LocalizationRow> rows() const;
    LocalizationAnalysis analyze(const std::vector<std::string>& requiredLocales,
                                 bool requireVoice = false) const;
    EditorValue snapshotValue() const;
    Result<void> loadSnapshot(const EditorValue& snapshot);
    Revision revision() const { return revision_; }
 
private:
    std::map<std::string, LocalizationRow> rows_;
    Revision revision_ = 0;
};
 
class LocalizationVoiceAudition {
public:
    using SourceResolver = std::function<audio::Source*(const std::string& asset)>;
    Result<void> play(const LocalizationDocument& document, const std::string& key,
                            const std::string& locale, dialogue::DialogueVoice* voice,
                            const SourceResolver& sources) const;
};
 
}  // namespace eve::localization_editing