QMediaMetaData Class
미디어 파일에 대한 메타데이터를 제공합니다. 더 보기...
| Header: | #include <QMediaMetaData> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia)target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
공용 타입
| enum | Key { Title, Author, Comment, Description, Genre, …, HasHdrContent } |
공용 함수
| void | clear() |
| void | insert(QMediaMetaData::Key k, const QVariant &value) |
| bool | isEmpty() const |
| QList<QMediaMetaData::Key> | keys() const |
| void | remove(QMediaMetaData::Key k) |
| QString | stringValue(QMediaMetaData::Key key) const |
| QVariant | value(QMediaMetaData::Key key) const |
| QVariant & | operator[](QMediaMetaData::Key k) |
정적 공용 멤버
| QString | metaDataKeyToString(QMediaMetaData::Key key) |
보호된 변수
| QHash<QMediaMetaData::Key, QVariant> | data |
정적 보호 멤버
| QMetaType | keyType(QMediaMetaData::Key key) |
관련 비회원
| bool | operator!=(const QMediaMetaData &a, const QMediaMetaData &b) |
| bool | operator==(const QMediaMetaData &a, const QMediaMetaData &b) |
상세 설명
참고: 모든 식별자가 모든 플랫폼에서 지원되는 것은 아닙니다.
| 공통 속성 | ||
|---|---|---|
| 값 | 설명 | 유형 |
| 제목 | 미디어의 제목입니다. | QString |
| 작성자 | 미디어의 작성자입니다. | QStringList |
| 댓글 | 미디어에 대한 사용자 댓글입니다. | QString |
| 설명 | 미디어에 대한 설명입니다. | QString |
| 장르 | 미디어의 장르입니다. | QStringList |
| 날짜 | 미디어의 날짜입니다. | QDateTime. |
| 언어 | 미디어의 언어입니다. | QLocale::Language |
| 게시자 | 미디어의 게시자입니다. | QString |
| 저작권 | 미디어의 저작권 고지입니다. | QString |
| Url | 미디어의 출처를 가리키는 URL입니다. | QUrl |
| 미디어 속성 | ||
| MediaType | 미디어의 유형(오디오, 비디오 등)입니다. | QString |
| FileFormat | 미디어의 파일 형식입니다. | QMediaFormat::FileFormat |
| 지속 시간 | 미디어의 지속 시간(밀리초)입니다. | qint64 |
| 오디오 속성 | ||
| AudioBitRate | 미디어의 오디오 스트림의 비트 전송률(초당 비트)입니다. | int |
| AudioCodec | 미디어의 오디오 스트림의 코덱입니다. | QMediaFormat::AudioCodec |
| 비디오 속성 | ||
| VideoFrameRate | 미디어의 비디오 스트림의 프레임 속도입니다. | qreal |
| VideoBitRate | 미디어의 비디오 스트림의 비트 전송률(초당 비트 수)입니다. | int |
| VideoCodec | 미디어의 비디오 스트림의 코덱입니다. | QMediaFormat::VideoCodec |
| HasHdrContent | 동영상이 HDR 디스플레이용인 경우 참입니다(FFmpeg 및 Darwin 미디어 백엔드만 해당). | bool |
| 음악 속성 | ||
| AlbumTitle | 미디어가 속한 앨범의 제목입니다. | QString |
| AlbumArtist | 미디어가 속한 앨범의 주요 아티스트입니다. | QString |
| ContributingArtist | 미디어에 기여한 아티스트입니다. | QStringList |
| TrackNumber | 미디어의 트랙 번호입니다. | int |
| 작곡가 | 미디어의 작곡가입니다. | QStringList |
| LeadPerformer | 미디어의 리드 연주자입니다. | QStringList |
| ThumbnailImage | 메타데이터에 있는 경우 임베드된 썸네일 이미지입니다. | QImage |
| CoverArtImage | 임베드된 커버 아트 이미지. | QImage |
| 이미지 및 동영상 속성 | ||
| 방향 | 이미지 또는 동영상의 회전 각도입니다. | int |
| 해상도 | 이미지 또는 동영상의 크기입니다. | QSize |
멤버 유형 문서
enum QMediaMetaData::Key
다음 메타 데이터 키를 사용할 수 있습니다:
| 상수 | 값 | 설명 |
|---|---|---|
QMediaMetaData::Title | 0 | 미디어 제목 |
QMediaMetaData::Author | 1 | 미디어 작성자 |
QMediaMetaData::Comment | 2 | 댓글 |
QMediaMetaData::Description | 3 | 간단한 설명 |
QMediaMetaData::Genre | 4 | 미디어가 속한 장르 |
QMediaMetaData::Date | 5 | 생성 날짜 |
QMediaMetaData::Language | 6 | 미디어 언어 |
QMediaMetaData::Publisher | 7 | 미디어 퍼블리셔 정보입니다. |
QMediaMetaData::Copyright | 8 | 미디어 저작권 정보입니다. |
QMediaMetaData::Url | 9 | 퍼블리셔 웹사이트 URL |
QMediaMetaData::Duration | 10 | 미디어 재생 시간 |
QMediaMetaData::MediaType | 11 | 미디어 유형 |
QMediaMetaData::FileFormat | 12 | 파일 형식 |
QMediaMetaData::AudioBitRate | 13 | |
QMediaMetaData::AudioCodec | 14 | |
QMediaMetaData::VideoBitRate | 15 | |
QMediaMetaData::VideoCodec | 16 | |
QMediaMetaData::VideoFrameRate | 17 | |
QMediaMetaData::AlbumTitle | 18 | 앨범 제목 |
QMediaMetaData::AlbumArtist | 19 | 아티스트 정보. |
QMediaMetaData::ContributingArtist | 20 | |
QMediaMetaData::TrackNumber | 21 | |
QMediaMetaData::Composer | 22 | 미디어 제작자 정보. |
QMediaMetaData::LeadPerformer | 23 | |
QMediaMetaData::ThumbnailImage | 24 | 미디어 썸네일 이미지(메타데이터에 임베드된 경우) |
QMediaMetaData::CoverArtImage | 25 | 미디어 커버 아트 |
QMediaMetaData::Orientation | 26 | |
QMediaMetaData::Resolution | 27 | |
QMediaMetaData::HasHdrContent (since Qt 6.8) | 28 | 동영상에 HDR 콘텐츠가 있을 수 있습니다(읽기 전용, FFmpeg 및 Darwin 미디어 백엔드만 해당). |
멤버 기능 문서
[invokable] void QMediaMetaData::clear()
메타 데이터 객체에서 모든 데이터를 제거합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] void QMediaMetaData::insert(QMediaMetaData::Key k, const QVariant &value)
value 을 키에 삽입합니다: k.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] bool QMediaMetaData::isEmpty() const
메타 데이터에 항목이 없는 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[static protected] QMetaType QMediaMetaData::keyType(QMediaMetaData::Key key)
키에 대한 데이터를 저장하는 데 사용되는 메타 타입을 반환합니다 key.
[invokable] QList<QMediaMetaData::Key> QMediaMetaData::keys() const
QMediaMetaData::Keys의 QList 를 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.
[static invokable] QString QMediaMetaData::metaDataKeyToString(QMediaMetaData::Key key)
는 사용자에게 메타 데이터를 표시할 때 사용할 수 있는 key 의 문자열 표현을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] void QMediaMetaData::remove(QMediaMetaData::Key k)
키에서 메타 데이터를 제거합니다: k.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] QString QMediaMetaData::stringValue(QMediaMetaData::Key key) const
키 key 에 대한 메타 데이터를 QString 로 반환합니다.
이 함수는 주로 메타 데이터를 사용자에게 간단하게 표시하기 위한 것입니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] QVariant QMediaMetaData::value(QMediaMetaData::Key key) const
키에 대한 메타 데이터 값 key 을 반환하거나, 키에 대한 메타 데이터가 없는 경우 null QVariant 을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
QVariant &QMediaMetaData::operator[](QMediaMetaData::Key k)
키에 저장된 데이터를 반환합니다 k.
QMediaMetaData rockBallad1; rockBalad[QMediaMetaData::Genre]="Rock"
멤버 변수 문서
QHash<QMediaMetaData::Key, QVariant> QMediaMetaData::data
이 변수는 메타 데이터를 저장합니다.
참고: 이 변수는 해당 클래스의 protected 멤버입니다.
관련 비회원
bool operator!=(const QMediaMetaData &a, const QMediaMetaData &b)
두 개의 메타 데이터 개체 a 와 b 를 비교하여 동일하면 false 를 반환하고 다르면 true 을 반환합니다.
bool operator==(const QMediaMetaData &a, const QMediaMetaData &b)
두 개의 메타 데이터 개체 a 와 b 를 비교하여 동일하면 true 를 반환하고 다르면 false 을 반환합니다.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
