spotifywebapiPython 1.0.42__py3-none-any.whl → 1.0.43__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of spotifywebapiPython might be problematic. Click here for more details.

Files changed (20) hide show
  1. {spotifywebapiPython-1.0.42.dist-info → spotifywebapiPython-1.0.43.dist-info}/METADATA +1 -1
  2. {spotifywebapiPython-1.0.42.dist-info → spotifywebapiPython-1.0.43.dist-info}/RECORD +20 -20
  3. spotifywebapipython/const.py +1 -1
  4. spotifywebapipython/docs/__init__.html +9 -2
  5. spotifywebapipython/docs/index.html +2 -2
  6. spotifywebapipython/docs/search.js +1 -1
  7. spotifywebapipython/docs/spotifywebapiPython/const.html +3 -3
  8. spotifywebapipython/docs/spotifywebapiPython/saappmessages.html +2 -2
  9. spotifywebapipython/docs/spotifywebapiPython/sautils.html +2 -2
  10. spotifywebapipython/docs/spotifywebapiPython/spotifyapierror.html +2 -2
  11. spotifywebapipython/docs/spotifywebapiPython/spotifyapimessage.html +2 -2
  12. spotifywebapipython/docs/spotifywebapiPython/spotifyauthtoken.html +2 -2
  13. spotifywebapipython/docs/spotifywebapiPython/spotifyclient.html +178 -36
  14. spotifywebapipython/docs/spotifywebapiPython/spotifydiscovery.html +2 -2
  15. spotifywebapipython/docs/spotifywebapiPython/spotifywebapiauthenticationerror.html +2 -2
  16. spotifywebapipython/docs/spotifywebapiPython/spotifywebapierror.html +2 -2
  17. spotifywebapipython/spotifyclient.py +191 -29
  18. {spotifywebapiPython-1.0.42.dist-info → spotifywebapiPython-1.0.43.dist-info}/LICENSE +0 -0
  19. {spotifywebapiPython-1.0.42.dist-info → spotifywebapiPython-1.0.43.dist-info}/WHEEL +0 -0
  20. {spotifywebapiPython-1.0.42.dist-info → spotifywebapiPython-1.0.43.dist-info}/top_level.txt +0 -0
spotifywebapipython/docs/spotifywebapiPython/spotifywebapiauthenticationerror.html CHANGED
@@ -9,7 +9,7 @@
9
9
  </title>
