# start\_scenario

Source: [https://docs.qualcomm.com/doc/80-PK177-134/topic/oem_start_scenario.html](https://docs.qualcomm.com/doc/80-PK177-134/topic/oem_start_scenario.html)

Starts the OEM predefined scenario. OEM must implement this function in if any hint is provided for the thread, this is to reset any thread to the default. release\_hint will work for any thread.

start_scenario()Copy to clipboard

## Parameters

| **Parameter** | **API type** | **Data type** | **Description** |
| --- | --- | --- | --- |
| scenario\_id | Java | String | Scenario (predefined by OEM) to check. OEM should<br>                            implement each scenario. |
| scenario\_id | Native | const char\* | Scenario (predefined by OEM) to check. OEM should<br>                            implement each scenario. |
| ret | Native | int8\_t& | On success this is the actual return value from the API.<br><br><br>                            <br><ul class="ul"><br>                                    <li class="li">0: Success</li><br><br>                                    <li class="li">-1: Not supported OEM extension</li><br><br>                                    <li class="li">-2: Failed to establish session; check that set_pkg was<br>                                        called before this API</li><br><br>                                    <li class="li">-3: Scenario for app already present. No action taken</li><br><br>                                    <li class="li">-4: plock is null or wrongly set. No action taken</li><br><br>                                </ul> |
|  |  |  |  |

##  Returns

| **Return** | **API type** | **Data Type** | **Description** |
| --- | --- | --- | --- |
| response | Java | int | <ul class="ul"><br>                                    <li class="li">0: Success</li><br><br>                                    <li class="li">-1: Not supported OEM extension</li><br><br>                                    <li class="li">-2: Failed to establish session; check that set_pkg was<br>                                    called before this API</li><br><br>                                    <li class="li">-3: Scenario for app already present. No action taken</li><br><br>                                    <li class="li">-4: plock is null or wrongly set. No action taken</li><br><br>                            </ul> |
| response | Native | qesdk\_transaction\_status | See [QESDK transaction status for Native APIs](https://docs.qualcomm.com/doc/80-PK177-134/topic/native_qesdk_class.html) for usage details. Use qesdk\_transaction\_status to confirm API call invocation. If successful, use the `ret` value for the actual API return value object. |
|  |  |  |  |

**Parent Topic:** [OEM extension plugin](https://docs.qualcomm.com/doc/80-PK177-134/topic/oem_extension_plugin.html)

Last Published: Nov 14, 2024

[Previous Topic
get\_scenario\_support](https://docs.qualcomm.com/bundle/publicresource/80-PK177-134/topics/oem_get_scenario_support.md) [Next Topic
stop\_scenario](https://docs.qualcomm.com/bundle/publicresource/80-PK177-134/topics/oem_stop_scenario.md)