@@ -135,15 +135,27 @@ class MprisPlayer: public QObject {
135135 // / > [!WARNING] This is NOT `mpris:trackid` as that is sometimes missing or nonunique
136136 // / > in some players.
137137 Q_PROPERTY (quint32 uniqueId READ uniqueId NOTIFY uniqueIdChanged BINDABLE bindableUniqueId);
138- // / The title of the current track, or "Unknown Track" if none was provided.
138+ // / The title of the current track, or `""` if none was provided.
139+ // /
140+ // / > [!TIP] Use `player.trackTitle || "Unknown Title"` to provide a message
141+ // / > when no title is available.
139142 Q_PROPERTY (QString trackTitle READ trackTitle NOTIFY trackTitleChanged BINDABLE bindableTrackTitle);
140- // / The current track's artist, or an empty string if none was provided.
143+ // / The current track's artist, or an `""` if none was provided.
144+ // /
145+ // / > [!TIP] Use `player.trackArtist || "Unknown Artist"` to provide a message
146+ // / > when no artist is available.
141147 Q_PROPERTY (QString trackArtist READ trackArtist NOTIFY trackArtistChanged BINDABLE bindableTrackArtist);
142148 // / > [!ERROR] deprecated in favor of @@trackArtist.
143149 Q_PROPERTY (QString trackArtists READ trackArtist NOTIFY trackArtistChanged BINDABLE bindableTrackArtist);
144- // / The current track's album, or "Unknown Album" if none was provided.
150+ // / The current track's album, or `""` if none was provided.
151+ // /
152+ // / > [!TIP] Use `player.trackAlbum || "Unknown Album"` to provide a message
153+ // / > when no album is available.
145154 Q_PROPERTY (QString trackAlbum READ trackAlbum NOTIFY trackAlbumChanged BINDABLE bindableTrackAlbum);
146- // / The current track's album artist, or "Unknown Artist" if none was provided.
155+ // / The current track's album artist, or `""` if none was provided.
156+ // /
157+ // / > [!TIP] Use `player.trackAlbumArtist || "Unknown Album"` to provide a message
158+ // / > when no album artist is available.
147159 Q_PROPERTY (QString trackAlbumArtist READ trackAlbumArtist NOTIFY trackAlbumArtistChanged BINDABLE bindableTrackAlbumArtist);
148160 // / The current track's art url, or `""` if none was provided.
149161 Q_PROPERTY (QString trackArtUrl READ trackArtUrl NOTIFY trackArtUrlChanged BINDABLE bindableTrackArtUrl);
0 commit comments