10
10
  <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A//www.w3.org/2000/svg%22%20role%3D%22img%22%20aria-label%3D%22pdoc%20logo%22%20width%3D%22300%22%20height%3D%22150%22%20viewBox%3D%22-1%200%2060%2030%22%3E%3Ctitle%3Epdoc%3C/title%3E%3Cpath%20d%3D%22M29.621%2021.293c-.011-.273-.214-.475-.511-.481a.5.5%200%200%200-.489.503l-.044%201.393c-.097.551-.695%201.215-1.566%201.704-.577.428-1.306.486-2.193.182-1.426-.617-2.467-1.654-3.304-2.487l-.173-.172a3.43%203.43%200%200%200-.365-.306.49.49%200%200%200-.286-.196c-1.718-1.06-4.931-1.47-7.353.191l-.219.15c-1.707%201.187-3.413%202.131-4.328%201.03-.02-.027-.49-.685-.141-1.763.233-.721.546-2.408.772-4.076.042-.09.067-.187.046-.288.166-1.347.277-2.625.241-3.351%201.378-1.008%202.271-2.586%202.271-4.362%200-.976-.272-1.935-.788-2.774-.057-.094-.122-.18-.184-.268.033-.167.052-.339.052-.516%200-1.477-1.202-2.679-2.679-2.679-.791%200-1.496.352-1.987.9a6.3%206.3%200%200%200-1.001.029c-.492-.564-1.207-.929-2.012-.929-1.477%200-2.679%201.202-2.679%202.679A2.65%202.65%200%200%200%20.97%206.554c-.383.747-.595%201.572-.595%202.41%200%202.311%201.507%204.29%203.635%205.107-.037.699-.147%202.27-.423%203.294l-.137.461c-.622%202.042-2.515%208.257%201.727%2010.643%201.614.908%203.06%201.248%204.317%201.248%202.665%200%204.492-1.524%205.322-2.401%201.476-1.559%202.886-1.854%206.491.82%201.877%201.393%203.514%201.753%204.861%201.068%202.223-1.713%202.811-3.867%203.399-6.374.077-.846.056-1.469.054-1.537zm-4.835%204.313c-.054.305-.156.586-.242.629-.034-.007-.131-.022-.307-.157-.145-.111-.314-.478-.456-.908.221.121.432.25.675.355.115.039.219.051.33.081zm-2.251-1.238c-.05.33-.158.648-.252.694-.022.001-.125-.018-.307-.157-.217-.166-.488-.906-.639-1.573.358.344.754.693%201.198%201.036zm-3.887-2.337c-.006-.116-.018-.231-.041-.342.635.145%201.189.368%201.599.625.097.231.166.481.174.642-.03.049-.055.101-.067.158-.046.013-.128.026-.298.004-.278-.037-.901-.57-1.367-1.087zm-1.127-.497c.116.306.176.625.12.71-.019.014-.117.045-.345.016-.206-.027-.604-.332-.986-.695.41-.051.816-.056%201.211-.031zm-4.535%201.535c.209.22.379.47.358.598-.006.041-.088.138-.351.234-.144.055-.539-.063-.979-.259a11.66%2011.66%200%200%200%20.972-.573zm.983-.664c.359-.237.738-.418%201.126-.554.25.237.479.548.457.694-.006.042-.087.138-.351.235-.174.064-.694-.105-1.232-.375zm-3.381%201.794c-.022.145-.061.29-.149.401-.133.166-.358.248-.69.251h-.002c-.133%200-.306-.26-.45-.621.417.091.854.07%201.291-.031zm-2.066-8.077a4.78%204.78%200%200%201-.775-.584c.172-.115.505-.254.88-.378l-.105.962zm-.331%202.302a10.32%2010.32%200%200%201-.828-.502c.202-.143.576-.328.984-.49l-.156.992zm-.45%202.157l-.701-.403c.214-.115.536-.249.891-.376a11.57%2011.57%200%200%201-.19.779zm-.181%201.716c.064.398.194.702.298.893-.194-.051-.435-.162-.736-.398.061-.119.224-.3.438-.495zM8.87%204.141c0%20.152-.123.276-.276.276s-.275-.124-.275-.276.123-.276.276-.276.275.124.275.276zm-.735-.389a1.15%201.15%200%200%200-.314.783%201.16%201.16%200%200%200%201.162%201.162c.457%200%20.842-.27%201.032-.653.026.117.042.238.042.362a1.68%201.68%200%200%201-1.679%201.679%201.68%201.68%200%200%201-1.679-1.679c0-.843.626-1.535%201.436-1.654zM5.059%205.406A1.68%201.68%200%200%201%203.38%207.085a1.68%201.68%200%200%201-1.679-1.679c0-.037.009-.072.011-.109.21.3.541.508.935.508a1.16%201.16%200%200%200%201.162-1.162%201.14%201.14%200%200%200-.474-.912c.015%200%20.03-.005.045-.005.926.001%201.679.754%201.679%201.68zM3.198%204.141c0%20.152-.123.276-.276.276s-.275-.124-.275-.276.123-.276.276-.276.275.124.275.276zM1.375%208.964c0-.52.103-1.035.288-1.52.466.394%201.06.64%201.717.64%201.144%200%202.116-.725%202.499-1.738.383%201.012%201.355%201.738%202.499%201.738.867%200%201.631-.421%202.121-1.062.307.605.478%201.267.478%201.942%200%202.486-2.153%204.51-4.801%204.51s-4.801-2.023-4.801-4.51zm24.342%2019.349c-.985.498-2.267.168-3.813-.979-3.073-2.281-5.453-3.199-7.813-.705-1.315%201.391-4.163%203.365-8.423.97-3.174-1.786-2.239-6.266-1.261-9.479l.146-.492c.276-1.02.395-2.457.444-3.268a6.11%206.11%200%200%200%201.18.115%206.01%206.01%200%200%200%202.536-.562l-.006.175c-.802.215-1.848.612-2.021%201.25-.079.295.021.601.274.837.219.203.415.364.598.501-.667.304-1.243.698-1.311%201.179-.02.144-.022.507.393.787.213.144.395.26.564.365-1.285.521-1.361.96-1.381%201.126-.018.142-.011.496.427.746l.854.489c-.473.389-.971.914-.999%201.429-.018.278.095.532.316.713.675.556%201.231.721%201.653.721.059%200%20.104-.014.158-.02.207.707.641%201.64%201.513%201.64h.013c.8-.008%201.236-.345%201.462-.626.173-.216.268-.457.325-.692.424.195.93.374%201.372.374.151%200%20.294-.021.423-.068.732-.27.944-.704.993-1.021.009-.061.003-.119.002-.179.266.086.538.147.789.147.15%200%20.294-.021.423-.069.542-.2.797-.489.914-.754.237.147.478.258.704.288.106.014.205.021.296.021.356%200%20.595-.101.767-.229.438.435%201.094.992%201.656%201.067.106.014.205.021.296.021a1.56%201.56%200%200%200%20.323-.035c.17.575.453%201.289.866%201.605.358.273.665.362.914.362a.99.99%200%200%200%20.421-.093%201.03%201.03%200%200%200%20.245-.164c.168.428.39.846.68%201.068.358.273.665.362.913.362a.99.99%200%200%200%20.421-.093c.317-.148.512-.448.639-.762.251.157.495.257.726.257.127%200%20.25-.024.37-.071.427-.17.706-.617.841-1.314.022-.015.047-.022.068-.038.067-.051.133-.104.196-.159-.443%201.486-1.107%202.761-2.086%203.257zM8.66%209.925a.5.5%200%201%200-1%200c0%20.653-.818%201.205-1.787%201.205s-1.787-.552-1.787-1.205a.5.5%200%201%200-1%200c0%201.216%201.25%202.205%202.787%202.205s2.787-.989%202.787-2.205zm4.4%2015.965l-.208.097c-2.661%201.258-4.708%201.436-6.086.527-1.542-1.017-1.88-3.19-1.844-4.198a.4.4%200%200%200-.385-.414c-.242-.029-.406.164-.414.385-.046%201.249.367%203.686%202.202%204.896.708.467%201.547.7%202.51.7%201.248%200%202.706-.392%204.362-1.174l.185-.086a.4.4%200%200%200%20.205-.527c-.089-.204-.326-.291-.527-.206zM9.547%202.292c.093.077.205.114.317.114a.5.5%200%200%200%20.318-.886L8.817.397a.5.5%200%200%200-.703.068.5.5%200%200%200%20.069.703l1.364%201.124zm-7.661-.065c.086%200%20.173-.022.253-.068l1.523-.893a.5.5%200%200%200-.506-.863l-1.523.892a.5.5%200%200%200-.179.685c.094.158.261.247.432.247z%22%20transform%3D%22matrix%28-1%200%200%201%2058%200%29%22%20fill%3D%22%233bb300%22/%3E%3Cpath%20d%3D%22M.3%2021.86V10.18q0-.46.02-.68.04-.22.18-.5.28-.54%201.34-.54%201.06%200%201.42.28.38.26.44.78.76-1.04%202.38-1.04%201.64%200%203.1%201.54%201.46%201.54%201.46%203.58%200%202.04-1.46%203.58-1.44%201.54-3.08%201.54-1.64%200-2.38-.92v4.04q0%20.46-.04.68-.02.22-.18.5-.14.3-.5.42-.36.12-.98.12-.62%200-1-.12-.36-.12-.52-.4-.14-.28-.18-.5-.02-.22-.02-.68zm3.96-9.42q-.46.54-.46%201.18%200%20.64.46%201.18.48.52%201.2.52.74%200%201.24-.52.52-.52.52-1.18%200-.66-.48-1.18-.48-.54-1.26-.54-.76%200-1.22.54zm14.741-8.36q.16-.3.54-.42.38-.12%201-.12.64%200%201.02.12.38.12.52.42.16.3.18.54.04.22.04.68v11.94q0%20.46-.04.7-.02.22-.18.5-.3.54-1.7.54-1.38%200-1.54-.98-.84.96-2.34.96-1.8%200-3.28-1.56-1.48-1.58-1.48-3.66%200-2.1%201.48-3.68%201.5-1.58%203.28-1.58%201.48%200%202.3%201v-4.2q0-.46.02-.68.04-.24.18-.52zm-3.24%2010.86q.52.54%201.26.54.74%200%201.22-.54.5-.54.5-1.18%200-.66-.48-1.22-.46-.56-1.26-.56-.8%200-1.28.56-.48.54-.48%201.2%200%20.66.52%201.2zm7.833-1.2q0-2.4%201.68-3.96%201.68-1.56%203.84-1.56%202.16%200%203.82%201.56%201.66%201.54%201.66%203.94%200%201.66-.86%202.96-.86%201.28-2.1%201.9-1.22.6-2.54.6-1.32%200-2.56-.64-1.24-.66-2.1-1.92-.84-1.28-.84-2.88zm4.18%201.44q.64.48%201.3.48.66%200%201.32-.5.66-.5.66-1.48%200-.98-.62-1.46-.62-.48-1.34-.48-.72%200-1.34.5-.62.5-.62%201.48%200%20.96.64%201.46zm11.412-1.44q0%20.84.56%201.32.56.46%201.18.46.64%200%201.18-.36.56-.38.9-.38.6%200%201.46%201.06.46.58.46%201.04%200%20.76-1.1%201.42-1.14.8-2.8.8-1.86%200-3.58-1.34-.82-.64-1.34-1.7-.52-1.08-.52-2.36%200-1.3.52-2.34.52-1.06%201.34-1.7%201.66-1.32%203.54-1.32.76%200%201.48.22.72.2%201.06.4l.32.2q.36.24.56.38.52.4.52.92%200%20.5-.42%201.14-.72%201.1-1.38%201.1-.38%200-1.08-.44-.36-.34-1.04-.34-.66%200-1.24.48-.58.48-.58%201.34z%22%20fill%3D%22green%22/%3E%3C/svg%3E"/>
