plac-for-apple-platform

Unofficial Roon client for Apple devices

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. 7
  8. 8
  9. 9
  10. 10
  11. 11
  12. 12
  13. 13
  14. 14
  15. 15
  16. 16
  17. 17
  18. 18
  19. 19
  20. 20
  21. 21
  22. 22
  23. 23
  24. 24
  25. 25
  26. 26
  27. 27
  28. 28
  29. 29
  30. 30
  31. 31
  32. 32
  33. 33
  34. 34
  35. 35
  36. 36
  37. 37
  38. 38
  39. 39
  40. 40
  41. 41
  42. 42
  43. 43
  44. 44
  45. 45
  46. 46
  47. 47
  48. 48
  49. 49
  50. 50
  51. 51
  52. 52
  53. 53
  54. 54
  55. 55
  56. 56
  57. 57
  58. 58
  59. 59
  60. 60
  61. 61
  62. 62
  63. 63
  64. 64
  65. 65
  66. 66
  67. 67
  68. 68
  69. 69
  70. 70
  71. 71
  72. 72
  73. 73
  74. 74
  75. 75
  76. 76
  77. 77
  78. 78
  79. 79
  80. 80
  81. 81
  82. 82
  83. 83
  84. 84
  85. 85
  86. 86
  87. 87
  88. 88
  89. 89
  90. 90
  91. 91
  92. 92
  93. 93
  94. 94
  95. 95
  96. 96
  97. 97
  98. 98
  99. 99
  100. 100
  101. 101
  102. 102
  103. 103
  104. 104
  105. 105
  106. 106
  107. 107
  108. 108
  109. 109
  110. 110
  111. 111
  112. 112
  113. 113
  114. 114
  115. 115
  116. 116
  117. 117
  118. 118
  119. 119
  120. 120
  121. 121
  122. 122
  123. 123
  124. 124
  125. 125
  126. 126
  127. 127
  128. 128
  129. 129
  130. 130
  131. 131
  132. 132
  133. 133
  134. 134
  135. 135
  136. 136
  137. 137
  138. 138
  139. 139
  140. 140
  141. 141
  142. 142
  143. 143
  144. 144
  145. 145
  146. 146
/*
 * Copyright 2025 Shota FUJI
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * ===
 *
 * C99 header file for helper C API for Plac GTK-Adwaita app.
 * This file is not checked against a generated library file: carefully write and review
 * definitions and implementations.
 */

#ifndef PLAC_GTK_ADWAITA_CORE_H
#define PLAC_GTK_ADWAITA_CORE_H

#include <stddef.h>
#include <stdint.h>

// discovery.Server
typedef struct { void *__pri; } plac_discovery_server;
plac_discovery_server *plac_discovery_server_retain(plac_discovery_server*);
void plac_discovery_server_release(plac_discovery_server*);
char *plac_discovery_server_id(plac_discovery_server*);
char *plac_discovery_server_name(plac_discovery_server*);
char *plac_discovery_server_version(plac_discovery_server*);
uint16_t *plac_discovery_server_http_port(plac_discovery_server*);

// discovery.ScanResult.Code
typedef enum {
	PLAC_DISCOVERY_SCAN_RESULT_OK = 0,
	PLAC_DISCOVERY_SCAN_RESULT_UNKNOWN = 1,
	PLAC_DISCOVERY_SCAN_RESULT_NETWORK_UNAVAILABLE = 2,
	PLAC_DISCOVERY_SCAN_RESULT_SOCKET_PERMISSION_DENIED = 3,
	PLAC_DISCOVERY_SCAN_RESULT_SOCKET_ERROR = 4,
	PLAC_DISCOVERY_SCAN_RESULT_OUT_OF_MEMORY = 5,
} plac_discovery_scan_result_code;

