# 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。