11
11
  <!-- build env - Package Name = "spotifywebapiPython" -->
12
- <!-- build env - Package Version = "1.0.42" -->
12
+ <!-- build env - Package Version = "1.0.43" -->
13
13
  <!-- pdoc module.modulename = "spotifywebapipython.spotifywebapiauthenticationerror" -->
14
14
  <!-- pdoc module.is_package = "False" -->
15
15
  <!-- pdoc root_module_name = "None" -->
@@ -74,7 +74,7 @@
74
74
 
75
75
  <footer class="footertext">
76
76
  spotifywebapiPython</br>
77
- Version 1.0.42</br>
77
+ Version 1.0.43</br>
78
78
  <a href="https://developer.spotify.com/documentation/web-api" target="_blank">
79
79
  <img src="../spotifywebapipython.ico" alt="brand icon" style="width:32px; height:32px; padding:4px;"/>
80
80
  A Spotify Web Api Client
spotifywebapipython/docs/spotifywebapiPython/spotifywebapierror.html CHANGED
@@ -9,7 +9,7 @@
9
9
  </title>
10
10
  <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A//www.w3.org/2000/svg%22%20role%3D%22img%22%20aria-label%3D%22pdoc%20logo%22%20width%3D%22300%22%20height%3D%22150%22%20viewBox%3D%22-1%200%2060%2030%22%3E%3Ctitle%3Epdoc%3C/title%3E%3Cpath%20d%3D%22M29.621%2021.293c-.011-.273-.214-.475-.511-.481a.5.5%200%200%200-.489.503l-.044%201.393c-.097.551-.695%201.215-1.566%201.704-.577.428-1.306.486-2.193.182-1.426-.617-2.467-1.654-3.304-2.487l-.173-.172a3.43%203.43%200%200%200-.365-.306.49.49%200%200%200-.286-.196c-1.718-1.06-4.931-1.47-7.353.191l-.219.15c-1.707%201.187-3.413%202.131-4.328%201.03-.02-.027-.49-.685-.141-1.763.233-.721.546-2.408.772-4.076.042-.09.067-.187.046-.288.166-1.347.277-2.625.241-3.351%201.378-1.008%202.271-2.586%202.271-4.362%200-.976-.272-1.935-.788-2.774-.057-.094-.122-.18-.184-.268.033-.167.052-.339.052-.516%200-1.477-1.202-2.679-2.679-2.679-.791%200-1.496.352-1.987.9a6.3%206.3%200%200%200-1.001.029c-.492-.564-1.207-.929-2.012-.929-1.477%200-2.679%201.202-2.679%202.679A2.65%202.65%200%200%200%20.97%206.554c-.383.747-.595%201.572-.595%202.41%200%202.311%201.507%204.29%203.635%205.107-.037.699-.147%202.27-.423%203.294l-.137.461c-.622%202.042-2.515%208.257%201.727%2010.643%201.614.908%203.06%201.248%204.317%201.248%202.665%200%204.492-1.524%205.322-2.401%201.476-1.559%202.886-1.854%206.491.82%201.877%201.393%203.514%201.753%204.861%201.068%202.223-1.713%202.811-3.867%203.399-6.374.077-.846.056-1.469.054-1.537zm-4.835%204.313c-.054.305-.156.586-.242.629-.034-.007-.131-.022-.307-.157-.145-.111-.314-.478-.456-.908.221.121.432.25.675.355.115.039.219.051.33.081zm-2.251-1.238c-.05.33-.158.648-.252.694-.022.001-.125-.018-.307-.157-.217-.166-.488-.906-.639-1.573.358.344.754.693%201.198%201.036zm-3.887-2.337c-.006-.116-.018-.231-.041-.342.635.145%201.189.368%201.599.625.097.231.166.481.174.642-.03.049-.055.101-.067.158-.046.013-.128.026-.298.004-.278-.037-.901-.57-1.367-1.087zm-1.127-.497c.116.306.176.625.12.71-.019.014-.117.045-.345.016-.206-.027-.604-.332-.986-.695.41-.051.816-.056%201.211-.031zm-4.535%201.535c.209.22.379.47.358.598-.006.041-.088.138-.351.234-.144.055-.539-.063-.979-.259a11.66%2011.66%200%200%200%20.972-.573zm.983-.664c.359-.237.738-.418%201.126-.554.25.237.479.548.457.694-.006.042-.087.138-.351.235-.174.064-.694-.105-1.232-.375zm-3.381%201.794c-.022.145-.061.29-.149.401-.133.166-.358.248-.69.251h-.002c-.133%200-.306-.26-.45-.621.417.091.854.07%201.291-.031zm-2.066-8.077a4.78%204.78%200%200%201-.775-.584c.172-.115.505-.254.88-.378l-.105.962zm-.331%202.302a10.32%2010.32%200%200%201-.828-.502c.202-.143.576-.328.984-.49l-.156.992zm-.45%202.157l-.701-.403c.214-.115.536-.249.891-.376a11.57%2011.57%200%200%201-.19.779zm-.181%201.716c.064.398.194.702.298.893-.194-.051-.435-.162-.736-.398.061-.119.224-.3.438-.495zM8.87%204.141c0%20.152-.123.276-.276.276s-.275-.124-.275-.276.123-.276.276-.276.275.124.275.276zm-.735-.389a1.15%201.15%200%200%200-.314.783%201.16%201.16%200%200%200%201.162%201.162c.457%200%20.842-.27%201.032-.653.026.117.042.238.042.362a1.68%201.68%200%200%201-1.679%201.679%201.68%201.68%200%200%201-1.679-1.679c0-.843.626-1.535%201.436-1.654zM5.059%205.406A1.68%201.68%200%200%201%203.38%207.085a1.68%201.68%200%200%201-1.679-1.679c0-.037.009-.072.011-.109.21.3.541.508.935.508a1.16%201.16%200%200%200%201.162-1.162%201.14%201.14%200%200%200-.474-.912c.015%200%20.03-.005.045-.005.926.001%201.679.754%201.679%201.68zM3.198%204.141c0%20.152-.123.276-.276.276s-.275-.124-.275-.276.123-.276.276-.276.275.124.275.276zM1.375%208.964c0-.52.103-1.035.288-1.52.466.394%201.06.64%201.717.64%201.144%200%202.116-.725%202.499-1.738.383%201.012%201.355%201.738%202.499%201.738.867%200%201.631-.421%202.121-1.062.307.605.478%201.267.478%201.942%200%202.486-2.153%204.51-4.801%204.51s-4.801-2.023-4.801-4.51zm24.342%2019.349c-.985.498-2.267.168-3.813-.979-3.073-2.281-5.453-3.199-7.813-.705-1.315%201.391-4.163%203.365-8.423.97-3.174-1.786-2.239-6.266-1.261-9.479l.146-.492c.276-1.02.395-2.457.444-3.268a6.11%206.11%200%200%200%201.18.115%206.01%206.01%200%200%200%202.536-.562l-.006.175c-.802.215-1.848.612-2.021%201.25-.079.295.021.601.274.837.219.203.415.364.598.501-.667.304-1.243.698-1.311%201.179-.02.144-.022.507.393.787.213.144.395.26.564.365-1.285.521-1.361.96-1.381%201.126-.018.142-.011.496.427.746l.854.489c-.473.389-.971.914-.999%201.429-.018.278.095.532.316.713.675.556%201.231.721%201.653.721.059%200%20.104-.014.158-.02.207.707.641%201.64%201.513%201.64h.013c.8-.008%201.236-.345%201.462-.626.173-.216.268-.457.325-.692.424.195.93.374%201.372.374.151%200%20.294-.021.423-.068.732-.27.944-.704.993-1.021.009-.061.003-.119.002-.179.266.086.538.147.789.147.15%200%20.294-.021.423-.069.542-.2.797-.489.914-.754.237.147.478.258.704.288.106.014.205.021.296.021.356%200%20.595-.101.767-.229.438.435%201.094.992%201.656%201.067.106.014.205.021.296.021a1.56%201.56%200%200%200%20.323-.035c.17.575.453%201.289.866%201.605.358.273.665.362.914.362a.99.99%200%200%200%20.421-.093%201.03%201.03%200%200%200%20.245-.164c.168.428.39.846.68%201.068.358.273.665.362.913.362a.99.99%200%200%200%20.421-.093c.317-.148.512-.448.639-.762.251.157.495.257.726.257.127%200%20.25-.024.37-.071.427-.17.706-.617.841-1.314.022-.015.047-.022.068-.038.067-.051.133-.104.196-.159-.443%201.486-1.107%202.761-2.086%203.257zM8.66%209.925a.5.5%200%201%200-1%200c0%20.653-.818%201.205-1.787%201.205s-1.787-.552-1.787-1.205a.5.5%200%201%200-1%200c0%201.216%201.25%202.205%202.787%202.205s2.787-.989%202.787-2.205zm4.4%2015.965l-.208.097c-2.661%201.258-4.708%201.436-6.086.527-1.542-1.017-1.88-3.19-1.844-4.198a.4.4%200%200%200-.385-.414c-.242-.029-.406.164-.414.385-.046%201.249.367%203.686%202.202%204.896.708.467%201.547.7%202.51.7%201.248%200%202.706-.392%204.362-1.174l.185-.086a.4.4%200%200%200%20.205-.527c-.089-.204-.326-.291-.527-.206zM9.547%202.292c.093.077.205.114.317.114a.5.5%200%200%200%20.318-.886L8.817.397a.5.5%200%200%200-.703.068.5.5%200%200%200%20.069.703l1.364%201.124zm-7.661-.065c.086%200%20.173-.022.253-.068l1.523-.893a.5.5%200%200%200-.506-.863l-1.523.892a.5.5%200%200%200-.179.685c.094.158.261.247.432.247z%22%20transform%3D%22matrix%28-1%200%200%201%2058%200%29%22%20fill%3D%22%233bb300%22/%3E%3Cpath%20d%3D%22M.3%2021.86V10.18q0-.46.02-.68.04-.22.18-.5.28-.54%201.34-.54%201.06%200%201.42.28.38.26.44.78.76-1.04%202.38-1.04%201.64%200%203.1%201.54%201.46%201.54%201.46%203.58%200%202.04-1.46%203.58-1.44%201.54-3.08%201.54-1.64%200-2.38-.92v4.04q0%20.46-.04.68-.02.22-.18.5-.14.3-.5.42-.36.12-.98.12-.62%200-1-.12-.36-.12-.52-.4-.14-.28-.18-.5-.02-.22-.02-.68zm3.96-9.42q-.46.54-.46%201.18%200%20.64.46%201.18.48.52%201.2.52.74%200%201.24-.52.52-.52.52-1.18%200-.66-.48-1.18-.48-.54-1.26-.54-.76%200-1.22.54zm14.741-8.36q.16-.3.54-.42.38-.12%201-.12.64%200%201.02.12.38.12.52.42.16.3.18.54.04.22.04.68v11.94q0%20.46-.04.7-.02.22-.18.5-.3.54-1.7.54-1.38%200-1.54-.98-.84.96-2.34.96-1.8%200-3.28-1.56-1.48-1.58-1.48-3.66%200-2.1%201.48-3.68%201.5-1.58%203.28-1.58%201.48%200%202.3%201v-4.2q0-.46.02-.68.04-.24.18-.52zm-3.24%2010.86q.52.54%201.26.54.74%200%201.22-.54.5-.54.5-1.18%200-.66-.48-1.22-.46-.56-1.26-.56-.8%200-1.28.56-.48.54-.48%201.2%200%20.66.52%201.2zm7.833-1.2q0-2.4%201.68-3.96%201.68-1.56%203.84-1.56%202.16%200%203.82%201.56%201.66%201.54%201.66%203.94%200%201.66-.86%202.96-.86%201.28-2.1%201.9-1.22.6-2.54.6-1.32%200-2.56-.64-1.24-.66-2.1-1.92-.84-1.28-.84-2.88zm4.18%201.44q.64.48%201.3.48.66%200%201.32-.5.66-.5.66-1.48%200-.98-.62-1.46-.62-.48-1.34-.48-.72%200-1.34.5-.62.5-.62%201.48%200%20.96.64%201.46zm11.412-1.44q0%20.84.56%201.32.56.46%201.18.46.64%200%201.18-.36.56-.38.9-.38.6%200%201.46%201.06.46.58.46%201.04%200%20.76-1.1%201.42-1.14.8-2.8.8-1.86%200-3.58-1.34-.82-.64-1.34-1.7-.52-1.08-.52-2.36%200-1.3.52-2.34.52-1.06%201.34-1.7%201.66-1.32%203.54-1.32.76%200%201.48.22.72.2%201.06.4l.32.2q.36.24.56.38.52.4.52.92%200%20.5-.42%201.14-.72%201.1-1.38%201.1-.38%200-1.08-.44-.36-.34-1.04-.34-.66%200-1.24.48-.58.48-.58%201.34z%22%20fill%3D%22green%22/%3E%3C/svg%3E"/>