// discovery.ScanResult
typedef struct {
	void *__pri;
	plac_discovery_server **servers_ptr;
	size_t servers_len;
	plac_discovery_scan_result_code code;
} plac_discovery_scan_result;
plac_discovery_scan_result *plac_discovery_scan_result_retain(plac_discovery_scan_result*);
void plac_discovery_scan_result_release(plac_discovery_scan_result*);

// discovery
plac_discovery_scan_result *plac_discovery_scan();

// transport.PlaybackState
typedef enum {
	PLAC_TRANSPORT_PLAYBACK_LOADING = 0,
	PLAC_TRANSPORT_PLAYBACK_STOPPED = 1,
	PLAC_TRANSPORT_PLAYBACK_PAUSED = 2,
	PLAC_TRANSPORT_PLAYBACK_PLAYING = 3,
} plac_transport_playback_state;

// transport.Zone
typedef struct {
	void *__pri;
	char *id;
	char *name;
	plac_transport_playback_state playback;
} plac_transport_zone;
plac_transport_zone *plac_transport_zone_retain(plac_transport_zone*);
void plac_transport_zone_release(plac_transport_zone*);

// transport.ZoneListEvent
typedef struct {
	void *__pri;
	plac_transport_zone **added_zones_ptr;
	size_t added_zones_len;
	plac_transport_zone **changed_zones_ptr;
	size_t changed_zones_len;
	char **removed_zone_ids_ptr;
	size_t removed_zone_ids_len;
} plac_transport_zone_list_event;
plac_transport_zone_list_event *plac_transport_zone_list_event_retain(plac_transport_zone_list_event*);
void plac_transport_zone_list_event_release(plac_transport_zone_list_event*);

// connection.ConnectedEvent
typedef struct {
	void *__pri;
	char *token;
} plac_connection_connected_event;
plac_connection_connected_event *plac_connection_connected_event_retain(plac_connection_connected_event*);
void plac_connection_connected_event_release(plac_connection_connected_event*);

// connection.ConnectionError
typedef enum {
	PLAC_CONNECTION_ERROR_UNKNOWN = 0,
	PLAC_CONNECTION_ERROR_CLOSED_BY_SERVER = 1,
	PLAC_CONNECTION_ERROR_OUT_OF_MEMORY = 2,
	PLAC_CONNECTION_ERROR_UNEXPECTED_RESPONSE = 3,
	PLAC_CONNECTION_ERROR_NETWORK_UNAVAILABLE = 4,
	PLAC_CONNECTION_ERROR_NETWORK_ERROR = 5,
} plac_connection_connection_error;

// connection.ConnectionErrorEvent
typedef struct {
	void *__pri;
	plac_connection_connection_error code;
} plac_connection_connection_error_event;
plac_connection_connection_error_event *plac_connection_connection_error_event_retain(plac_connection_connection_error_event*);
void plac_connection_connection_error_event_release(plac_connection_connection_error_event*);

// connection.Event.Kind
typedef enum {
	PLAC_CONNECTION_EVENT_ERROR = 0,
	PLAC_CONNECTION_EVENT_CONNECTED = 1,
	PLAC_CONNECTION_EVENT_ZONE_LIST = 10,
} plac_connection_event_kind;

// connection.Event
typedef struct {
	void *__pri;
	plac_connection_event_kind kind;
} plac_connection_event;
plac_connection_event *plac_connection_event_retain(plac_connection_event*);
void plac_connection_event_release(plac_connection_event*);
plac_connection_connection_error_event *plac_connection_event_get_connection_error_event(plac_connection_event*);
plac_connection_connected_event *plac_connection_event_get_connected_event(plac_connection_event*);
plac_transport_zone_list_event *plac_connection_event_get_zone_list_event(plac_connection_event*);

// connection.Connection
typedef struct { void *__pri; } plac_connection;
plac_connection *plac_connection_make(plac_discovery_server*);
plac_connection *plac_connection_retain(plac_connection*);
void plac_connection_release(plac_connection*);
plac_connection_event *plac_connection_get_event(plac_connection*);
void plac_connection_subscribe_zones(plac_connection*);

#endif