# agora::rtc::IMetadataObserver类 参考 (/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-metadata-observer)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## 详细描述 [#详细描述]
视频 [Metadata](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-i-metadata-observer-1-1-metadata) 观测器。通过 [ILocalVideoTrack::registerVideoMetadataObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track#a551cacb9f56b75ffd2b4bdf9db721eb4) 注册。
## 公开类型 [#公开类型]
- [Metadata](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-i-metadata-observer-1-1-metadata):发送或接收的视频 Metadata。
## 成员枚举类型说明 [#成员枚举类型说明]
### METADATA_TYPE [#metadata_type]
enum [agora::rtc::IMetadataObserver::METADATA_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-metadata-observer#a50ad8779d161456fc709d947b8c7c544)
[Metadata](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-i-metadata-observer-1-1-metadata) 类型,目前仅支持视频 Metadata。
| 枚举值 |
|
UNKNOWN_METADATA
|
-1:未知类型。 |
|
VIDEO_METADATA
|
0:视频 Metadata。 |
### MAX_METADATA_SIZE_TYPE [#max_metadata_size_type]
enum [agora::rtc::IMetadataObserver::MAX_METADATA_SIZE_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-metadata-observer#aa4297438e6cdde7a9faec3e137dedfe0)
[Metadata](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-i-metadata-observer-1-1-metadata) 大小常量,单位为字节。
| 枚举值 |
|
INVALID_METADATA_SIZE_IN_BYTE
|
-1:无效大小。 |
|
DEFAULT_METADATA_SIZE_IN_BYTE
|
512:默认大小。 |
|
MAX_METADATA_SIZE_IN_BYTE
|
1024:最大大小。 |
## 构造及析构函数说明 [#构造及析构函数说明]
### ~IMetadataObserver() [#imetadataobserver]
virtual agora::rtc::IMetadataObserver::~IMetadataObserver()
## 成员函数说明 [#成员函数说明]
### getMaxMetadataSize() [#getmaxmetadatasize]
virtual int agora::rtc::IMetadataObserver::getMaxMetadataSize()
SDK 请求 [Metadata](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-i-metadata-observer-1-1-metadata) 最大缓冲区大小时触发。
返回值
最大大小,单位为字节。默认值为 `512`,最大为 `1024`。
### onReadyToSendMetadata() [#onreadytosendmetadata]
virtual bool agora::rtc::IMetadataObserver::onReadyToSendMetadata([Metadata](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-i-metadata-observer-1-1-metadata) & *metadata*, [VIDEO_SOURCE_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ac6699b3c40e047af097d877115dde751) *source_type*)
SDK 准备发送 [Metadata](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-i-metadata-observer-1-1-metadata) 时触发。将数据写入 SDK 提供的缓冲区,并设置大小。
:::info[注解]
[Metadata](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-i-metadata-observer-1-1-metadata) 大小不得超过 getMaxMetadataSize 返回的值。
:::
待发送的 Metadata。
视频源类型:VIDEO_SOURCE_TYPE。
返回值
`true`:发送 Metadata;`false`:不发送 Metadata。
### onMetadataReceived() [#onmetadatareceived]
virtual void agora::rtc::IMetadataObserver::onMetadataReceived(const [Metadata](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-i-metadata-observer-1-1-metadata) & *metadata*)
收到远端用户的视频 [Metadata](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-i-metadata-observer-1-1-metadata) 时触发。
收到的 Metadata。