propresenter7-php-lib/proto/timers.proto
Thorsten Bus 8e80a8af88 Upgrade proto schema to ProPresenter Proto 19beta
Sync the bundled .proto definitions with greyshirtguy/ProPresenter7-Proto
"Proto 19beta" (dumped from ProPresenter v19 beta build 318767123,
2025-06-05). This pulls in the schema for ProPresenter 19 features
including new advertisement groups, custom options, media metadata,
prop API v1, transport API, feature flags, PSB workspace, and zone
definitions, plus refactored analytics tracked events.

Strategy: merge rather than wholesale replace. All Proto 19beta files
overwrite our existing copies so we pick up the field/message updates
upstream made between 7.16.2 and 19beta. Eleven new .proto files are
added: advertisementGroup, analyticsEdit, analyticsMediaManagement,
analyticsPowerPoint, analyticsTrackedEvents, analyticsTriggerCue,
customOptions, mediaMetadata, proCoreFeatureFlags, psbWorkspace, zone.
Three google/protobuf well-known types (any, source_context, type) are
added for completeness; only descriptor.proto is actually imported.

Five proto files are kept that are not part of Proto 19beta upstream:
calendar.proto and keyMappings.proto were extracted from PP binaries
to support our parse-calendar and parse-key-mappings tools, while
analyticsCapture/Update/WHMStore.proto are retained from the prior
7.16.2 set so existing generated descriptors keep loading.

generated/ is regenerated from scratch with `protoc --php_out=generated
--proto_path=proto *.proto` (protoc 29.3, google/protobuf PHP 4.33.5).
The full PHPUnit suite (369 tests, 1298 assertions) still passes
without any source changes - the new schema is wire-compatible with our
reference files and high-level wrappers.

Documentation references to "v7.16.2" are updated to "Proto 19beta" in
LICENSE, doc/formats/pp_song_spec.md, pp_playlist_spec.md,
pp_bundle_spec.md, and doc/internal/decisions.md.
2026-05-04 07:19:24 +02:00

99 lines
2.3 KiB
Protocol Buffer
Executable file

syntax = "proto3";
package rv.data;
option cc_enable_arenas = true;
option csharp_namespace = "Pro.SerializationInterop.RVProtoData";
option swift_prefix = "RVData_";
import "applicationInfo.proto";
import "customOptions.proto";
import "uuid.proto";
message Clock {
message Format {
reserved 1;
enum DateFormatterStyle {
DATE_FORMATTER_STYLE_NONE = 0;
DATE_FORMATTER_STYLE_SHORT = 1;
DATE_FORMATTER_STYLE_MEDIUM = 2;
DATE_FORMATTER_STYLE_LONG = 3;
DATE_FORMATTER_STYLE_FULL = 4;
}
.rv.data.Clock.Format.DateFormatterStyle date_type = 2;
.rv.data.Clock.Format.DateFormatterStyle time_format = 3;
bool military_time_enabled = 4;
}
string format = 1;
}
message Timer {
reserved 3;
reserved 4;
reserved 5;
reserved 6;
reserved 7;
reserved 8;
reserved 9;
message Format {
enum Style {
STYE_NONE = 0;
STYLE_SHORT = 1;
STYLE_LONG = 2;
STYLE_REMOVE_SHORT = 3;
STYLE_REMOVE_LONG = 4;
}
.rv.data.Timer.Format.Style hour = 1;
.rv.data.Timer.Format.Style minute = 2;
.rv.data.Timer.Format.Style second = 3;
.rv.data.Timer.Format.Style millisecond = 4;
bool is_wall_clock_time = 5;
bool is_24_hour_time = 6;
bool show_milliseconds_under_minute_only = 7;
}
message Configuration {
message TimerTypeCountdown {
double duration = 1;
}
message TimerTypeCountdownToTime {
enum TimePeriod {
TIME_PERIOD_AM = 0;
TIME_PERIOD_PM = 1;
TIME_PERIOD_24 = 2;
}
double time_of_day = 1;
.rv.data.Timer.Configuration.TimerTypeCountdownToTime.TimePeriod period = 2;
}
message TimerTypeElapsedTime {
double start_time = 1;
double end_time = 2;
bool has_end_time = 3;
}
bool allows_overrun = 4;
oneof TimerType {
.rv.data.Timer.Configuration.TimerTypeCountdown countdown = 1;
.rv.data.Timer.Configuration.TimerTypeCountdownToTime countdown_to_time = 2;
.rv.data.Timer.Configuration.TimerTypeElapsedTime elapsed_time = 3;
}
}
.rv.data.UUID uuid = 1;
string name = 2;
.rv.data.Timer.Configuration configuration = 10;
}
message TimersDocument {
.rv.data.ApplicationInfo application_info = 1;
.rv.data.Clock clock = 2;
repeated .rv.data.Timer timers = 3;
}