1# IAudioRender 2 3 4## 概述 5 6AudioRender音频播放接口。 7 8提供音频播放支持的驱动能力，包括音频控制、音频属性、音频场景、音频音量、获取硬件延迟时间、播放音频帧数据等。 9 10**Since:** 11 123.2 13 14**Version:** 15 161.0 17 18**相关模块:** 19 20[Audio](_audio.md) 21 22 23## 汇总 24 25 26### Public 成员函数 27 28 | 名称 | 描述 | 29| -------- | -------- | 30| [GetLatency](#getlatency) ([out] unsigned int ms) | 获取音频硬件驱动的延迟时间。 | 31| [RenderFrame](#renderframe) ([in] byte[] frame, [out] unsigned long replyBytes) | 向音频驱动中播放一帧输出数据（放音，音频下行数据）。 | 32| [GetRenderPosition](#getrenderposition) ([out] unsigned long frames, [out] struct [AudioTimeStamp](_audio_time_stamp.md) time) | 获取音频已输出的帧数。 | 33| [SetRenderSpeed](#setrenderspeed) ([in] float speed) | 设置一个音频的播放速度。 | 34| [GetRenderSpeed](#getrenderspeed) ([out] float speed) | 获取一个音频当前的播放速度。 | 35| [SetChannelMode](#setchannelmode) ([in] enum [AudioChannelMode](_audio.md#audiochannelmode) mode) | 设置音频播放的通道模式。 | 36| [GetChannelMode](#getchannelmode) ([out] enum [AudioChannelMode](_audio.md#audiochannelmode) mode) | 获取音频播放当前的通道模式。 | 37| [RegCallback](#regcallback) ([in] [IAudioCallback](interface_i_audio_callback.md) audioCallback, [in] byte cookie) | 注册音频回调函数，用于放音过程中缓冲区数据写、DrainBuffer完成通知。 | 38| [DrainBuffer](#drainbuffer) ([out] enum [AudioDrainNotifyType](_audio.md#audiodrainnotifytype) type) | 排空缓冲区中的数据。 | 39| [IsSupportsDrain](#issupportsdrain) ([out] boolean support) | 判断是否支持清空缓冲区数据的功能。 | 40| [CheckSceneCapability](#checkscenecapability) ([in] struct [AudioSceneDescriptor](_audio_scene_descriptor.md) scene, [out] boolean supported) | 是否支持某个音频场景的配置。 | 41| [SelectScene](#selectscene) ([in] struct [AudioSceneDescriptor](_audio_scene_descriptor.md) scene) | 选择音频场景。 | 42| [SetMute](#setmute) ([in] boolean mute) | 设置音频的静音状态。 | 43| [GetMute](#getmute) ([out] boolean mute) | 获取音频的静音状态。 | 44| [SetVolume](#setvolume) ([in] float volume) | 设置一个音频流的音量。 | 45| [GetVolume](#getvolume) ([out] float volume) | 获取一个音频流的音量。 | 46| [GetGainThreshold](#getgainthreshold) ([out] float min, [out] float max) | 获取音频流增益的阈值。 | 47| [GetGain](#getgain) ([out] float gain) | 获取音频流的增益。 | 48| [SetGain](#setgain) ([in] float gain) | 设置音频流的增益。 | 49| [GetFrameSize](#getframesize) ([out] unsigned long size) | 获取音频帧的大小。 | 50| [GetFrameCount](#getframecount) ([out] unsigned long count) | 获取音频buffer中的音频帧数。 | 51| [SetSampleAttributes](#setsampleattributes) ([in] struct [AudioSampleAttributes](_audio_sample_attributes.md) attrs) | 设置音频采样的属性参数。 | 52| [GetSampleAttributes](#getsampleattributes) ([out] struct [AudioSampleAttributes](_audio_sample_attributes.md) attrs) | 获取音频采样的属性参数。 | 53| [GetCurrentChannelId](#getcurrentchannelid) ([out] unsigned int channelId) | 获取音频的数据通道ID。 | 54| [SetExtraParams](#setextraparams) ([in] String keyValueList) | 设置音频拓展参数。 | 55| [GetExtraParams](#getextraparams) ([out] String keyValueList) | 获取音频拓展参数。 | 56| [ReqMmapBuffer](#reqmmapbuffer) ([in] int reqSize, [in] struct [AudioMmapBufferDescripter](_audio_mmap_buffer_descripter.md) desc) | 请求mmap缓冲区。 | 57| [GetMmapPosition](#getmmapposition) ([out] unsigned long frames, [out] struct [AudioTimeStamp](_audio_time_stamp.md) time) | 获取当前mmap的读/写位置。 | 58| [AddAudioEffect](#addaudioeffect) ([in] unsigned long effectid) | 添加音频效果。 | 59| [RemoveAudioEffect](#removeaudioeffect) ([in] unsigned long effectid) | 移除音频效果。 | 60| [GetFrameBufferSize](#getframebuffersize) ([out] unsigned long bufferSize) | 获取缓冲区大小。 | 61| [Start](#start) () | 启动一个音频播放或录音处理。 | 62| [Stop](#stop) () | 停止一个音频播放或录音处理。 | 63| [Pause](#pause) () | 暂停一个音频播放或录音处理。 | 64| [Resume](#resume) () | 恢复一个音频播放或录音处理。 | 65| [Flush](#flush) () | 刷新音频缓冲区buffer中的数据。 | 66| [TurnStandbyMode](#turnstandbymode) () | 设置或去设置设备的待机模式。 | 67| [AudioDevDump](#audiodevdump) ([in] int range, [in] int fd) | Dump音频设备信息。 | 68| [IsSupportsPauseAndResume](#issupportspauseandresume) ([out] boolean supportPause, [out] boolean supportResume) | 判断声卡是否支持音频播放的暂停和恢复功能 | 69 70 71## 成员函数说明 72 73 74### AddAudioEffect() 75 76 77``` 78IAudioRender::AddAudioEffect ([in] unsigned long effectid) 79``` 80 81**描述:** 82 83添加音频效果。 84 85**参数:** 86 87 | 名称 | 描述 | 88| -------- | -------- | 89| effectid | 添加的音频效果实例标识符。 | 90 91**返回:** 92 93成功返回值0，失败返回负值。 94 95 96### AudioDevDump() 97 98 99``` 100IAudioRender::AudioDevDump ([in] int range, [in] int fd ) 101``` 102 103**描述:** 104 105Dump音频设备信息。 106 107**参数:** 108 109 | 名称 | 描述 | 110| -------- | -------- | 111| range | Dump信息范围，分为简要信息、全量信息。 | 112| fd | 指定Dump目标文件。 | 113 114**返回:** 115 116成功返回值0，失败返回负值。 117 118 119### CheckSceneCapability() 120 121 122``` 123IAudioRender::CheckSceneCapability ([in] struct AudioSceneDescriptor scene, [out] boolean supported ) 124``` 125 126**描述:** 127 128是否支持某个音频场景的配置。 129 130**参数:** 131 132 | 名称 | 描述 | 133| -------- | -------- | 134| scene | 待判断的音频场景描述符，详请参考[AudioSceneDescriptor](_audio_scene_descriptor.md)。 | 135| supported | 是否支持的状态保存到supported中，true表示支持，false表示不支持。 | 136 137**返回:** 138 139成功返回值0，失败返回负值。 140 141**参见:** 142 143[SelectScene](#selectscene) 144 145 146### DrainBuffer() 147 148 149``` 150IAudioRender::DrainBuffer ([out] enum AudioDrainNotifyType type) 151``` 152 153**描述:** 154 155排空缓冲区中的数据。 156 157**参数:** 158 159 | 名称 | 描述 | 160| -------- | -------- | 161| type | 播放结束的类型，详请参考[AudioDrainNotifyType](_audio.md#audiodrainnotifytype)。 | 162 163**返回:** 164 165成功返回值0，失败返回负值。 166 167**参见:** 168 169[RegCallback](#regcallback) 170 171 172### Flush() 173 174 175``` 176IAudioRender::Flush () 177``` 178 179**描述:** 180 181刷新音频缓冲区buffer中的数据。 182 183**返回:** 184 185成功返回值0，失败返回负值。 186 187 188### GetChannelMode() 189 190 191``` 192IAudioRender::GetChannelMode ([out] enum AudioChannelMode mode) 193``` 194 195**描述:** 196 197获取音频播放当前的通道模式。 198 199**参数:** 200 201 | 名称 | 描述 | 202| -------- | -------- | 203| mode | 获取的通道模式保存到mode中，详请参考[AudioChannelMode](_audio.md#audiochannelmode)。 | 204 205**返回:** 206 207成功返回值0，失败返回负值。 208 209**参见:** 210 211[SetChannelMode](#setchannelmode) 212 213 214### GetCurrentChannelId() 215 216 217``` 218IAudioRender::GetCurrentChannelId ([out] unsigned int channelId) 219``` 220 221**描述:** 222 223获取音频的数据通道ID。 224 225**参数:** 226 227 | 名称 | 描述 | 228| -------- | -------- | 229| channelId | 获取的通道ID保存到channelId中。 | 230 231**返回:** 232 233成功返回值0，失败返回负值。 234 235 236### GetExtraParams() 237 238 239``` 240IAudioRender::GetExtraParams ([out] String keyValueList) 241``` 242 243**描述:** 244 245获取音频拓展参数。 246 247**参数:** 248 249 | 名称 | 描述 | 250| -------- | -------- | 251| keyValueList | 拓展参数键值对字符串列表，格式为key=value，多个键值对通过分号分割。 | 252 253**返回:** 254 255成功返回值0，失败返回负值。 256 257 258### GetFrameBufferSize() 259 260 261``` 262IAudioRender::GetFrameBufferSize ([out] unsigned long bufferSize) 263``` 264 265**描述:** 266 267获取缓冲区大小。 268 269**参数:** 270 271 | 名称 | 描述 | 272| -------- | -------- | 273| bufferSize | 获取的缓冲区大小保存在bufferSize中，单位为字节。 | 274 275**返回:** 276 277成功返回值0，失败返回负值。 278 279 280### GetFrameCount() 281 282 283``` 284IAudioRender::GetFrameCount ([out] unsigned long count) 285``` 286 287**描述:** 288 289获取音频buffer中的音频帧数。 290 291**参数:** 292 293 | 名称 | 描述 | 294| -------- | -------- | 295| count | 一个音频buffer中包含的音频帧数，获取后保存到count中。 | 296 297**返回:** 298 299成功返回值0，失败返回负值。 300 301 302### GetFrameSize() 303 304 305``` 306IAudioRender::GetFrameSize ([out] unsigned long size) 307``` 308 309**描述:** 310 311获取音频帧的大小。 312 313获取一帧音频数据的长度（字节数）。 314 315**参数:** 316 317 | 名称 | 描述 | 318| -------- | -------- | 319| size | 获取的音频帧大小（字节数）保存到size中。 | 320 321**返回:** 322 323成功返回值0，失败返回负值。 324 325 326### GetGain() 327 328 329``` 330IAudioRender::GetGain ([out] float gain) 331``` 332 333**描述:** 334 335获取音频流的增益。 336 337**参数:** 338 339 | 名称 | 描述 | 340| -------- | -------- | 341| gain | 保存当前获取到的增益到gain中。 | 342 343**返回:** 344 345成功返回值0，失败返回负值。 346 347**参见:** 348 349[GetGainThreshold](#getgainthreshold) 350 351[SetGain](#setgain) 352 353 354### GetGainThreshold() 355 356 357``` 358IAudioRender::GetGainThreshold ([out] float min, [out] float max ) 359``` 360 361**描述:** 362 363获取音频流增益的阈值。 364 365在具体的功能实现中，可以根据芯片平台的实际情况来进行处理： 366 367- 1. 可以使用实际的增益值，例如增益的范围为-50db ~ 6db。 368 369- 2. 也可以将增益范围设定为0.0~1.0，如果增益的范围为-50db ~ 6db， 则增益的映射关系为0.0表示静音，1.0表示最大增益（6db）。 370 371**参数:** 372 373 | 名称 | 描述 | 374| -------- | -------- | 375| min | 获取的音频增益的阈值下限保存到min中。 | 376| max | 获取的音频增益的阈值上限保存到max中。 | 377 378**返回:** 379 380成功返回值0，失败返回负值。 381 382**参见:** 383 384[GetGain](#getgain) 385 386[SetGain](#setgain) 387 388 389### GetLatency() 390 391 392``` 393IAudioRender::GetLatency ([out] unsigned int ms) 394``` 395 396**描述:** 397 398获取音频硬件驱动的延迟时间。 399 400**参数:** 401 402 | 名称 | 描述 | 403| -------- | -------- | 404| ms | 获取的延迟时间（单位：毫秒）保存到ms中。 | 405 406**返回:** 407 408成功返回值0，失败返回负值。 409 410 411### GetMmapPosition() 412 413 414``` 415IAudioRender::GetMmapPosition ([out] unsigned long frames, [out] struct AudioTimeStamp time ) 416``` 417 418**描述:** 419 420获取当前mmap的读/写位置。 421 422**参数:** 423 424 | 名称 | 描述 | 425| -------- | -------- | 426| frames | 获取的音频帧计数保存到frames中。 | 427| time | 获取的关联时间戳保存到time中，详请参考[AudioTimeStamp](_audio_time_stamp.md)。 | 428 429**返回:** 430 431成功返回值0，失败返回负值。 432 433 434### GetMute() 435 436 437``` 438IAudioRender::GetMute ([out] boolean mute) 439``` 440 441**描述:** 442 443获取音频的静音状态。 444 445**参数:** 446 447 | 名称 | 描述 | 448| -------- | -------- | 449| mute | 获取的静音状态保存到mute中，true表示静音操作、false表示取消静音操作。 | 450 451**返回:** 452 453成功返回值0，失败返回负值。 454 455**参见:** 456 457[SetMute](#setmute) 458 459 460### GetRenderPosition() 461 462 463``` 464IAudioRender::GetRenderPosition ([out] unsigned long frames, [out] struct AudioTimeStamp time ) 465``` 466 467**描述:** 468 469获取音频已输出的帧数。 470 471**参数:** 472 473 | 名称 | 描述 | 474| -------- | -------- | 475| frames | 获取的音频帧数保存到frames中，详请参考[AudioTimeStamp](_audio_time_stamp.md)。 | 476| time | 获取的关联时间戳保存到time中。 | 477 478**返回:** 479 480成功返回值0，失败返回负值。 481 482**参见:** 483 484[RenderFrame](#renderframe) 485 486 487### GetRenderSpeed() 488 489 490``` 491IAudioRender::GetRenderSpeed ([out] float speed) 492``` 493 494**描述:** 495 496获取一个音频当前的播放速度。 497 498**参数:** 499 500 | 名称 | 描述 | 501| -------- | -------- | 502| speed | 获取的播放速度保存到speed中。 | 503 504**返回:** 505 506成功返回值0，失败返回负值。 507 508**参见:** 509 510[SetRenderSpeed](#setrenderspeed) 511 512 513### GetSampleAttributes() 514 515 516``` 517IAudioRender::GetSampleAttributes ([out] struct AudioSampleAttributes attrs) 518``` 519 520**描述:** 521 522获取音频采样的属性参数。 523 524**参数:** 525 526 | 名称 | 描述 | 527| -------- | -------- | 528| attrs | 获取的音频采样属性（例如采样频率、采样精度、通道） 保存到attrs中，详请参考[AudioSampleAttributes](_audio_sample_attributes.md)。 | 529 530**返回:** 531 532成功返回值0，失败返回负值。 533 534**参见:** 535 536[SetSampleAttributes](#setsampleattributes) 537 538 539### GetVolume() 540 541 542``` 543IAudioRender::GetVolume ([out] float volume) 544``` 545 546**描述:** 547 548获取一个音频流的音量。 549 550**参数:** 551 552 | 名称 | 描述 | 553| -------- | -------- | 554| volume | 获取的音量保存到volume中，范围0.0~1.0。 | 555 556**返回:** 557 558成功返回值0，失败返回负值。 559 560**参见:** 561 562[SetVolume](#setvolume) 563 564 565### IsSupportsDrain() 566 567 568``` 569IAudioRender::IsSupportsDrain ([out] boolean support) 570``` 571 572**描述:** 573 574判断是否支持清空缓冲区数据的功能。 575 576**参数:** 577 578 | 名称 | 描述 | 579| -------- | -------- | 580| support | 是否支持的状态保存到support中，true表示支持，false表示不支持。 | 581 582**返回:** 583 584成功返回值0，失败返回负值。 585 586 587### IsSupportsPauseAndResume() 588 589 590``` 591IAudioRender::IsSupportsPauseAndResume ([out] boolean supportPause, [out] boolean supportResume ) 592``` 593 594**描述:** 595 596判断声卡是否支持音频播放的暂停和恢复功能 597 598**参数:** 599 600 | 名称 | 描述 | 601| -------- | -------- | 602| supportPause | 是否支持暂停功能的状态保存到supportPause中，true表示支持，false表示不支持。 | 603| supportResume | 是否支持恢复功能的状态保存到supportResume中，true表示支持，false表示不支持。 | 604 605**返回:** 606 607成功返回值0，失败返回负值。 608 609 610### Pause() 611 612 613``` 614IAudioRender::Pause () 615``` 616 617**描述:** 618 619暂停一个音频播放或录音处理。 620 621**返回:** 622 623成功返回值0，失败返回负值。 624 625**参见:** 626 627[Resume](#resume) 628 629 630### RegCallback() 631 632 633``` 634IAudioRender::RegCallback ([in] IAudioCallback audioCallback, [in] byte cookie ) 635``` 636 637**描述:** 638 639注册音频回调函数，用于放音过程中缓冲区数据写、DrainBuffer完成通知。 640 641**参数:** 642 643 | 名称 | 描述 | 644| -------- | -------- | 645| audioCallback | 注册的回调函数，详请参考[IAudioCallback](interface_i_audio_callback.md)。 | 646| cookie | 回调函数的入参。 | 647 648**返回:** 649 650成功返回值0，失败返回负值。 651 652**参见:** 653 654[RegCallback](#regcallback) 655 656 657### RemoveAudioEffect() 658 659 660``` 661IAudioRender::RemoveAudioEffect ([in] unsigned long effectid) 662``` 663 664**描述:** 665 666移除音频效果。 667 668**参数:** 669 670 | 名称 | 描述 | 671| -------- | -------- | 672| effectid | 移除的音频效果实例标识符。 | 673 674**返回:** 675 676成功返回值0，失败返回负值。 677 678 679### RenderFrame() 680 681 682``` 683IAudioRender::RenderFrame ([in] byte[] frame, [out] unsigned long replyBytes ) 684``` 685 686**描述:** 687 688向音频驱动中播放一帧输出数据（放音，音频下行数据）。 689 690**参数:** 691 692 | 名称 | 描述 | 693| -------- | -------- | 694| frame | 待写入的输出数据的音频frame。 | 695| replyBytes | 实际写入的音频数据长度（字节数），获取后保存到replyBytes中。 | 696 697**返回:** 698 699成功返回值0，失败返回负值。 700 701 702### ReqMmapBuffer() 703 704 705``` 706IAudioRender::ReqMmapBuffer ([in] int reqSize, [in] struct AudioMmapBufferDescripter desc ) 707``` 708 709**描述:** 710 711请求mmap缓冲区。 712 713**参数:** 714 715 | 名称 | 描述 | 716| -------- | -------- | 717| reqSize | 请求缓冲区的大小。 | 718| desc | 缓冲区描述符，详请参考[AudioMmapBufferDescripter](_audio_mmap_buffer_descripter.md)。 | 719 720**返回:** 721 722成功返回值0，失败返回负值。 723 724 725### Resume() 726 727 728``` 729IAudioRender::Resume () 730``` 731 732**描述:** 733 734恢复一个音频播放或录音处理。 735 736**返回:** 737 738成功返回值0，失败返回负值。 739 740**参见:** 741 742[Pause](#pause) 743 744 745### SelectScene() 746 747 748``` 749IAudioRender::SelectScene ([in] struct AudioSceneDescriptor scene) 750``` 751 752**描述:** 753 754选择音频场景。 755 756- 选择一个非常具体的音频场景（应用场景和输出设备的组合），例如同样是使用手机中的喇叭作为输出设备。 757 - 在媒体播放场景scene为media_speaker。 758 - 在语音通话免提场景scene为voice_speaker。 759 760- 只是选择一个音频场景，例如使用场景为媒体播放（media）、电影播放（movie）、游戏播放（game）。 761 762- 只是选择一个音频输出设备，例如输出设备为听筒（receiver）、喇叭（speaker）、有线耳机（headset）。 763 764**参数:** 765 766 | 名称 | 描述 | 767| -------- | -------- | 768| scene | 待设置的音频场景描述符，详请参考[AudioSceneDescriptor](_audio_scene_descriptor.md)。 | 769 770**返回:** 771 772成功返回值0，失败返回负值。 773 774**参见:** 775 776[CheckSceneCapability](#checkscenecapability) 777 778 779### SetChannelMode() 780 781 782``` 783IAudioRender::SetChannelMode ([in] enum AudioChannelMode mode) 784``` 785 786**描述:** 787 788设置音频播放的通道模式。 789 790**参数:** 791 792 | 名称 | 描述 | 793| -------- | -------- | 794| mode | 待设置的通道模式，详请参考[AudioChannelMode](_audio.md#audiochannelmode)。 | 795 796**返回:** 797 798成功返回值0，失败返回负值。 799 800**参见:** 801 802[GetChannelMode](#getchannelmode) 803 804 805### SetExtraParams() 806 807 808``` 809IAudioRender::SetExtraParams ([in] String keyValueList) 810``` 811 812**描述:** 813 814设置音频拓展参数。 815 816**参数:** 817 818 | 名称 | 描述 | 819| -------- | -------- | 820| keyValueList | 拓展参数键值对字符串列表，格式为key=value，多个键值对通过分号分割。 | 821 822**返回:** 823 824成功返回值0，失败返回负值。 825 826 827### SetGain() 828 829 830``` 831IAudioRender::SetGain ([in] float gain) 832``` 833 834**描述:** 835 836设置音频流的增益。 837 838**参数:** 839 840 | 名称 | 描述 | 841| -------- | -------- | 842| gain | 待设置的增益，最小为0.0，最大为1.0。 | 843 844**返回:** 845 846成功返回值0，失败返回负值。 847 848**参见:** 849 850[GetGainThreshold](#getgainthreshold) 851 852[GetGain](#getgain) 853 854 855### SetMute() 856 857 858``` 859IAudioRender::SetMute ([in] boolean mute) 860``` 861 862**描述:** 863 864设置音频的静音状态。 865 866**参数:** 867 868 | 名称 | 描述 | 869| -------- | -------- | 870| mute | 待设置的静音状态，true表示静音操作、false表示取消静音操作。 | 871 872**返回:** 873 874成功返回值0，失败返回负值。 875 876**参见:** 877 878[GetMute](#getmute) 879 880 881### SetRenderSpeed() 882 883 884``` 885IAudioRender::SetRenderSpeed ([in] float speed) 886``` 887 888**描述:** 889 890设置一个音频的播放速度。 891 892**参数:** 893 894 | 名称 | 描述 | 895| -------- | -------- | 896| speed | 待设置的播放速度（倍速），例0.5、0.75、1.0、1.25、1.5、2.0。 | 897 898**返回:** 899 900成功返回值0，失败返回负值。 901 902**参见:** 903 904[GetRenderSpeed](#getrenderspeed) 905 906 907### SetSampleAttributes() 908 909 910``` 911IAudioRender::SetSampleAttributes ([in] struct AudioSampleAttributes attrs) 912``` 913 914**描述:** 915 916设置音频采样的属性参数。 917 918**参数:** 919 920 | 名称 | 描述 | 921| -------- | -------- | 922| attrs | 待设置的音频采样属性，例如采样频率、采样精度、通道，详请参考[AudioSampleAttributes](_audio_sample_attributes.md)。 | 923 924**返回:** 925 926成功返回值0，失败返回负值。 927 928**参见:** 929 930[GetSampleAttributes](#getsampleattributes) 931 932 933### SetVolume() 934 935 936``` 937IAudioRender::SetVolume ([in] float volume) 938``` 939 940**描述:** 941 942设置一个音频流的音量。 943 944音量的取值范围是0.0~1.0，如果音频服务中的音量等级为15级（0 ~ 15）， 则音量的映射关系为0.0表示静音，1.0表示最大音量等级（15）。 945 946**参数:** 947 948 | 名称 | 描述 | 949| -------- | -------- | 950| volume | 待设置的音量，范围0.0~1.0。 | 951 952**返回:** 953 954成功返回值0，失败返回负值。 955 956 957### Start() 958 959 960``` 961IAudioRender::Start () 962``` 963 964**描述:** 965 966启动一个音频播放或录音处理。 967 968**返回:** 969 970成功返回值0，失败返回负值。 971 972**参见:** 973 974[Stop](#stop) 975 976 977### Stop() 978 979 980``` 981IAudioRender::Stop () 982``` 983 984**描述:** 985 986停止一个音频播放或录音处理。 987 988**返回:** 989 990成功返回值0，失败返回负值。 991 992**参见:** 993 994[Start](#start) 995 996 997### TurnStandbyMode() 998 999 1000``` 1001IAudioRender::TurnStandbyMode () 1002``` 1003 1004**描述:** 1005 1006设置或去设置设备的待机模式。 1007 1008**返回:** 1009 1010设置设备待机模式成功返回值0，失败返回负值；设置取消设备待机模式成功返回正值，失败返回负值。 1011