11
11
  <!-- build env - Package Name = "spotifywebapiPython" -->
12
- <!-- build env - Package Version = "1.0.42" -->
12
+ <!-- build env - Package Version = "1.0.43" -->
13
13
  <!-- pdoc module.modulename = "spotifywebapipython.spotifywebapierror" -->
14
14
  <!-- pdoc module.is_package = "False" -->
15
15
  <!-- pdoc root_module_name = "None" -->
@@ -71,7 +71,7 @@
71
71
 
72
72
  <footer class="footertext">
73
73
  spotifywebapiPython</br>
74
- Version 1.0.42</br>
74
+ Version 1.0.43</br>
75
75
  <a href="https://developer.spotify.com/documentation/web-api" target="_blank">
76
76
  <img src="../spotifywebapipython.ico" alt="brand icon" style="width:32px; height:32px; padding:4px;"/>
77
77
  A Spotify Web Api Client
spotifywebapipython/spotifyclient.py CHANGED
@@ -793,9 +793,10 @@ class SpotifyClient:
793
793
  The uri of the item to add to the queue; must be a track or an episode uri.
794
794
  Example: `spotify:track:4iV5W9uYEdYUVa79Axb7Rh`
795
795
  deviceId (str):
796
- The id of the device this command is targeting.
796
+ The id or name of the device this command is targeting.
797
797
  If not supplied, the user's currently active device is the target.
