मुख्य कंटेंट तक स्किप करें

म्यूज़िक कंट्रोल का परिचय

Music Control connected AIBuds device के जरिए playback और playback-volume commands भेजता है।

उपलब्ध सुविधाएँ​

शुरुआत करें​

  1. डिवाइस कनेक्ट करें - डिवाइस के connected और ready होने की प्रतीक्षा करें।
  2. Protocol conformance जाँचें - DeviceMusicControlAPI support की पुष्टि करें।
  3. Command चुनें - Play, pause, next/previous track या playback volume adjust करें।
  4. Completion संभालें - Command success report करने के बाद ही app UI update करें।

मुख्य अवधारणाएँ​

प्लेबैक कमांड​

  • playMusic playback शुरू या resume करता है।
  • pauseMusic playback pause करता है।
  • playNextMusic और playPreviousMusic playback queue में आगे या पीछे जाते हैं।
  • Public protocol stop command परिभाषित नहीं करता।

प्लेबैक वॉल्यूम कमांड​

  • musicVolumeUp और musicVolumeDown device-defined एक step बदलते हैं।
  • mute और unmute playback muting नियंत्रित करते हैं।
  • setMusicVolume 0 से 100 तक explicit level स्वीकार करता है।

प्रोटोकॉल संदर्भ​

Music Control DeviceMusicControlAPI से मिलता है:

Swift
guard let device = device as? DeviceMusicControlAPI else {
    print("Device does not support DeviceMusicControlAPI")
    return
}

सर्वोत्तम अभ्यास​

  1. Protocol conformance जाँचें: SDK अलग Boolean support query नहीं देता।
  2. हर Completion संभालें: Command fail होने पर success जाँचें और error report करें।
  3. Sliders debounce करें: हर intermediate explicit volume value न भेजें।
  4. Playback changes देखें: UI को device notifications follow करनी हों तो didMediaPlayStatusChanged उपयोग करें।

ध्यान दें​

  • SDK इस protocol से active player, track metadata या playback queue नहीं देता।
  • Command success केवल command execution की पुष्टि करता है, permanent playback state की नहीं।
  • Volume Control और Music Control अलग protocols हैं, भले दोनों में volume-related operations हों।