obs-service.h 3.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115
  1. /******************************************************************************
  2. Copyright (C) 2023 by Lain Bailey <lain@obsproject.com>
  3. This program is free software: you can redistribute it and/or modify
  4. it under the terms of the GNU General Public License as published by
  5. the Free Software Foundation, either version 2 of the License, or
  6. (at your option) any later version.
  7. This program is distributed in the hope that it will be useful,
  8. but WITHOUT ANY WARRANTY; without even the implied warranty of
  9. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  10. GNU General Public License for more details.
  11. You should have received a copy of the GNU General Public License
  12. along with this program. If not, see <http://www.gnu.org/licenses/>.
  13. ******************************************************************************/
  14. #pragma once
  15. /**
  16. * @file
  17. * @brief header for modules implementing services.
  18. *
  19. * Services are modules that implement provider specific settings for outputs.
  20. */
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24. struct obs_service_resolution {
  25. int cx;
  26. int cy;
  27. };
  28. /* NOTE: Odd numbers are reserved for custom info from third-party protocols */
  29. enum obs_service_connect_info {
  30. OBS_SERVICE_CONNECT_INFO_SERVER_URL = 0,
  31. OBS_SERVICE_CONNECT_INFO_STREAM_ID = 2,
  32. OBS_SERVICE_CONNECT_INFO_STREAM_KEY = 2, // Alias of OBS_SERVICE_CONNECT_INFO_STREAM_ID
  33. OBS_SERVICE_CONNECT_INFO_USERNAME = 4,
  34. OBS_SERVICE_CONNECT_INFO_PASSWORD = 6,
  35. OBS_SERVICE_CONNECT_INFO_ENCRYPT_PASSPHRASE = 8,
  36. OBS_SERVICE_CONNECT_INFO_BEARER_TOKEN = 10,
  37. };
  38. struct obs_service_info {
  39. /* required */
  40. const char *id;
  41. const char *(*get_name)(void *type_data);
  42. void *(*create)(obs_data_t *settings, obs_service_t *service);
  43. void (*destroy)(void *data);
  44. /* optional */
  45. void (*activate)(void *data, obs_data_t *settings);
  46. void (*deactivate)(void *data);
  47. void (*update)(void *data, obs_data_t *settings);
  48. void (*get_defaults)(obs_data_t *settings);
  49. obs_properties_t *(*get_properties)(void *data);
  50. /**
  51. * Called when getting ready to start up an output, before the encoders
  52. * and output are initialized
  53. *
  54. * @param data Internal service data
  55. * @param output Output context
  56. * @return true to allow the output to start up,
  57. * false to prevent output from starting up
  58. */
  59. bool (*initialize)(void *data, obs_output_t *output);
  60. const char *(*get_url)(void *data);
  61. const char *(*get_key)(void *data);
  62. const char *(*get_username)(void *data);
  63. const char *(*get_password)(void *data);
  64. bool (*deprecated_1)();
  65. void (*apply_encoder_settings)(void *data, obs_data_t *video_encoder_settings,
  66. obs_data_t *audio_encoder_settings);
  67. void *type_data;
  68. void (*free_type_data)(void *type_data);
  69. /* TODO: Rename to 'get_preferred_output_type' once a API/ABI break happen */
  70. const char *(*get_output_type)(void *data);
  71. void (*get_supported_resolutions)(void *data, struct obs_service_resolution **resolutions, size_t *count);
  72. void (*get_max_fps)(void *data, int *fps);
  73. void (*get_max_bitrate)(void *data, int *video_bitrate, int *audio_bitrate);
  74. const char **(*get_supported_video_codecs)(void *data);
  75. const char *(*get_protocol)(void *data);
  76. const char **(*get_supported_audio_codecs)(void *data);
  77. const char *(*get_connect_info)(void *data, uint32_t type);
  78. bool (*can_try_to_connect)(void *data);
  79. };
  80. EXPORT void obs_register_service_s(const struct obs_service_info *info, size_t size);
  81. #define obs_register_service(info) obs_register_service_s(info, sizeof(struct obs_service_info))
  82. #ifdef __cplusplus
  83. }
  84. #endif