798
- Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
798
+ Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
799
+ Example: `Web Player (Chrome)`
799
800
 
800
801
  Raises:
801
802
  SpotifyWebApiError:
@@ -826,6 +827,10 @@ class SpotifyClient:
826
827
  apiMethodParms.AppendKeyValue("deviceId", deviceId)
827
828
  _logsi.LogMethodParmList(SILevel.Verbose, "Add item to playback queue", apiMethodParms)
828
829
 
830
+ # check for device name; convert to an id if a name was supplied.
831
+ deviceId = self.PlayerConvertDeviceNameToId(deviceId)
832
+
833
+ # build spotify web api request parameters.
829
834
  urlParms:dict = \
830
835
  {
831
836
  'uri': uri
@@ -5826,7 +5831,7 @@ class SpotifyClient:
5826
5831
  result = item
5827
5832
  break
5828
5833
 
5829
- # if no match by id, then try to macth by device name.
5834
+ # if no match by id, then try to match by device name.
5830
5835
  if result is None:
5831
5836
  for item in devices:
5832
5837
  if deviceId == item.Name.lower():
@@ -5850,6 +5855,115 @@ class SpotifyClient:
5850
5855
  _logsi.LeaveMethod(SILevel.Debug, apiMethodName)
5851
5856
 
5852
5857
 
5858
+ def PlayerConvertDeviceNameToId(self,
5859
+ value:str,
5860
+ refresh:bool=False
5861
+ ) -> str:
5862
+ """
5863
+ Converts a Spotify Connect player device name to it's equivalent id value if
5864
+ the value is a device name. If the value is a device id, then the value is
5865
+ returned as-is.
5866
+
5867
+ This method requires the `user-read-playback-state` scope.
5868
+
5869
+ Args:
5870
+ value (str):
5871
+ The device id or name value to check.
5872
+ refresh (bool):
5873
+ True to resolve the device real-time from the spotify web api device list;
5874
+ otherwise, False (default) to use the cached device list to resolve the device.
5875
+
5876
+ Returns:
5877
+ One of the following:
5878
+ - if value is a device id, then the value is returned as-is; no device list
5879
+ lookup is performed, and the value is assumed to be a valid device id.
5880
+ - if value is not a device id, then it is assumed to be a name; a device list
5881
+ lookup is performed to retrieve it's device id. if found, then the id is
5882
+ returned; otherwise, the value is returned as-is with the understanding that
5883
+ subsequent operations will fail since it's not in the device list.
5884
+
5885
+ Raises:
5886
+ SpotifyWebApiError:
5887
+ If the Spotify Web API request was for a non-authorization service
5888
+ and the response contains error information.
5889
+ SpotifApiError:
5890
+ If the method fails for any other reason.
5891
+
5892
+ The id for the first match found on the device name will be returned if multiple devices
5893
+ are found in the Spotify Connect player device list that have the same name (with different
5894
+ id's). Care should be taken to make device names unique if using device names for
5895
+ methods that require a device id or name.
5896
+
5897
+ If the `refresh` argument is specified, then the `ConfigurationCache` is updated with
5898
+ the latest Spotify Connect player device list. Use the `refresh` argument (with False
5899
+ value) to retrieve the cached value and avoid the spotify web api request. This results
5900
+ in better performance.
5901
+
5902
+ <details>
5903
+ <summary>Sample Code</summary>
5904
+ ```python
5905
+ .. include:: ../docs/include/samplecode/SpotifyClient/PlayerConvertDeviceNameToId.py
5906
+ ```
5907
+ </details>
5908
+ """
5909
+ apiMethodName:str = 'PlayerConvertDeviceNameToId'
5910
+ apiMethodParms:SIMethodParmListContext = None
5911
+
5912
+ try:
5913
+
5914
+ # trace.
5915
+ apiMethodParms = _logsi.EnterMethodParmList(SILevel.Debug, apiMethodName)
5916
+ apiMethodParms.AppendKeyValue("value", value)
5917
+ apiMethodParms.AppendKeyValue("refresh", refresh)
5918
+ _logsi.LogMethodParmList(SILevel.Verbose, "Checking Spotify Connect Player device for name", apiMethodParms)
5919
+
5920
+ # if nothing specified then just use it as-is.
5921
+ if (value is None) or (len(value.strip()) == 0):
5922
+ _logsi.LogVerbose("Device ID not specified; active device will be used")
5923
+ return value
5924
+
5925
+ try:
5926
+
5927
+ # is this a hex string value?
5928
+ intValue:int = int(str(value), 16)
5929
+
5930
+ # if it IS a hex string, then it should have been converted to a number.
5931
+ # at this point we can assume it's a device id. in this case, just return it.
5932
+ # note that we will NOT perform a lookup in the device list
5933
+ _logsi.LogVerbose("Device id '%s' was specified, and will be used as-is" % value)
5934
+ if intValue is not None:
5935
+ return value
5936
+ return value
5937
+
5938
+ except Exception:
5939
+
5940
+ # the above will fail if it's a device name.
5941
+ pass
5942
+
5943
+ # try resolving the device name to a device id value.
5944
+ device:Device = self.GetPlayerDevice(value, refresh)
5945
+ if device is not None:
5946
+ _logsi.LogVerbose("Converted device name '%s' to device id '%s'" % (value, device.Id))
5947
+ return device.Id
5948
+
5949
+ # if a name could not be found in the Spotify Connect Player devices then just
5950
+ # return the value as-is.
5951
+ _logsi.LogVerbose("Device name '%s' could not be found in the Spotify Connect Device list; subsequent actions will probably fail using this device name" % value)
5952
+ return value
5953
+
5954
+ except SpotifyWebApiError: raise # pass handled exceptions on thru
5955
+ except SpotifyWebApiAuthenticationError: raise # pass handled exceptions on thru
5956
+ except Exception as ex:
5957
+
5958
+ # format unhandled exception.
5959
+ raise SpotifyApiError(SAAppMessages.UNHANDLED_EXCEPTION.format(apiMethodName, str(ex)), ex, logsi=_logsi)
5960
+
5961
+ finally:
5962
+
5963
+ # trace.
5964
+ _logsi.LeaveMethod(SILevel.Debug, apiMethodName)
5965
+
5966
+
5853
5967
  def GetPlayerDevices(self,
5854
5968
  refresh:bool=True
5855
5969
  ) -> list[Device]:
@@ -8868,9 +8982,10 @@ class SpotifyClient:
8868
8982
 
8869
8983
  Args:
8870
8984
  deviceId (str):
8871
- The id of the device this command is targeting.
8985
+ The id or name of the device this command is targeting.
8872
8986
  If not supplied, the user's currently active device is the target.
8873
- Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
8987
+ Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
8988
+ Example: `Web Player (Chrome)`
8874
8989
  delay (float):
8875
8990
  Time delay (in seconds) to wait AFTER issuing the command to the player.
8876
8991
  This delay will give the spotify web api time to process the change before
@@ -8909,6 +9024,9 @@ class SpotifyClient:
8909
9024
  # validations.
8910
9025
  delay = self._ValidateDelay(delay, 0.50, 10)
8911
9026
 
9027
+ # check for device name; convert to an id if a name was supplied.
9028
+ deviceId = self.PlayerConvertDeviceNameToId(deviceId)
9029
+
8912
9030
  # build spotify web api request parameters.
8913
9031
  urlParms:dict = {}
8914
9032
  if deviceId is not None:
@@ -8979,9 +9097,10 @@ class SpotifyClient:
8979
9097
  Default is `0`.
8980
9098
  Example: `25000`
8981
9099
  deviceId (str):
8982
- The id of the device this command is targeting.
9100
+ The id or name of the device this command is targeting.
8983
9101
  If not supplied, the user's currently active device is the target.
8984
- Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9102
+ Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9103
+ Example: `Web Player (Chrome)`
8985
9104
  delay (float):
8986
9105
  Time delay (in seconds) to wait AFTER issuing the command to the player.
8987
9106
  This delay will give the spotify web api time to process the change before
@@ -9038,6 +9157,9 @@ class SpotifyClient:
9038
9157
  # validations.
9039
9158
  delay = self._ValidateDelay(delay, 0.50, 10)
9040
9159
 
9160
+ # check for device name; convert to an id if a name was supplied.
9161
+ deviceId = self.PlayerConvertDeviceNameToId(deviceId)
9162
+
9041
9163
  # build spotify web api request parameters.
9042
9164
  reqData:dict = \
9043
9165
  {
@@ -9093,9 +9215,10 @@ class SpotifyClient:
9093
9215
 
9094
9216
  Args:
9095
9217
  deviceId (str):
9096
- The id of the device this command is targeting.
9218
+ The id or name of the device this command is targeting.
9097
9219
  If not supplied, the user's currently active device is the target.
9098
- Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9220
+ Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9221
+ Example: `Web Player (Chrome)`
9099
9222
  shuffle (bool):
9100
9223
  True to set player shuffle mode to on; otherwise, False for no shuffle.
9101
9224
  delay (float):
@@ -9150,6 +9273,9 @@ class SpotifyClient:
9150
9273
  for trackSaved in tracks.Items:
9151
9274
  arrUris.append(trackSaved.Track.Uri)
9152
9275
 
9276
+ # check for device name; convert to an id if a name was supplied.
9277
+ deviceId = self.PlayerConvertDeviceNameToId(deviceId)
9278
+
9153
9279
  # set desired shuffle mode.
9154
9280
  self.PlayerSetShuffleMode(shuffle, deviceId, delay)
9155
9281
 
@@ -9198,9 +9324,10 @@ class SpotifyClient:
9198
9324
  Default is `0`.
9199
9325
  Example: `25000`
9200
9326
  deviceId (str):
9201
- The id of the device this command is targeting.
9327
+ The id or name of the device this command is targeting.
9202
9328
  If not supplied, the user's currently active device is the target.
9203
- Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9329
+ Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9330
+ Example: `Web Player (Chrome)`
9204
9331
  delay (float):
9205
9332
  Time delay (in seconds) to wait AFTER issuing the command to the player.
9206
9333
  This delay will give the spotify web api time to process the change before
@@ -9251,6 +9378,9 @@ class SpotifyClient:
9251
9378
  for idx in range(0, len(arrUris)):
9252
9379
  arrUris[idx] = arrUris[idx].strip()
9253
9380
 
9381
+ # check for device name; convert to an id if a name was supplied.
9382
+ deviceId = self.PlayerConvertDeviceNameToId(deviceId)
9383
+
9254
9384
  # build spotify web api request parameters.
9255
9385
  reqData:dict = \
9256
9386
  {
@@ -9303,9 +9433,10 @@ class SpotifyClient:
9303
9433
 
9304
9434
  Args:
9305
9435
  deviceId (str):
9306
- The id of the device this command is targeting.
9436
+ The id or name of the device this command is targeting.
9307
9437
  If not supplied, the user's currently active device is the target.
9308
- Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9438
+ Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9439
+ Example: `Web Player (Chrome)`
9309
9440
  delay (float):
9310
9441
  Time delay (in seconds) to wait AFTER issuing the command to the player.
9311
9442
  This delay will give the spotify web api time to process the change before
@@ -9344,6 +9475,9 @@ class SpotifyClient:
9344
9475
  # validations.
9345
9476
  delay = self._ValidateDelay(delay, 0.50, 10)
9346
9477
 
9478
+ # check for device name; convert to an id if a name was supplied.
9479
+ deviceId = self.PlayerConvertDeviceNameToId(deviceId)
9480
+
9347
9481
  # build spotify web api request parameters.
9348
9482
  urlParms:dict = {}
9349
9483
  if deviceId is not None:
@@ -9395,9 +9529,10 @@ class SpotifyClient:
9395
9529
  player to start playing the next song.
9396
9530
  Example: `25000`
9397
9531
  deviceId (str):
9398
- The id of the device this command is targeting.
9532
+ The id or name of the device this command is targeting.
9399
9533
  If not supplied, the user's currently active device is the target.
9400
- Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9534
+ Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9535
+ Example: `Web Player (Chrome)`
9401
9536
  delay (float):
9402
9537
  Time delay (in seconds) to wait AFTER issuing the command to the player.
9403
9538
  This delay will give the spotify web api time to process the change before
@@ -9437,6 +9572,9 @@ class SpotifyClient:
9437
9572
  # validations.
9438
9573
  delay = self._ValidateDelay(delay, 0.50, 10)
9439
9574
 
9575
+ # check for device name; convert to an id if a name was supplied.
9576
+ deviceId = self.PlayerConvertDeviceNameToId(deviceId)
9577
+
9440
9578
  # build spotify web api request parameters.
9441
9579
  urlParms:dict = \
9442
9580
  {
@@ -9484,9 +9622,10 @@ class SpotifyClient:
9484
9622
 
9485
9623
  Args:
9486
9624
  deviceId (str):
9487
- The id of the device this command is targeting.
9625
+ The id or name of the device this command is targeting.
9488
9626
  If not supplied, the user's currently active device is the target.
9489
- Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9627
+ Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9628
+ Example: `Web Player (Chrome)`
9490
9629
  delay (float):
9491
9630
  Time delay (in seconds) to wait AFTER issuing the command to the player.
9492
9631
  This delay will give the spotify web api time to process the change before
@@ -9525,6 +9664,9 @@ class SpotifyClient:
9525
9664
  # validations.
9526
9665
  delay = self._ValidateDelay(delay, 0.50, 10)
9527
9666
 
9667
+ # check for device name; convert to an id if a name was supplied.
9668
+ deviceId = self.PlayerConvertDeviceNameToId(deviceId)
9669
+
9528
9670
  # build spotify web api request parameters.
9529
9671
  urlParms:dict = {}
9530
9672
  if deviceId is not None:
@@ -9569,9 +9711,10 @@ class SpotifyClient:
9569
9711
 
9570
9712
  Args:
9571
9713
  deviceId (str):
9572
- The id of the device this command is targeting.
9714
+ The id or name of the device this command is targeting.
9573
9715
  If not supplied, the user's currently active device is the target.
9574
- Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9716
+ Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9717
+ Example: `Web Player (Chrome)`
9575
9718
  delay (float):
9576
9719
  Time delay (in seconds) to wait AFTER issuing the command to the player.
9577
9720
  This delay will give the spotify web api time to process the change before
@@ -9610,6 +9753,9 @@ class SpotifyClient:
9610
9753
  # validations.
9611
9754
  delay = self._ValidateDelay(delay, 0.50, 10)
9612
9755
 
9756
+ # check for device name; convert to an id if a name was supplied.
9757
+ deviceId = self.PlayerConvertDeviceNameToId(deviceId)
9758
+
9613
9759
  # build spotify web api request parameters.
9614
9760
  urlParms:dict = {}
9615
9761
  if deviceId is not None:
@@ -9661,9 +9807,10 @@ class SpotifyClient:
9661
9807
  - `off` - will turn repeat off.
9662
9808
  Default: `off`
9663
9809
  deviceId (str):
9664
- The id of the device this command is targeting.
9810
+ The id or name of the device this command is targeting.
9665
9811
  If not supplied, the user's currently active device is the target.
9666
- Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9812
+ Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9813
+ Example: `Web Player (Chrome)`
9667
9814
  delay (float):
9668
9815
  Time delay (in seconds) to wait AFTER issuing the command to the player.
9669
9816
  This delay will give the spotify web api time to process the change before
@@ -9703,6 +9850,9 @@ class SpotifyClient:
9703
9850
  # validations.
9704
9851
  delay = self._ValidateDelay(delay, 0.50, 10)
9705
9852
 
9853
+ # check for device name; convert to an id if a name was supplied.
9854
+ deviceId = self.PlayerConvertDeviceNameToId(deviceId)
9855
+
9706
9856
  # build spotify web api request parameters.
9707
9857
  urlParms:dict = \
9708
9858
  {
@@ -9756,9 +9906,10 @@ class SpotifyClient:
9756
9906
  - `False` - Do not shuffle user's playback.
9757
9907
  Default: `False`
9758
9908
  deviceId (str):
9759
- The id of the device this command is targeting.
9909
+ The id or name of the device this command is targeting.
9760
9910
  If not supplied, the user's currently active device is the target.
9761
- Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9911
+ Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
9912
+ Example: `Web Player (Chrome)`
9762
9913
  delay (float):
9763
9914
  Time delay (in seconds) to wait AFTER issuing the command to the player.
9764
9915
  This delay will give the spotify web api time to process the change before
@@ -9798,6 +9949,9 @@ class SpotifyClient:
9798
9949
  # validations.
9799
9950
  delay = self._ValidateDelay(delay, 0.50, 10)
9800
9951
 
9952
+ # check for device name; convert to an id if a name was supplied.
9953
+ deviceId = self.PlayerConvertDeviceNameToId(deviceId)
9954
+
9801
9955
  # build spotify web api request parameters.
9802
9956
  urlParms:dict = \
9803
9957
  {
@@ -9850,9 +10004,10 @@ class SpotifyClient:
9850
10004
  Must be a value from 0 to 100 inclusive.
9851
10005
  Example: `50`
9852
10006
  deviceId (str):
9853
- The id of the device this command is targeting.
10007
+ The id or name of the device this command is targeting.
9854
10008
  If not supplied, the user's currently active device is the target.
9855
- Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
10009
+ Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
10010
+ Example: `Web Player (Chrome)`
9856
10011
  delay (float):
9857
10012
  Time delay (in seconds) to wait AFTER issuing the command to the player.
9858
10013
  This delay will give the spotify web api time to process the change before
@@ -9892,6 +10047,9 @@ class SpotifyClient:
9892
10047
  # validations.
9893
10048
  delay = self._ValidateDelay(delay, 0.50, 10)
9894
10049
 
10050
+ # check for device name; convert to an id if a name was supplied.
10051
+ deviceId = self.PlayerConvertDeviceNameToId(deviceId)
10052
+
9895
10053
  # build spotify web api request parameters.
9896
10054
  urlParms:dict = \
9897
10055
  {
@@ -9940,8 +10098,9 @@ class SpotifyClient:
9940
10098
 
9941
10099
  Args:
9942
10100
  deviceId (str):
9943
- The id of the device on which playback should be started/transferred.
9944
- Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
10101
+ The id or name of the device on which playback should be started/transferred.
10102
+ Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
10103
+ Example: `Web Player (Chrome)`
9945
10104
  play (bool):
9946
10105
  The transfer method:
9947
10106
  - `True` - ensure playback happens on new device.
@@ -9985,6 +10144,9 @@ class SpotifyClient:
9985
10144
 
9986
10145
  # validations.
9987
10146
  delay = self._ValidateDelay(delay, 0.50, 10)
10147
+
10148
+ # check for device name; convert to an id if a name was supplied.
10149
+ deviceId = self.PlayerConvertDeviceNameToId(deviceId)
9988
10150
 
9989
10151
  # build spotify web api request parameters.
9990
10152
  reqData:dict = \
@@ -10038,8 +10200,8 @@ class SpotifyClient:
10038
10200
  Args:
10039
10201
  defaultDeviceId (str):
10040
10202
  The id of the device on which playback should be started/transferred if there is
10041
- currently no active device.
10042
- Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
10203
+ currently no active device.
10204
+ Example: `0d1841b0976bae2a3a310dd74c0f3df354899bc8`
10043
10205
  play (bool):
10044
10206
  The transfer method:
10045
10207
  - `True` - ensure playback happens on new device.